Udostępnij za pośrednictwem

Interfejs ComboBoxContentControl

  • Artykuł

Reprezentuje pole kombi w dokumencie.

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
Właściwość publiczna Application Pobiera Microsoft.Office.Interop.Word.Application reprezentująca w bieżącym wystąpieniu programu Microsoft Office Word.
Właściwość publiczna BindingContext Zwraca lub ustawia kolekcji menedżerów waluty IBindableComponent. (Odziedziczone z IBindableComponent).
Właściwość publiczna Container Infrastruktura. (Odziedziczone z ContentControlBase).
Właściwość publiczna ContainerComponent Infrastruktura. (Odziedziczone z ContentControlBase).
Właściwość publiczna Creator Pobiera całkowita 32-bitowa, wskazująca aplikacji, w której ComboBoxContentControl został utworzony.
Właściwość publiczna DataBindings Zwraca kolekcję obiektów wiązania danych dla tej IBindableComponent. (Odziedziczone z IBindableComponent).
Właściwość publiczna DefaultDataSourceUpdateMode Pobiera lub ustawia domyślną DataSourceUpdateMode dla ContentControlBase. (Odziedziczone z ContentControlBase).
Właściwość publiczna DefaultTextStyle Pobiera nazwę stylu znakowego, który jest używany do formatowania tekstu w ComboBoxContentControl.
Właściwość publiczna DropDownListEntries Pobiera zbiór elementów, które są wyświetlane przez ComboBoxContentControl.
Właściwość publiczna ID Pobiera unikatowy numer, który identyfikuje formant zawartości. (Odziedziczone z ContentControlBase).
Właściwość publiczna InnerObject Pobiera podstawowych Microsoft.Office.Interop.Word.ContentControl dla obiektu Microsoft.Office.Tools.Word.ContentControlBase. (Odziedziczone z ContentControlBase).
Właściwość publiczna LockContentControl Pobiera lub ustawia wartość określająca, czy ComboBoxContentControl może być usunięty z dokumentu.
Właściwość publiczna LockContents Pobiera lub ustawia wartość, która określa, czy zawartość ComboBoxContentControl mogą być edytowane.
Właściwość publiczna MultiLine Pobiera lub ustawia wartość określająca, czy ComboBoxContentControl mogą zawierać podziałów wierszy.
Właściwość publiczna Parent Pobiera element nadrzędny z ComboBoxContentControl.
Właściwość publiczna ParentContentControl Pobiera nadrzędnego zawartości kontrolę nad ComboBoxContentControl który jest zagnieżdżony w innym formancie zawartości.
Właściwość publiczna PlaceholderText Pobiera lub ustawia tekst, który jest wyświetlany w ComboBoxContentControl aż tekst zostanie zmieniony przez akcję użytkownika lub innej operacji.
Właściwość publiczna Range Pobiera Range reprezentująca zawartość ComboBoxContentControl.
Właściwość publiczna ShowingPlaceholderText Pobiera wartość wskazująca, czy ComboBoxContentControl jest obecnie wyświetlanie tekstu zastępczego.
Właściwość publiczna Site Zwraca lub ustawia ISite związane z IComponent. (Odziedziczone z IComponent).
Właściwość publiczna Tag Pobiera lub ustawia ciąg, który ma być skojarzony z ComboBoxContentControl.
Właściwość publiczna Temporary Pobiera lub ustawia wartość określająca, czy ComboBoxContentControl jest automatycznie usuwany z dokumentu podczas edycji formantu.
Właściwość publiczna Text Pobiera lub ustawia tekst w ComboBoxContentControl.
Właściwość publiczna Title Pobiera lub ustawia tytuł ComboBoxContentControl.
Właściwość publiczna XMLMapping Pobiera Microsoft.Office.Interop.Word.XMLMapping reprezentująca powiązania między ComboBoxContentControl i element niestandardowa część kodu XML.

Początek

Metody

  Nazwa Opis
Metoda publiczna BeginInit Sygnalizuje ten obiekt, że inicjowania jest uruchamiana. (Odziedziczone z ISupportInitialize).
Metoda publiczna Copy Kopie ComboBoxContentControl z dokumentu do Schowka.
Metoda publiczna Cut Usuwa ComboBoxContentControl z dokumentu i dodaje go do Schowka.
Metoda publiczna Delete Usuwa dynamicznie utworzony formant zawartości z dokumentu i usuwa go z ControlCollection w dokumencie. (Odziedziczone z ContentControlBase).
Metoda publiczna Dispose Wykonuje zadania zdefiniowane przez aplikację skojarzone z uwalnianiem, zwalnianiem lub resetowaniem niezarządzanych zasobów. (Odziedziczone z IDisposable).
Metoda publiczna EndInit Sygnalizuje ten obiekt, że inicjowanie zostanie zakończone. (Odziedziczone z ISupportInitialize).
Metoda publiczna SetPlaceholderText Wyświetla 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
Zdarzenie publiczne Added Występuje po dodaniu formantu zawartości do dokumentu. (Odziedziczone z ContentControlBase).
Zdarzenie publiczne BindingContextChanged Występuje, gdy wartość BindingContext właściwości ContentControlBase zmiany. (Odziedziczone z ContentControlBase).
Zdarzenie publiczne ContentUpdating Występuje tuż przed tekstu w formancie zawartości, aktualizacje programu Microsoft Office Word, jeśli niestandardowa część kodu XML jest powiązany formant zawartości. (Odziedziczone z ContentControlBase).
Zdarzenie publiczne Deleting Występuje tuż przed formant zawartości jest usunięte z dokumentu. (Odziedziczone z ContentControlBase).
Zdarzenie publiczne Disposed Metoda, która obsługuje reprezentuje Disposed zdarzeń składnika. (Odziedziczone z IComponent).
Zdarzenie publiczne Entering Występuje, gdy użytkownik kliknie przycisk w formancie zawartości lub gdy kursor jest przesuwany do formantu zawartości programowo. (Odziedziczone z ContentControlBase).
Zdarzenie publiczne Exiting Występuje, gdy użytkownik kliknie poza formant zawartości lub gdy kursor zostanie przeniesiony poza kontrolą zawartości programowo. (Odziedziczone z ContentControlBase).
Zdarzenie publiczne StoreUpdating Występuje tuż przed programu Microsoft Office Word aktualizuje dane w niestandardowa część kodu XML, powiązaną z zawartością sterowania (po tekstu w treści kontrolować zmiany). (Odziedziczone z ContentControlBase).
Zdarzenie publiczne Validated Występuje, gdy formant zawartości został pomyślnie sprawdzony. (Odziedziczone z ContentControlBase).
Zdarzenie publiczne 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ć 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 uzyskać dostęp do listy 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 for Office Runtime ― Przegląd.

Formanty zawartości

ComboBoxContentControl Jest jednym z ośmiu typów formantów zawartości, których można użyć do projektowania dokumentów i szablonów w programie Microsoft Office Word.Zawartość formantów ma interfejs użytkownika (UI) który kontrolował wprowadzania, np.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 kod dodaje nowy ComboBoxContentControl do początku dokumentu.Użytkownicy mogą wybrać nazwę kolor wyświetlany przez formant lub ich wpisz nazwę nowego koloru.

Ta wersja jest dla dostosowania poziomu dokumentu.Aby użyć tego kodu, wklej go do ThisDocument klasy w projekcie i wywołanie AddComboBoxControlAtSelection metodę z ThisDocument_Startup metody.

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 i wywołanie AddComboBoxControlAtSelection metodę z ThisAddIn_Startup metody.

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

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

Porady: ochrona części dokumentów za pomocą formantów zawartości

Wskazówki: tworzenie szablonu za pomocą formantów zawartości