Interfejs ComboBoxContentControl

Reprezentuje pole kombi na dokument.

Przestrzeń nazw:  Microsoft.Office.Tools.Word
Zestaw:  Microsoft.Office.Tools.Word (w Microsoft.Office.Tools.Word.dll)

Składnia

'Deklaracja
<GuidAttribute("fff2d316-e224-4cd9-a10c-3edf95689a6d")> _
Public Interface ComboBoxContentControl _
    Inherits ContentControlBase, IBindableComponent, IComponent, IDisposable,  _
    ISupportInitialize

[GuidAttribute("fff2d316-e224-4cd9-a10c-3edf95689a6d")]
public interface ComboBoxContentControl : ContentControlBase, 
    IBindableComponent, IComponent, IDisposable, ISupportInitialize

Typ ComboBoxContentControl uwidacznia następujące elementy członkowskie.

Właściwości

	Nazwa	Opis
	Application	Pobiera Microsoft.Office.Interop.Word.Application , oznaczającą w bieżącym wystąpieniu programu Microsoft Office Word.
	BindingContext	Zwraca lub ustawia kolekcji menedżerów waluty IBindableComponent. (Odziedziczone z IBindableComponent).
	Container	Infrastruktura. (Odziedziczone z ContentControlBase).
	ContainerComponent	Infrastruktura. (Odziedziczone z ContentControlBase).
	Creator	32-Bitowa liczba całkowita, która wskazuje aplikacji, w którym dostaje ComboBoxContentControl został utworzony.
	DataBindings	Zwraca kolekcję obiektów wiązania danych dla tej IBindableComponent. (Odziedziczone z IBindableComponent).
	DefaultDataSourceUpdateMode	Pobiera lub ustawia domyślną DataSourceUpdateMode dla ContentControlBase. (Odziedziczone z ContentControlBase).
	DefaultTextStyle	Pobiera nazwę stylu znakowego, który jest używany do formatowania tekstu w ComboBoxContentControl.
	DropDownListEntries	Pobiera zbiór elementów, które są wyświetlane przez ComboBoxContentControl.
	ID	Pobiera unikatowy numer identyfikacyjny formantu zawartości. (Odziedziczone z ContentControlBase).
	InnerObject	Pobiera, podstawową Microsoft.Office.Interop.Word.ContentControl obiekt na potrzeby Microsoft.Office.Tools.Word.ContentControlBase. (Odziedziczone z ContentControlBase).
	LockContentControl	Pobiera lub ustawia wartość, która określa, czy ComboBoxContentControl mogą zostać usunięte z dokumentu.
	LockContents	Pobiera lub ustawia wartość, która określa, czy zawartość ComboBoxContentControl mogą być edytowane.
	MultiLine	Pobiera lub ustawia wartość, która określa, czy ComboBoxContentControl może zawierać podziałów wierszy.
	Parent	Pobiera element nadrzędny z ComboBoxContentControl.
	ParentContentControl	Pobiera element nadrzędny zawartości kontrolę nad ComboBoxContentControl który jest zagnieżdżony w innym formancie zawartości.
	PlaceholderText	Pobiera lub ustawia tekst, który jest wyświetlany na ComboBoxContentControl aż tekst zostanie zmieniony przez akcję użytkownika lub wykonania innej operacji.
	Range	Pobiera Range , oznaczającą zawartość ComboBoxContentControl.
	ShowingPlaceholderText	Pobiera wartość, która wskazuje, czy ComboBoxContentControl nieużywanym tekst zastępczy.
	Site	Zwraca lub ustawia ISite związane z IComponent. (Odziedziczone z IComponent).
	Tag	Pobiera lub ustawia ciąg, który chcesz skojarzyć z ComboBoxContentControl.
	Temporary	Pobiera lub ustawia wartość, która określa, czy ComboBoxContentControl jest automatycznie usuwany z dokumentu, gdy formant jest edytowany.
	Text	Pobiera lub ustawia tekst w ComboBoxContentControl.
	Title	Pobiera lub ustawia tytuł ComboBoxContentControl.
	XMLMapping	Pobiera Microsoft.Office.Interop.Word.XMLMapping , oznaczającą powiązania między ComboBoxContentControl i element niestandardowa część kodu XML.

Początek

Metody

	Nazwa	Opis
	BeginInit	Sygnalizuje ten obiekt, że inicjowania jest uruchamiana. (Odziedziczone z ISupportInitialize).
	Copy	Kopie ComboBoxContentControl z dokumentu do Schowka.
	Cut	Usuwa ComboBoxContentControl z dokumentu i dodaje go do Schowka.
	Delete	Usuwa dynamicznie utworzony formant zawartości z dokumentu i usuwa go z ControlCollection w dokumencie. (Odziedziczone z ContentControlBase).
	Dispose	Wykonuje zadania zdefiniowane aplikacji skojarzonej z zwalniania, zwalnianie lub resetowanie niezarządzanych zasobów. (Odziedziczone z IDisposable).
	EndInit	Sygnalizuje ten obiekt, że inicjowanie zostanie zakończone. (Odziedziczone z ISupportInitialize).
	SetPlaceholderText	Wyświetlany tekst, który znajduje się w T:Microsoft.Office.Interop.Word.BuildingBlock, Range, lub ciąg znaków jako tekstu zastępczego w ComboBoxContentControl.

Początek

Zdarzenia

	Nazwa	Opis
	Added	Występuje po dodaniu formantu zawartości do dokumentu. (Odziedziczone z ContentControlBase).
	BindingContextChanged	Występuje, gdy wartość BindingContext właściwość ContentControlBase zmiany. (Odziedziczone z ContentControlBase).
	ContentUpdating	Występuje tuż przed programu Microsoft Office Word tekst w formancie zawartości jest aktualizowany, jeśli formant zawartości jest powiązany niestandardowa część kodu XML. (Odziedziczone z ContentControlBase).
	Deleting	Występuje tuż przed formant zawartości jest usunięte z dokumentu. (Odziedziczone z ContentControlBase).
	Disposed	Metoda, która obsługuje reprezentuje Disposed zdarzeń składnika. (Odziedziczone z IComponent).
	Entering	Występuje, gdy użytkownik kliknie w formancie zawartości lub w przypadku, gdy kursor jest przesuwany do formantu zawartości programowo. (Odziedziczone z ContentControlBase).
	Exiting	Występuje, gdy użytkownik kliknie poza formantu zawartości lub gdy kursor jest przesuwany poza kontrolą zawartości programowo. (Odziedziczone z ContentControlBase).
	StoreUpdating	Występuje tuż przed programu Microsoft Office Word aktualizuje dane w niestandardowa część kodu XML, która jest ograniczona do zawartości kontroli (to znaczy, po tekstu w treści kontrolowania zmian). (Odziedziczone z ContentControlBase).
	Validated	Występuje, gdy formant zawartości została pomyślnie sprawdzona. (Odziedziczone z ContentControlBase).
	Validating	Występuje, gdy trwa sprawdzanie poprawności zawartości formantu zawartości. (Odziedziczone z ContentControlBase).

Początek

Uwagi

A ComboBoxContentControl Wyświetla listę elementów, które użytkownicy mogą wybierać.Użytkowników można także wpisać swój własny tekst w ComboBoxContentControl.

Aby wyświetlić listę rozwijaną listę elementów w polu tekstowym, które użytkownicy nie mogą edytować, użyj DropDownListContentControl.

Aby wyświetlić listę elementów w ComboBoxContentControl, użyj DropDownListEntries właściwość.

[!UWAGA]

Ten interfejs jest implementowany przez Visual Studio Tools for Office Runtime. Nie jest on przeznaczony do implementacji w kodzie. Aby uzyskać więcej informacji, zobacz Visual Studio Tools dla pakietu Office, omówienie Runtime.

Formanty zawartości

ComboBoxContentControl Jest jednym z ośmiu typów formantów zawartości, które służą do projektowania dokumentów i szablonów w programie Microsoft Office Word.Zawartości, że formanty mają interfejs użytkownika (UI) który kontrolował dane tak, jak formularz.Formanty zawartości można użyć, aby uniemożliwić użytkownikom edytowanie chronionych sekcji dokumentu lub szablonu, a formanty zawartości można również powiązać ze źródłem danych.Aby uzyskać więcej informacji, zobacz Formanty zawartości.

Użycie

W dokumentacji opisano wersję typu używanego w projektach dla pakietu Office przeznaczonych do pracy z programem .NET Framework 4 i .NET Framework 4.5. W projektach przeznaczonych do pracy z programem .NET Framework 3.5 ten typ może mieć inne elementy członkowskie, a przykładowy kod podany dla tego typu może nie działać. Aby uzyskać dokumentację tego typu używanego w projektach przeznaczonych do działania z programem .NET Framework 3.5, zobacz następującą sekcję informacyjną w dokumentacji programu Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.

Przykłady

Poniższy przykład kodu dodaje nowy ComboBoxContentControl do początku dokumentu.Użytkownicy mogą wybrać nazwę koloru, wyświetlany przez formant lub one wpisz nazwę nowego koloru.

Ta wersja jest dostosowywanie poziomie dokumentu.Aby użyć tego kodu, wklej go do ThisDocument klasy w projekcie, a wywołanie AddComboBoxControlAtSelection metodę z ThisDocument_Startup metoda.

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

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

Ta wersja jest na poziomie aplikacji dodatek.Aby użyć tego kodu, wklej go do ThisAddIn klasy w projekcie, a wywołanie AddComboBoxControlAtSelection metodę z ThisAddIn_Startup metoda.

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

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

Zobacz też

Informacje

Przestrzeń nazw Microsoft.Office.Tools.Word

Inne zasoby

Formanty zawartości

Jak: dodawanie formantów zawartości do dokumentów programu Word

Jak: ochrona części dokumentów przy użyciu formantów zawartości

Instruktaż: Tworzenie szablonu przy użyciu formantów zawartości