Essayez ! Créer un contrôle FlowDocumentReader

Dans le panneau Propriétés, certaines propriétés sont plus complexes qu’une valeur simple. Par exemple, certaines propriétés représentent une collection de valeurs ou un objet avec des propriétés qui lui sont propres. Vous pouvez utiliser l’éditeur de collections et l’éditeur de propriétés secondaires pour modifier ces valeurs.

La procédure suivante utilise les éditeurs de propriétés secondaires et de collections pour vous montrer comment ajouter du contenu à un contrôle FlowDocumentReader.

Remarque :
Il est inutile d’utiliser cette procédure pour modifier du texte dans un contrôle FlowDocumentScrollViewer. Au lieu de cela, vous pouvez utiliser les procédures dans Modifier un texte, Mettre en forme du texte et les autres rubriques qui sont répertoriées dans la section « Procédure » dans Texte et typographie.

Pour ajouter du contenu à un contrôle FlowDocumentReader

1. Le contrôle FlowDocumentReader est disponible dans la Bibliothèque de composants. Dans la boîte à outils, cliquez sur le bouton Bibliothèque de composants .

2. Activez la case à cocher Afficher tout pour voir tous les contrôles disponibles.

3. Dans l’onglet Contrôles, sélectionnez Contrôles système (valeur par défaut), puis sélectionnez le contrôle FlowDocumentReader. Une icône générique apparaît au-dessus du bouton Bibliothèque de composants dans la boîte à outils, sélectionnée et prête à être ajoutée à la planche graphique.

4. Dessinez un contrôle FlowDocumentReader sur la planche graphique.

   Contrôle FlowDocumentReader dessiné sur la planche graphique

   

5. L’objet FlowDocumentReader étant sélectionné sous Objets et chronologie, développez la catégorie Divers dans le panneau Propriétés.

6. Cliquez sur le bouton Nouveau en regard de la propriété Document. La propriété Document est remplie avec un objet FlowDocument, et l’éditeur de propriétés secondaires pour le contrôle FlowDocument s’ouvre. Vous pouvez développer et réduire l’éditeur de propriétés secondaires. La propriété Document ne peut obtenir qu’un seul contrôle FlowDocument.

   Remarque :

   Les propriétés qui s’afficheront dans un éditeur de propriétés secondaires sont généralement identifiées par un bouton Nouveau à côté d’elles, et une flèche de développement  (si la propriété possède du contenu). Si la propriété possède des propriétés secondaires par défaut qui lui sont associées, une flèche de déroulement apparaît également à côté de la propriété. Par exemple, la propriété BitmapEffect (effet bitmap) fournit une liste déroulante qui inclut les propriétés BevelBitmapEffect (effet bitmap biseau), BlurBitmapEffect (effet bitmap flou) et d’autres propriétés secondaires que vous pouvez sélectionner.

   Éditeur de propriétés secondaires de la propriété Document montrant la propriété Blocks collection

   

7. Dans l’éditeur de propriétés secondaires de la propriété Document, cliquez sur le bouton Modifier les éléments de cette collection en regard de la propriété Blocks (Collection). L’éditeur de collections s’ouvre pour la propriété Blocks (Blocs).

   Remarque :
   Les propriétés qui affichent un éditeur de collections sont généralement identifiées par le mot (Collection) en regard du nom de la propriété, et par un bouton Modifier les éléments de cette collection.

   Éditeur de collections de la propriété secondaire Blocks

   

8. Dans l’éditeur de collections de la propriété secondaire Blocks, cliquez sur le bouton Ajouter un autre élément. La fenêtre Sélectionner un objet apparaît, dans laquelle vous pouvez sélectionner tout objet Windows Presentation Foundation (WPF).

9. Dans la zone de texte Rechercher, tapez Paragraph pour rapidement localiser la classe Paragraph. Sélectionnez Paragraph dans la liste sous System.Windows.Documents, puis cliquez sur OK. La fenêtre Sélectionner un objet se ferme, et un élément Paragraph est ajouté à l’éditeur de collections à l’indice 0. Les propriétés de l’objet Paragraph sont affichées sur la droite.

   Remarque :

   Il n’est pas toujours aisé de savoir quels objets sont valides pour une collection donnée. Pour les propriétés de collection de contrôles courants (telles que la propriété Items du contrôle ListBox), l’éditeur de collections fournit une liste déroulante des éléments suggérés ainsi que le bouton Ajouter un autre élément. Toutefois, pour les contrôles moins fréquents (tels que le contrôle FlowDocumentReader), cela peut vous aider à comprendre quels sont les éléments valides pour la collection d’afficher la documentation MSDN pour le type de contrôle. Par exemple, dans la section Flow, classes associées de la Vue d’ensemble du contrôle FlowDocument sur MSDN, un diagramme affiche la structure des contrôles de documents de flux. Dans ce diagramme, vous pouvez constater que la propriété Blocks peut contenir un élément Paragraph, Section, List, Table et/ou BlockUIContainer. Dans les étapes suivantes, vous ajouterez un élément Run à la propriété de collection Inlines de l’objet Paragraph.

10. Dans la fenêtre Propriétés de l’objet Paragraph, cliquez sur le bouton Modifier les éléments de cette collection en regard de la propriété Inlines. L’éditeur de collections passe à l’étendue de la propriété Inlines.

11. Cliquez sur le bouton Ajouter un autre élément, puis sélectionnez la classe Run dans la fenêtre Sélectionner un objet. Un objet Run a été ajouté à l’éditeur de collections à l’indice 0.

12. Dans la fenêtre Propriétés de l’objet Run, ajoutez du contenu en tapant dans la propriété Text. Vous pouvez également utiliser des propriétés des catégories Pinceaux et Texte pour styliser le texte. D’autres propriétés sont désactivées car elles doivent être définies au niveau du contrôle FlowDocumentViewer.

    Éditeur de collections de la propriété Inlines après l’ajout d’un objet Run et l’édition du texte

    

13. Cliquez sur OK pour quitter l’éditeur de collections de la propriété Inlines, puis cliquez sur OK pour quitter l’éditeur de collections de la propriété Blocks. Le texte que vous avez entré à l’étape précédente s’affiche dans le contrôle FlowDocumentViewer.

    Important :
    Ne cliquez pas sur le bouton Nouveau en regard de la propriété Document de l’objet FlowDocumentViewer sauf si vous souhaitez supprimer le contenu que vous venez de créer, car la propriété Document peut uniquement contenir un objet FlowDocument. Sauf si un nom de propriété inclut le mot (Collection), la propriété ne peut contenir qu’un seul objet.

Remarque :

Si vous éditez un objet FlowDocumentScrollViewer ou un objet RichTextBox, vous pouvez utiliser l’éditeur de texte de Microsoft Expression Blend, accessible en sélectionnant l’objet et en appuyant sur F2. Pour plus d’informations, voir Modifier un texte. Si vous modifiez un objet DocumentViewer ou FlowDocumentPageViewer, du contenu est ajouté par programme. Pour plus d’informations, voir Vue d’ensemble des documents de flux et Documents dans Windows Presentation Foundation sur MSDN. Consultez également les Exemples DocumentViewer et les Exemples FlowDocumentReader que vous pouvez télécharger à partir du centre de téléchargement sous Exemples du Kit de développement (SDK) .NET Framework 3.0.