Управление содержимым поля со списком

В этом руководстве объясняется, как создать элемент управления содержимым поля со списком в документе Word с помощью Aspose.Words для .NET. Элементы управления содержимым поля со списком позволяют пользователям выбирать элемент из раскрывающегося списка.

Предварительные условия

Чтобы следовать этому руководству, вам необходимо иметь следующее:

  • Установлена библиотека Aspose.Words для .NET.
  • Базовые знания C# и обработки документов Word.

Шаг 1. Настройте каталог документов

Начните с настройки пути к каталогу ваших документов. Заменять"YOUR DOCUMENT DIRECTORY" с фактическим путем к каталогу, в котором вы хотите сохранить документ.

string dataDir = "YOUR DOCUMENT DIRECTORY";

Шаг 2. Создайте документ и StructuredDocumentTag.

Создайте новый экземплярDocument класс иStructuredDocumentTag для представления элемента управления содержимым поля со списком. УказатьSdtType.ComboBox как тип иMarkupLevel.Block в качестве уровня разметки для создания поля со списком на уровне блока.

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

Шаг 3. Добавьте элементы в поле со списком

Добавьте элементы в поле со списком, используяListItems собственностьStructuredDocumentTag Каждый элемент представленSdtListItem объект, который принимает отображаемый текст и значение. В этом примере мы добавляем три элемента в поле со списком.

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

Шаг 4. Добавьте тег StructuredDocumentTag в документ.

Добавьте элемент управления содержимым поля со списком к телу документа, используя командуAppendChild метод тела первого раздела документа.

doc.FirstSection.Body.AppendChild(sdt);

Шаг 5: Сохраните документ

Сохраните документ в указанную директорию, используя командуSave метод. Укажите желаемое имя файла с соответствующим расширением. В этом примере мы сохраняем документ как «WorkingWithSdt.ComboBoxContentControl.docx».

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

Пример исходного кода для управления содержимым поля со списком с использованием Aspose.Words для .NET

	// Путь к каталогу ваших документов
	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");

Вот и все! Вы успешно создали элемент управления содержимым поля со списком в документе Word с помощью Aspose.Words для .NET.