Contrôle du contenu de la zone de liste déroulante

Ce didacticiel explique comment créer un contrôle de contenu Combo Box dans un document Word à l’aide d’Aspose.Words pour .NET. Les contrôles de contenu de la zone de liste déroulante permettent aux utilisateurs de sélectionner un élément dans une liste déroulante.

Conditions préalables

Pour suivre ce tutoriel, vous devez disposer des éléments suivants :

• Bibliothèque Aspose.Words pour .NET installée.
• Connaissance de base de C# et du traitement de mots avec des documents Word.

Étape 1 : configurer le répertoire de documents

Commencez par configurer le chemin d’accès à votre répertoire de documents. Remplacer"YOUR DOCUMENT DIRECTORY"avec le chemin réel du répertoire dans lequel vous souhaitez enregistrer le document.

string dataDir = "YOUR DOCUMENT DIRECTORY";

Étape 2 : Créer un document et un StructuredDocumentTag

Créez une nouvelle instance duDocument classe et unStructuredDocumentTag pour représenter le contrôle de contenu de la zone de liste déroulante. SpécifierSdtType.ComboBox comme le type etMarkupLevel.Block comme niveau de balisage pour créer une zone de liste déroulante au niveau du bloc.

Document doc = new Document();
StructuredDocumentTag sdt = new StructuredDocumentTag(doc, SdtType.ComboBox, MarkupLevel.Block);

Étape 3 : ajouter des éléments à la liste déroulante

Ajoutez des éléments à la liste déroulante en utilisant leListItems propriété duStructuredDocumentTag . Chaque élément est représenté par unSdtListItem objet, qui prend un texte d’affichage et une valeur. Dans cet exemple, nous ajoutons trois éléments à la liste déroulante.

sdt.ListItems.Add(new SdtListItem("Choose an item", "-1"));
sdt.ListItems.Add(new SdtListItem("Item 1", "1"));
sdt.ListItems.Add(new SdtListItem("Item 2", "2"));

Étape 4 : ajouter le StructuredDocumentTag au document

Ajoutez le contrôle de contenu de la zone de liste déroulante au corps du document à l’aide de l’optionAppendChild méthode du corps de la première section du document.

doc.FirstSection.Body.AppendChild(sdt);

Étape 5 : Enregistrez le document

Enregistrez le document dans le répertoire spécifié à l’aide duSave méthode. Fournissez le nom de fichier souhaité avec l’extension de fichier appropriée. Dans cet exemple, nous enregistrons le document sous le nom « WorkingWithSdt.ComboBoxContentControl.docx ».

doc.Save(dataDir + "WorkingWithSdt.ComboBoxContentControl.docx");

Exemple de code source pour le contrôle de contenu de zone de liste déroulante utilisant Aspose.Words pour .NET

	// Chemin d'accès à votre répertoire de documents
	string dataDir = "YOUR DOCUMENT DIRECTORY";

	Document doc = new Document();
	StructuredDocumentTag sdt = new StructuredDocumentTag(doc, SdtType.ComboBox, MarkupLevel.Block);
	sdt.ListItems.Add(new SdtListItem("Choose an item", "-1"));
	sdt.ListItems.Add(new SdtListItem("Item 1", "1"));
	sdt.ListItems.Add(new SdtListItem("Item 2", "2"));
	doc.FirstSection.Body.AppendChild(sdt);
	doc.Save(dataDir + "WorkingWithSdt.ComboBoxContentControl.docx");

C’est ça! Vous avez créé avec succès un contrôle de contenu Combo Box dans votre document Word à l’aide d’Aspose.Words pour .NET.