Поделиться через

ComboBoxContentControl Интерфейс

  • Ссылка

Определение

Пространство имен:
Microsoft.Office.Tools.Word
Сборка:
Microsoft.Office.Tools.Word.dll

Представляет поле со списком для документа.

public interface class ComboBoxContentControl : IDisposable, Microsoft::Office::Tools::Word::ContentControlBase, System::ComponentModel::IComponent, System::ComponentModel::ISupportInitialize, System::Windows::Forms::IBindableComponent
[System.Runtime.InteropServices.Guid("fff2d316-e224-4cd9-a10c-3edf95689a6d")]
public interface ComboBoxContentControl : IDisposable, Microsoft.Office.Tools.Word.ContentControlBase, System.ComponentModel.IComponent, System.ComponentModel.ISupportInitialize, System.Windows.Forms.IBindableComponent
[<System.Runtime.InteropServices.Guid("fff2d316-e224-4cd9-a10c-3edf95689a6d")>]
type ComboBoxContentControl = interface
    interface ContentControlBase
    interface IBindableComponent
    interface IComponent
    interface IDisposable
    interface ISupportInitialize
Public Interface ComboBoxContentControl
Implements ContentControlBase, IBindableComponent, IComponent, IDisposable, ISupportInitialize
Атрибуты
GuidAttribute
Реализации
ContentControlBase IComponent ISupportInitialize IDisposable IBindableComponent

Примеры

В следующем примере кода в начало документа добавляется новый ComboBoxContentControl объект . Пользователи могут выбрать имя цвета, отображаемое элементом управления, или ввести имя нового цвета.

Эта версия используется для настройки на уровне документа. Чтобы использовать этот код, вставьте его в ThisDocument класс в проекте и вызовите AddComboBoxControlAtSelection метод из ThisDocument_Startup метода .

private Microsoft.Office.Tools.Word.ComboBoxContentControl comboBoxControl1;

private void AddComboBoxControlAtSelection()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    this.Paragraphs[1].Range.Select();

    comboBoxControl1 = this.Controls.AddComboBoxContentControl("comboBoxControl1");
    comboBoxControl1.DropDownListEntries.Add("Red", "Red", 0);
    comboBoxControl1.DropDownListEntries.Add("Green", "Green", 1);
    comboBoxControl1.DropDownListEntries.Add("Blue", "Blue", 2);
    comboBoxControl1.PlaceholderText = "Choose a color, or enter your own";
}

Dim comboBoxControl1 As Microsoft.Office.Tools.Word.ComboBoxContentControl

Private Sub AddComboBoxControlAtSelection()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Me.Paragraphs(1).Range.Select()
    comboBoxControl1 = Me.Controls.AddComboBoxContentControl("comboBoxControl1")
    With comboBoxControl1
        .DropDownListEntries.Add("Red", "Red", 0)
        .DropDownListEntries.Add("Green", "Green", 1)
        .DropDownListEntries.Add("Blue", "Blue", 2)
        .PlaceholderText = "Choose a color, or enter your own"
    End With
End Sub

Эта версия предназначена для надстройки уровня приложения. Чтобы использовать этот код, вставьте его в ThisAddIn класс в проекте и вызовите AddComboBoxControlAtSelection метод из ThisAddIn_Startup метода .

private Microsoft.Office.Tools.Word.ComboBoxContentControl comboBoxControl1;

private void AddComboBoxControlAtSelection()
{
    if (this.Application.ActiveDocument == null)
        return;

    Document vstoDoc = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
    vstoDoc.Paragraphs[1].Range.InsertParagraphBefore();
    vstoDoc.Paragraphs[1].Range.Select();

    comboBoxControl1 = vstoDoc.Controls.AddComboBoxContentControl(
        "comboBoxControl1");
    comboBoxControl1.DropDownListEntries.Add("Red", "Red", 0);
    comboBoxControl1.DropDownListEntries.Add("Green", "Green", 1);
    comboBoxControl1.DropDownListEntries.Add("Blue", "Blue", 2);
    comboBoxControl1.PlaceholderText = "Choose a color, or enter your own";            
}

Dim comboBoxControl1 As Microsoft.Office.Tools.Word.ComboBoxContentControl

Private Sub AddComboBoxControlAtSelection()
    If Me.Application.ActiveDocument Is Nothing Then
        Return
    End If

    Dim vstoDoc As Document = Globals.Factory.GetVstoObject(Me.Application.ActiveDocument)
    vstoDoc.Paragraphs(1).Range.InsertParagraphBefore()
    vstoDoc.Paragraphs(1).Range.Select()
    comboBoxControl1 = vstoDoc.Controls.AddComboBoxContentControl("comboBoxControl1")
    With comboBoxControl1
        .DropDownListEntries.Add("Red", "Red", 0)
        .DropDownListEntries.Add("Green", "Green", 1)
        .DropDownListEntries.Add("Blue", "Blue", 2)
        .PlaceholderText = "Choose a color, or enter your own"
    End With
End Sub

Комментарии

Отображает ComboBoxContentControl список элементов, которые могут выбирать пользователи. Пользователи также могут вводить собственный текст в .ComboBoxContentControl

Чтобы отобразить раскрывающийся список элементов в текстовом поле, которое пользователи не могут редактировать, используйте DropDownListContentControl.

Для доступа к списку элементов в используйте ComboBoxContentControlDropDownListEntries свойство .

Примечание

Данный интерфейс реализуется набором средств Visual Studio Tools for Office (среда выполнения). Он не предназначен для реализации в пользовательском коде. Дополнительные сведения см. в разделе Visual Studio Tools for Office Runtime Overview.

Элементы управления содержимым

— ComboBoxContentControl это один из восьми типов элементов управления содержимым, которые можно использовать для разработки документов и шаблонов в Microsoft Office Word. Элементы управления содержимым имеют пользовательский интерфейс, который имеет управляемые входные данные, например форму. Вы можете использовать элементы управления содержимым, чтобы запретить пользователям изменять защищенные разделы документа или шаблона, а также привязать элементы управления содержимым к источнику данных. Для получения дополнительной информации см. Content Controls.

Использование

В настоящей документации описывается версия этого типа, которая используется в проектах Office, предназначенных для платформы .NET Framework 4 или более поздних ее версий. В проектах, предназначенных для платформы .NET Framework 3.5, этот тип может содержать другие члены, а примеры кода, приведенные для этого типа, могут не работать. Документацию об этом типе в проектах, предназначенных для платформы .NET Framework 3.5, см. в следующем справочном разделе документации Visual Studio 2008: http://go.microsoft.com/fwlink/?LinkId=160658.

Свойства

Application

Получает объект Application, представляющий текущий экземпляр Microsoft Office Word.
Container

Представляет поле со списком для документа.

(Унаследовано от ContentControlBase)
ContainerComponent

Представляет поле со списком для документа.

(Унаследовано от ContentControlBase)
Creator

Возвращает 32-разрядное целое число, указывающее приложение, в котором был создан элемент управления ComboBoxContentControl.
DefaultDataSourceUpdateMode

Получает или задает значение DataSourceUpdateMode по умолчанию для ContentControlBase.

(Унаследовано от ContentControlBase)
DefaultTextStyle

Возвращает имя стиля знака, используемого для форматирования текста в элементе управления ComboBoxContentControl.
DropDownListEntries

Возвращает коллекцию элементов, отображаемых в элементе управления ComboBoxContentControl.
ID

Возвращает уникальное число, идентифицирующее элемент управления содержимым.

(Унаследовано от ContentControlBase)
InnerObject

Получает базовый объект ContentControl для объекта ContentControlBase.

(Унаследовано от ContentControlBase)
LockContentControl

Получает или задает значение, которое указывает, можно ли удалять объект ComboBoxContentControl из документа.
LockContents

Получает или задает значение, которое указывает, можно ли редактировать содержимое объекта ComboBoxContentControl.
MultiLine

Возвращает или задает значение, указывающее, может ли элемент управления ComboBoxContentControl содержать разрывы строк.
Parent

Возвращает родительский класс класса ComboBoxContentControl.
ParentContentControl

Возвращает родительский элемент управления содержимым для элемента управления ComboBoxContentControl, вложенного в другой элемент управления содержимым.
PlaceholderText

Возвращает или задает текст, отображаемый в элементе управления ComboBoxContentControl, пока текст не будет изменен в результате действий пользователя или иной операции.
Range

Получает объект Range, представляющий содержимое объекта ComboBoxContentControl.
ShowingPlaceholderText

Возвращает значение, указывающее, отображается ли в настоящее время в элементе управления ComboBoxContentControl замещающий текст.
Tag

Возвращает или задает строку, которую необходимо связать с элементом управления ComboBoxContentControl.
Temporary

Возвращает или задает значение, указывающее, будет ли элемент управления ComboBoxContentControl автоматически удаляться из документа при изменении этого элемента управления.
Text

Возвращает или задает текст в элементе управления ComboBoxContentControl.
Title

Получает или задает заголовок ComboBoxContentControl.
XMLMapping

Получает объект XMLMapping, который представляет привязку между объектом ComboBoxContentControl и элементом в пользовательской XML-части.

Методы

Copy()

Копирует элемент управления ComboBoxContentControl из документа в буфер обмена.
Cut()

Удаляет из документа элемент управления ComboBoxContentControl и заносит его в буфер обмена.
Delete(Boolean)

Удаляет динамически созданный элемент управления содержимым из документа и из коллекции ControlCollection в документе.

(Унаследовано от ContentControlBase)
SetPlaceholderText(BuildingBlock, Range, String)

Отображает текст в T:Microsoft.Office.Interop. Word. BuildingBlock, Rangeили строка в качестве замещающего текста в ComboBoxContentControl.

События

Added

Происходит после добавления в документ элемента управления содержимым.

(Унаследовано от ContentControlBase)
BindingContextChanged

Происходит при изменении значения свойства BindingContext объекта ContentControlBase.

(Унаследовано от ContentControlBase)
ContentUpdating

Происходит непосредственно перед тем, как приложение Microsoft Office Word обновляет текст в элементе управления содержимым, если этот элемент управления привязан к настраиваемой XML-части.

(Унаследовано от ContentControlBase)
Deleting

Происходит непосредственно перед удалением из документа элемента управления содержимым.

(Унаследовано от ContentControlBase)
Entering

Происходит, когда пользователь щелкает мышью внутри элемента управления содержимым, либо при программном перемещении курсора внутрь элемента управления содержимым.

(Унаследовано от ContentControlBase)
Exiting

Происходит, когда пользователь щелкает мышью за пределами элемента управления содержимым, либо при программном перемещении курсора за пределы элемента управления содержимым.

(Унаследовано от ContentControlBase)
StoreUpdating

Происходит непосредственно перед тем, как Microsoft Office Word автоматически обновляет данные в пользовательской XML-части, которая привязана к элементу управления содержимым (то есть после изменения текста в элементе управления содержимым).

(Унаследовано от ContentControlBase)
Validated

Происходит после успешной проверки элемента управления содержимым.

(Унаследовано от ContentControlBase)
Validating

Происходит при проверке содержимого элемента управления.

(Унаследовано от ContentControlBase)

Применяется к