Block.IsHyphenationEnabled Свойство

Определение

Получает или задает значение, указывающее, включена или отключена функция автоматического переноса слов.Gets or sets a value that indicates whether automatic hyphenation of words is enabled or disabled.

public:
 property bool IsHyphenationEnabled { bool get(); void set(bool value); };
public bool IsHyphenationEnabled { get; set; }
member this.IsHyphenationEnabled : bool with get, set
Public Property IsHyphenationEnabled As Boolean

Значение свойства

true, если функция автоматического переноса слов включена; в противном случае — false.true if automatic breaking and hyphenation of words is enabled; otherwise, false. Значение по умолчанию — false.The default is false.

Примеры

В следующем примере показано, IsHyphenationEnabled как задать атрибут Block элемента.The following example shows how to set the IsHyphenationEnabled attribute of a Block element.

<FlowDocument
  TextAlignment="Justify" 
  IsOptimalParagraphEnabled="True"
  Background="LightGray"
  PageWidth="400" PageHeight="480"
>
  <Paragraph IsHyphenationEnabled="True">
    <Hyperlink NavigateUri="http://www.xbox.com/en-US/games/p/perfectdarkzero/default.htm">
      Perfect Dark Zero
    </Hyperlink>
  </Paragraph>
  <Paragraph IsHyphenationEnabled="True">
    Joanna Dark returns in the Xbox 360 exclusive <Bold>
      <Italic>Perfect Dark Zero</Italic>
    </Bold>, the
    prequel to the internationally award-winning and multi-million selling first-person shooter
    <Italic>Perfect Dark</Italic> from famed game developer Rare.
  </Paragraph>
  <Paragraph IsHyphenationEnabled="True">
    A secret war has begun between shadowy corporations bent on world domination. Joanna Dark and her father
    Jack are caught up in the fight for the future of the planet. A routine bounty hunting mission rips open
    a global conspiracy that will change Joanna's destiny—forever.
  </Paragraph>
  <Paragraph IsHyphenationEnabled="True">
    Guide Joanna Dark on her journey to become the perfect agent. Featuring a compelling and captivating story,
    <Italic>Perfect Dark Zero</Italic> plunges you into a world of corporate espionage and conspiracy. The title
    merges the excitement and intrigue of its predecessor with revolutionary game design, cutting-edge online play,
    and amazing graphics to deliver an experience that defines next-generation gaming and entertainment...
  </Paragraph>
</FlowDocument>

На следующем рисунке показано, как отображается предыдущий пример.The following figure shows how the preceding example renders.

![Снимок экрана Снимок экрана с]включенным(~/add/media/flowdoc-hyphenenabled.png "переносом FlowDocument: Перенос FlowDocument включен")Screenshot: FlowDocument hyphen enabled

На следующем рисунке показано, как отображается один и тот же пример с параметром IsHyphenationEnabled = falseпо умолчанию.The following figure shows how the same example renders with the default setting of IsHyphenationEnabled=false.

![Снимок экрана Снимок экрана с отключенными дефисами]:(~/add/media/flowdoc-hyphendisabled.png " FlowDocument с отключенными дефисами")Screenshot: FlowDocument with disabled hyphens

В следующем примере показано, как задать IsHyphenationEnabled свойство программным способом.The following example shows how to set the IsHyphenationEnabled property programmatically.

Paragraph par = new Paragraph();
par.IsEnabled = true;
Dim par As New Paragraph()
par.IsEnabled = True

Комментарии

Функция автоматического переноса слов позволяет Block элементу автоматически разбивать слова и расставлять их в зависимости от текущих условий макета.The automatic word hyphenation feature enables a Block element to automatically break and hyphenate words, based on current layout conditions. Это позволяет начать работу с длинными словами на одной строке и продолжить выполнение этой процедуры, что позволяет добиться более равномерного распределения пробелов в выровненном тексте.This enables long words to begin on one line and continue on this next, and tends to achieve a more even distribution of white space in justified text. Слова разбиваются и переносятся в соответствии с стандартными правилами грамматики.Words are broken and hyphenated according to standard grammar rules.

Сведения о свойстве зависимостейDependency Property Information

Поле идентификатораIdentifier field IsHyphenationEnabledProperty
Свойства метаданных, для которых задано значениеtrueMetadata properties set to true AffectsMeasure, AffectsRender, InheritsAffectsMeasure, AffectsRender, Inherits

Применяется к