DropDownListContentControl Класс (2007 System)
Обновлен: Июль 2008
Представляет в документе раскрывающийся список.
Пространство имен: Microsoft.Office.Tools.Word
Сборка: Microsoft.Office.Tools.Word.v9.0 (в Microsoft.Office.Tools.Word.v9.0.dll)
Синтаксис
'Декларация
<DefaultBindingPropertyAttribute("PlaceholderText")> _
<PermissionSetAttribute(SecurityAction.Demand, Name := "FullTrust")> _
Public NotInheritable Class DropDownListContentControl _
Inherits ContentControlBase _
Implements ISupportInitializeControl, ISupportInitialize
'Применение
Dim instance As DropDownListContentControl
[DefaultBindingPropertyAttribute("PlaceholderText")]
[PermissionSetAttribute(SecurityAction.Demand, Name = "FullTrust")]
public sealed class DropDownListContentControl : ContentControlBase,
ISupportInitializeControl, ISupportInitialize
Заметки
Элемент управления DropDownListContentControl используется для вывода списка элементов, которые пользователи могут выбирать.
Чтобы получить доступ к списку элементов в элементе управления DropDownListContentControl, воспользуйтесь свойством DropDownListEntries.
Чтобы предоставить пользователям возможность выбирать из списка элементов или добавлять в элемент управления собственный текст, воспользуйтесь элементом управления ComboBoxContentControl.
Элементы управления содержимым
Элемент управления DropDownListContentControl является одним из восьми типов элементов управления содержимым, используемых для разработки документов и шаблонов в приложении Microsoft Office Word. Элементы управления с содержимым обладают пользовательским интерфейсом с управляемым вводом, подобным тому, который используется в формах. С помощью элементов управления содержимым можно запретить пользователям редактировать защищенные разделы документа или шаблона; эти элементы управления также можно привязать к источнику данных. Дополнительные сведения см. в разделе Элементы управления содержимым.
Примеры
В приведенном ниже примере кода в начало документа добавляется новый элемент управления DropDownListContentControl. В этом элементе управления пользователь может выбрать название дня недели.
Эта версия предназначена для настройки уровня документа. Чтобы воспользоваться этим кодом, вставьте его в проекте в класс ThisDocument и вызовите из метода ThisDocument_Startup метод AddDropDownListControlAtSelection.
Dim dropDownListControl1 As Microsoft.Office.Tools.Word.DropDownListContentControl
Private Sub AddDropDownListControlAtSelection()
Me.Paragraphs(1).Range.InsertParagraphBefore()
Me.Paragraphs(1).Range.Select()
dropDownListControl1 = Me.Controls.AddDropDownListContentControl("dropDownListControl1")
With dropDownListControl1
.DropDownListEntries.Add("Monday", "Monday", 0)
.DropDownListEntries.Add("Tuesday", "Tuesday", 1)
.DropDownListEntries.Add("Wednesday", "Wednesday", 2)
.PlaceholderText = "Choose a day"
End With
End Sub
private Microsoft.Office.Tools.Word.DropDownListContentControl dropDownListControl1;
private void AddDropDownListControlAtSelection()
{
this.Paragraphs[1].Range.InsertParagraphBefore();
this.Paragraphs[1].Range.Select();
dropDownListControl1 = this.Controls.AddDropDownListContentControl("dropDownListControl1");
dropDownListControl1.DropDownListEntries.Add("Monday", "Monday", 0);
dropDownListControl1.DropDownListEntries.Add("Tuesday", "Tuesday", 1);
dropDownListControl1.DropDownListEntries.Add("Wednesday", "Wednesday", 2);
dropDownListControl1.PlaceholderText = "Choose a day";
}
Эта версия предназначена для надстройки уровня приложения. Чтобы воспользоваться этим кодом, вставьте его в проекте в класс ThisAddIn и вызовите из метода ThisAddIn_Startup метод AddDropDownListControlAtSelection.
Dim dropDownListControl1 As Microsoft.Office.Tools.Word.DropDownListContentControl
Private Sub AddDropDownListControlAtSelection()
If Me.Application.ActiveDocument Is Nothing Then
Return
End If
Dim vstoDoc As Document = Me.Application.ActiveDocument.GetVstoObject()
vstoDoc.Paragraphs(1).Range.InsertParagraphBefore()
vstoDoc.Paragraphs(1).Range.Select()
dropDownListControl1 = vstoDoc.Controls.AddDropDownListContentControl("dropDownListControl1")
With dropDownListControl1
.DropDownListEntries.Add("Monday", "Monday", 0)
.DropDownListEntries.Add("Tuesday", "Tuesday", 1)
.DropDownListEntries.Add("Wednesday", "Wednesday", 2)
.PlaceholderText = "Choose a day"
End With
End Sub
private Microsoft.Office.Tools.Word.DropDownListContentControl dropDownListControl1;
private void AddDropDownListControlAtSelection()
{
if (this.Application.ActiveDocument == null)
return;
Document vstoDoc = this.Application.ActiveDocument.GetVstoObject();
vstoDoc.Paragraphs[1].Range.InsertParagraphBefore();
vstoDoc.Paragraphs[1].Range.Select();
dropDownListControl1 = vstoDoc.Controls.AddDropDownListContentControl("dropDownListControl1");
dropDownListControl1.DropDownListEntries.Add("Monday", "Monday", 0);
dropDownListControl1.DropDownListEntries.Add("Tuesday", "Tuesday", 1);
dropDownListControl1.DropDownListEntries.Add("Wednesday", "Wednesday", 2);
dropDownListControl1.PlaceholderText = "Choose a day";
}
Иерархия наследования
System.Object
Microsoft.VisualStudio.Tools.Office.RemoteComponent
Microsoft.VisualStudio.Tools.Office.RemoteBindableComponent
Microsoft.Office.Tools.Word.ContentControlBase
Microsoft.Office.Tools.Word.DropDownListContentControl
Потокобезопасность
Любые открытые члены этого типа, объявленные как static (Shared в Visual Basic), являются потокобезопасными. Потокобезопасность членов экземпляров не гарантируется.
См. также
Ссылки
DropDownListContentControl - члены
Microsoft.Office.Tools.Word - пространство имен
Другие ресурсы
Элементы управления содержимым
Практическое руководство. Добавление элементов управления содержимым в документы Word
Практическое руководство. Защита частей документов с помощью элементов управления содержимым
Пошаговое руководство. Создание шаблона с помощью элементов управления содержимым
Пошаговое руководство. Привязка элементов управления содержимым к пользовательским XML-частям
Журнал изменений
Дата |
Журнал событий |
Причина |
---|---|---|
Июль 2008 |
Добавлена версия кода для надстройки уровня приложения. |
Изменение функции SP1. |