FlowDocument.IsHyphenationEnabled Eigenschaft

Definition

Namespace:

System.Windows.Documents

Assembly:

PresentationFramework.dll

Ruft einen Wert ab, mit dem angegeben wird, ob die automatische Silbentrennung von Wörtern aktiviert oder deaktiviert ist, oder legt diesen Wert fest.

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

Eigenschaftswert

Boolean

true, wenn der automatische Umbruch und die automatische Silbentrennung von Wörtern aktiviert sind, andernfalls false. Der Standardwert ist false.

Beispiele

Das folgende Beispiel zeigt, wie das IsHyphenationEnabled Attribut eines FlowDocument Elements festgelegt wird.

<FlowDocumentReader>
  <FlowDocument
    TextAlignment="Justify" 
    IsHyphenationEnabled="True"
    IsOptimalParagraphEnabled="True"
    Background="LightGray"
    PageWidth="400" PageHeight="480"
  >
    <Paragraph>
      <Hyperlink NavigateUri="http://www.xbox.com/en-US/games/p/perfectdarkzero/default.htm">
        Perfect Dark Zero
      </Hyperlink>
    </Paragraph>
    <Paragraph>
      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>
      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>
      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>
</FlowDocumentReader>

Die folgende Abbildung zeigt, wie das vorherige FlowDocument Gerendert wird.

Die folgende Abbildung zeigt, wie dasselbe FlowDocument mit der Standardeinstellung gerendert wird=IsHyphenationEnabledfalse.

Das folgende Beispiel zeigt, wie Sie die IsHyphenationEnabled-Eigenschaft programmatisch einstellen können.

FlowDocument flowDoc = new FlowDocument(new Paragraph(new Run("A bit of text content...")));

// Enable automatic hyphenation.
flowDoc.IsHyphenationEnabled = true;
// Enable optimal paragraph layout.
flowDoc.IsOptimalParagraphEnabled = true;

Dim flowDoc As New FlowDocument(New Paragraph(New Run("A bit of text content...")))

' Enable automatic hyphenation.
flowDoc.IsHyphenationEnabled = True
' Enable optimal paragraph layout.
flowDoc.IsOptimalParagraphEnabled = True

Hinweise

Das Feature für die automatische Wörtertrennung ermöglicht es, FlowDocument Wörter basierend auf aktuellen Layoutbedingungen automatisch zu unterbrechen und zu silben. Dadurch können lange Wörter in einer Zeile beginnen und in der nächsten fortfahren, und es wird tendenziell eine gleichmäßigere Verteilung des Leerraums im gerechtfertigten Text erreicht. Wörter werden nach den standardmäßigen Grammatikregeln gebrochen und bindestrichen. Die automatische Silbentrennung ist besonders effektiv, wenn sie mit einem optimalen Absatzlayout (dargestellt durch die IsOptimalParagraphEnabled -Eigenschaft) gekoppelt ist.

Informationen zur Abhängigkeitseigenschaft

Bezeichnerfeld	IsHyphenationEnabledProperty
Metadateneigenschaften auf true festgelegt	AffectsMeasure, AffectsRender, Inherits