Controle de conteúdo da caixa de combinação

Este tutorial explica como criar um controle de conteúdo de caixa de combinação em um documento do Word usando Aspose.Words for .NET. Os controles de conteúdo da caixa de combinação permitem que os usuários selecionem um item em uma lista suspensa.

Pré-requisitos

Para seguir este tutorial, você precisa ter o seguinte:

• Biblioteca Aspose.Words para .NET instalada.
• Conhecimento básico de C# e processamento de palavras com documentos Word.

Etapa 1: configurar o diretório de documentos

Comece configurando o caminho para o diretório do seu documento. Substituir"YOUR DOCUMENT DIRECTORY" com o caminho real para o diretório onde você deseja salvar o documento.

string dataDir = "YOUR DOCUMENT DIRECTORY";

Etapa 2: crie um documento e uma StructuredDocumentTag

Crie uma nova instância doDocument aula e umStructuredDocumentTag para representar o controle de conteúdo da caixa de combinação. EspecificamosSdtType.ComboBox como o tipo eMarkupLevel.Block como o nível de marcação para criar uma caixa de combinação em nível de bloco.

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

Etapa 3: adicionar itens à caixa de combinação

Adicione itens à caixa de combinação usando oListItems propriedade doStructuredDocumentTag Cada item é representado por umSdtListItem objeto, que recebe um texto de exibição e um valor. Neste exemplo, adicionamos três itens à caixa de combinação.

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"));

Etapa 4: anexar o StructuredDocumentTag ao documento

Anexe o controle de conteúdo da caixa de combinação ao corpo do documento usando o comandoAppendChild método do corpo da primeira seção do documento.

doc.FirstSection.Body.AppendChild(sdt);

Etapa 5: salve o documento

Salve o documento no diretório especificado usando oSave método. Forneça o nome de arquivo desejado com a extensão de arquivo apropriada. Neste exemplo, salvamos o documento como “WorkingWithSdt.ComboBoxContentControl.docx”.

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

Exemplo de código-fonte para controle de conteúdo de caixa de combinação usando Aspose.Words for .NET

	// Caminho para o diretório do seu documento
	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");

É isso! Você criou com sucesso um controle de conteúdo de caixa de combinação em seu documento do Word usando Aspose.Words for .NET.