FlowDocument.IsHyphenationEnabled Propriété

Référence

Définition

Espace de noms:: System.Windows.Documents

Assembly:: PresentationFramework.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Obtient ou définit une valeur qui indique si la coupure de mots automatique est activée ou non.

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

Valeur de propriété

Boolean

true si la coupure et la césure automatiques des mots sont activées ; sinon, false. La valeur par défaut est false.

Exemples

L’exemple suivant montre comment définir l’attribut IsHyphenationEnabled d’un FlowDocument élément.

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

La figure suivante montre comment le rendu précédent FlowDocument est effectué.

Capture d’écran : Le trait d’union FlowDocument est activé

L’illustration suivante montre comment le même FlowDocument rendu avec le paramètre par défaut de=IsHyphenationEnabledfalse .

Capture d’écran : FlowDocument avec des traits d’union désactivés

L’exemple suivant montre comment définir la IsHyphenationEnabled propriété par programmation.

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

Remarques

La fonctionnalité de coupure automatique de mots permet à un FlowDocument d’interrompre et de rompre automatiquement les mots, en fonction des conditions de disposition actuelles. Cela permet aux mots longs de commencer sur une ligne et de continuer sur la suivante, et tend à obtenir une distribution plus uniforme des espaces blancs dans le texte justifié. Les mots sont rompus et traits d’union conformément aux règles de grammaire standard. La coupure d’union automatique est particulièrement efficace lorsqu’elle est associée à une disposition de paragraphe optimale (représentée par la IsOptimalParagraphEnabled propriété ).

Informations sur les propriétés de dépendance


Champ Identificateur	IsHyphenationEnabledProperty
Propriétés de métadonnées définies sur `true`	AffectsMeasure, AffectsRender, Inherits

S’applique à

Partager via