Travailler avec le contrôle de contenu SDT
En Microsoft Word, Vous pouvez créer un formulaire en commençant par un modèle et en ajoutant des contrôles de contenu, y compris les cases à cocher, les cases de texte, les sélectionneurs de dates et les listes déroulantes. En <span notrans="<span notrans=" Aspose.Words"="">""> une étiquette de document structuré ou un contrôle de contenu de tout document chargé dans Aspose.Words est importé en tant que noeud structuredDocumentTag. Les balises de document structurées (SDT ou contrôle de contenu) permettent d’intégrer la sémantique définie par le client ainsi que son comportement et son apparence dans un document.
Document structuré L’étiquette peut se trouver dans un document aux endroits suivants:
- Niveau de bloc - Parmi les paragraphes et les tableaux, comme un enfant d’un corps, HeaderFooter, Commentaire, Note de bas de page ou un noeud de forme.
- Niveau de rangée - Parmi les rangées dans une table, comme un enfant d’un noeud de table.
- Niveau cellulaire - Parmi les cellules dans une rangée de tableau, comme un enfant d’un noeud de ligne.
- Niveau en ligne - Parmi le contenu en ligne à l’intérieur, comme un enfant d’un paragraphe.
- Niché dans une autre structure.
Insérer des contrôles de contenu dans un document
Dans cette version de Aspose.Words, les types suivants de DTS ou de contrôle de contenu peuvent être créés:
- Checkbox
- DropDownList
- ComboBox
- Date
- BuildingBlockGallery
- Group
Picture- RichText
- PlainText
L’exemple de code suivant montre comment créer le contrôle de contenu de la case à cocher de type:
L’exemple de code suivant montre comment créer le contrôle de contenu de la zone de texte riche de type:
L’exemple de code suivant montre comment créer le contrôle de contenu de la boîte combo type:
Comment mettre à jour les contrôles de contenu
Cette section explique comment mettre à jour les valeurs du TSD ou du contrôle de contenu programmatiquement.
L’exemple de code suivant montre comment définir l’état actuel de la case à cocher:
L’exemple de code suivant montre comment modifier les contrôles de contenu de type zone de texte simple, liste déroulante et image:
Reliure le contrôle du contenu aux pièces XML personnalisées
Vous pouvez lier les contrôles de contenu avec des données XML (partie XML personnalisée) dans des documents Word
L’exemple de code suivant montre comment lier le contrôle de contenu à des parties XML personnalisées:
Contenu clair d’un contrôle de contenu
Vous pouvez effacer le contenu d’un contrôle de contenu en affichant un détenteur de place. Document structuréTag.clear() méthode efface le contenu de cette balise de document structuré et affiche un placeholder s’il est défini. Toutefois, Il n’est pas possible d’effacer le contenu d’un contrôle de contenu s’il a des révisions. Si un contrôle de contenu n’a pas de placeholder, cinq espaces sont insérés comme dans MS Word (sauf les sections répétitives, les éléments de section répétitifs, les groupes, les cases à cocher, les citations). Si un contrôle de contenu est cartographié en XML personnalisé, le nœud XML référencé est effacé.
L’exemple de code suivant montre comment effacer le contenu du contrôle de contenu:
Changer les couleurs de fond et de bordure du contrôle du contenu
Les StructuredDocumentTag.Color propriété vous permet d’obtenir ou de définir la couleur du contrôle de contenu. La couleur affecte le contrôle du contenu dans deux situations:
- MS Word souligne l’arrière-plan du contrôle de contenu lorsque la souris passe au-dessus du contrôle de contenu. Cela aide à identifier le contrôle de contenu. La couleur de mise en évidence est un peu plus “douce” que le Color. Par exemple, MS Word met en évidence le fond avec la couleur rose, quand Color est rouge.
- Lorsque vous interagissez (édition, cueillette, etc.) avec le contrôle de contenu, la bordure du contrôle de contenu est colorée avec le Color.
L’exemple de code suivant montre comment changer la couleur du contrôle de contenu:
Comment définir le style pour formater le texte saisi dans le contrôle du contenu
Si vous voulez définir le style de contrôle de contenu, vous pouvez utiliser StructuredDocumentTag.Style ou StructuredDocumentTag.StyleName propriétés. Lorsque vous tapez le texte dans le contrôle de contenu dans le document de sortie, le texte dactylographié aura le style “Quote”.
L’exemple de code suivant montre comment définir le style de contrôle du contenu:
Travailler avec le contrôle du contenu de la section de répétition
Le contrôle de contenu de la section répétitive permet de répéter le contenu contenu. Utilisation Aspose.Words, les nœuds structurés de la balise de document de la section répétitive et les types d’éléments de section répétitive peuvent être créés et à cette fin, Type de désignation Type Sdt fournit un membre REPEATING_SECTION_ITEM.
L’exemple de code suivant montre comment lier un contrôle de contenu de section répétitive à une table: