Travailler avec des signets
Les signets identifient dans un document Microsoft Word les emplacements ou fragments que vous nommez et identifiez pour référence future. Par exemple, vous pouvez utiliser un signet pour identifier le texte que vous souhaitez réviser ultérieurement. Au lieu de faire défiler le document pour localiser le texte, vous pouvez y accéder en utilisant la boîte de dialogue Signet.
Les actions pouvant être effectuées avec les signets à l’aide de Aspose.Words sont les mêmes que celles que vous pouvez effectuer à l’aide de Microsoft Word. Vous pouvez insérer un nouveau signet, supprimer, déplacer vers un signet, obtenir ou définir un nom de signet, obtenir ou définir le texte qu’il contient. Avec Aspose.Words, vous pouvez également utiliser des signets dans des rapports ou des documents pour insérer certaines données dans le signet ou appliquer une mise en forme spéciale à son contenu. Vous pouvez également utiliser des signets pour récupérer du texte à partir d’un certain emplacement de votre document.
Insérer un signet
Utilisez start_bookmark et end_bookmark pour créer un signet en marquant respectivement son début et sa fin. N’oubliez pas de transmettre le même nom de signet aux deux méthodes. Les signets d’un document peuvent se chevaucher et s’étendre sur n’importe quelle plage. Les signets mal formés ou les signets avec des noms en double seront ignorés lors de l’enregistrement du document.
L’exemple de code suivant montre comment créer un nouveau signet:
Obtenir des signets
Parfois, il est nécessaire d’obtenir une collection de signets pour parcourir les signets ou à d’autres fins. Utilisez la propriété Node.range exposée par n’importe quel nœud de document qui renvoie un objet Range représentant la partie du document contenue dans ce nœud. Utilisez cet objet pour récupérer un BookmarkCollection, puis utilisez l’indexeur de collection pour obtenir un signet spécifique.
L’exemple de code suivant montre comment obtenir des signets à partir d’une collection de signets:
L’exemple de code suivant montre comment obtenir ou définir un nom et un texte de signet:
L’exemple de code suivant montre comment ajouter une table à vos favoris:
Si vous remplacez le nom d’un signet par un nom qui existe déjà dans le document, aucune erreur ne sera générée et seul le premier signet sera stocké lorsque vous enregistrerez le document.
Notez que certains signets du document sont affectés à des champs de formulaire. Passer à un tel signet et y insérer du texte insère le texte dans le code du champ du formulaire. Bien que cela n’invalide pas le champ du formulaire, le texte inséré ne sera pas visible car il fait partie du code du champ.
L’exemple de code suivant montre comment accéder aux colonnes de la table marquée de favoris:
Déplacer vers un signet
Si vous devez insérer du contenu riche (pas seulement du texte brut) dans un signet, vous devez utiliser move_to_bookmark pour déplacer le curseur vers le signet, puis utiliser les méthodes et propriétés DocumentBuilder’s pour insérer du contenu.
Afficher Masquer le contenu des favoris
L’intégralité du signet (y compris le contenu mis en signet) peut être encapsulée dans la partie Vrai du champ IF à l’aide de Aspose.Words. Il peut en être ainsi que le champ IF contienne un champ de fusion imbriqué dans l’expression (À gauche de l’opérateur) et en fonction de la valeur du champ de fusion, le champ IF affiche ou masque le contenu du signet dans le document Word.
L’exemple de code suivant montre comment afficher/masquer les favoris: