Udostępnij za pośrednictwem

Interfejs DropDownListContentControl

  • Artykuł

Reprezentuje listy rozwijanej na dokumencie.

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

Składnia

'Deklaracja
<GuidAttribute("ae93cbb1-82a6-4a2b-9540-a0c82ff9ebcb")> _
Public Interface DropDownListContentControl _
    Inherits ContentControlBase, IBindableComponent, IComponent, IDisposable,  _
    ISupportInitialize

[GuidAttribute("ae93cbb1-82a6-4a2b-9540-a0c82ff9ebcb")]
public interface DropDownListContentControl : ContentControlBase, 
    IBindableComponent, IComponent, IDisposable, ISupportInitialize

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

Właściwości

  Nazwa Opis
Właściwość publiczna Application Pobiera Microsoft.Office.Interop.Word.Application , oznaczającą 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 32-Bitowa liczba całkowita, która wskazuje aplikacji, w którym dostaje DropDownListContentControl 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 DropDownListContentControl.
Właściwość publiczna DropDownListEntries Pobiera zbiór elementów, które są wyświetlane przez DropDownListContentControl.
Właściwość publiczna ID Pobiera unikatowy numer identyfikacyjny formantu zawartości. (Odziedziczone z ContentControlBase).
Właściwość publiczna InnerObject Pobiera, podstawową Microsoft.Office.Interop.Word.ContentControl obiekt na potrzeby Microsoft.Office.Tools.Word.ContentControlBase. (Odziedziczone z ContentControlBase).
Właściwość publiczna LockContentControl Pobiera lub ustawia wartość, która określa, czy DropDownListContentControl mogą zostać usunięte z dokumentu.
Właściwość publiczna LockContents Pobiera lub ustawia wartość, która określa, czy zawartość DropDownListContentControl mogą być edytowane.
Właściwość publiczna MultiLine Pobiera lub ustawia wartość, która określa, czy DropDownListContentControl może zawierać podziałów wierszy.
Właściwość publiczna Parent Pobiera element nadrzędny z DropDownListContentControl.
Właściwość publiczna ParentContentControl Pobiera element nadrzędny zawartości kontrolę nad DropDownListContentControl 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 na DropDownListContentControl aż tekst zostanie zmieniony przez akcję użytkownika lub wykonania innej operacji.
Właściwość publiczna Range Pobiera Range , oznaczającą zawartość DropDownListContentControl.
Właściwość publiczna ShowingPlaceholderText Pobiera wartość, która wskazuje, czy DropDownListContentControl nieużywanym tekst zastępczy.
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 chcesz skojarzyć z DropDownListContentControl.
Właściwość publiczna Temporary Pobiera lub ustawia wartość, która określa, czy DropDownListContentControl jest automatycznie usuwany z dokumentu, gdy formant jest edytowany.
Właściwość publiczna Text Pobiera tekst DropDownListContentControl.
Właściwość publiczna Title Pobiera lub ustawia tytuł DropDownListContentControl.
Właściwość publiczna XMLMapping Pobiera XMLMapping , oznaczającą powiązania między DropDownListContentControl 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 DropDownListContentControl z dokumentu do Schowka.
Metoda publiczna Cut Usuwa DropDownListContentControl 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 aplikacji skojarzonej z zwalniania, zwalnianie lub resetowanie 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świetlany tekst, który znajduje się w BuildingBlock, Range, lub ciąg znaków jako tekstu zastępczego w DropDownListContentControl.

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ść ContentControlBase zmiany. (Odziedziczone z ContentControlBase).
Zdarzenie publiczne 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).
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 w formancie zawartości lub w przypadku, gdy kursor jest przesuwany do formantu zawartości programowo. (Odziedziczone z ContentControlBase).
Zdarzenie publiczne Exiting Występuje, gdy użytkownik kliknie poza formantu zawartości lub gdy kursor jest przesuwany 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, która jest ograniczona do zawartości kontroli (to znaczy, po tekstu w treści kontrolowania zmian). (Odziedziczone z ContentControlBase).
Zdarzenie publiczne Validated Występuje, gdy formant zawartości została pomyślnie sprawdzona. (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 DropDownListContentControl Wyświetla listę elementów, które użytkownicy mogą wybierać.

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

Aby umożliwić użytkownikom wybranie z listy elementów lub dodać swój własny tekst do formantu, należy użyć ComboBoxContentControl.

[!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

DropDownListContentControl 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 DropDownListContentControl do początku dokumentu.Użytkownicy mogą wybrać nazwę dnia tygodnia w formancie.

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

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

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

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 = Globals.Factory.GetVstoObject(Me.Application.ActiveDocument)
    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 = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
    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";
}

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

Instruktaż: Powiązanie formantów zawartości do części XML niestandardowe