Block.IsHyphenationEnabled プロパティ

定義

名前空間:

System.Windows.Documents

アセンブリ:

PresentationFramework.dll

単語の自動ハイフネーションが有効かどうかを示す値を取得または設定します。

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

プロパティ値

Boolean

自動改行と単語の自動ハイフネーションが有効である場合は true。それ以外の場合は false。 既定値は、false です。

例

次の例は、 要素の 属性を IsHyphenationEnabled 設定する方法を Block 示しています。

<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>

次の図は、前の例がどのようにレンダリングされるかを示しています。

次の図は、同じ例が の既定の設定 IsHyphenationEnabled=falseでどのようにレンダリングされるかを示しています。

次の例では、IsHyphenationEnabled プロパティをプログラムで設定する方法が示されています。

Paragraph par = new Paragraph();
par.IsEnabled = true;

Dim par As New Paragraph()
par.IsEnabled = True

注釈

自動単語ハイフネーション機能を使用すると、要素は Block 現在のレイアウト条件に基づいて単語を自動的に区切り、ハイフネーションすることができます。 これにより、長い単語が 1 行目から始まり、次に続き、両端揃えテキスト内の空白がより均等に分散される傾向があります。 単語は、標準の文法規則に従って壊れ、ハイフンで区切られます。

依存プロパティ情報

識別子フィールド	IsHyphenationEnabledProperty
に設定されたメタデータ プロパティ true	AffectsMeasure, AffectsRender, Inherits