ComboBoxContentControl Interfejs

Odwołanie

Definicja

Przestrzeń nazw:: Microsoft.Office.Tools.Word

Zestaw:: Microsoft.Office.Tools.Word.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Reprezentuje pole kombi w dokumencie.

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

Atrybuty: GuidAttribute

Implementuje: ContentControlBase IComponent ISupportInitialize IDisposable IBindableComponent

Przykłady

Poniższy przykład kodu dodaje nowy ComboBoxContentControl element na początku dokumentu. Użytkownicy mogą wybrać nazwę koloru wyświetlaną przez kontrolkę lub wpisać nazwę nowego koloru.

Ta wersja dotyczy dostosowywania na poziomie dokumentu. Aby użyć tego kodu, wklej go do ThisDocument klasy w projekcie i wywołaj metodę AddComboBoxControlAtSelection z ThisDocument_Startup metody .

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

Ta wersja dotyczy dodatków na poziomie aplikacji. Aby użyć tego kodu, wklej go do ThisAddIn klasy w projekcie i wywołaj metodę AddComboBoxControlAtSelection z ThisAddIn_Startup metody .

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

Uwagi

Zostanie ComboBoxContentControl wyświetlona lista elementów, które użytkownicy mogą wybrać. Użytkownicy mogą również wpisać własny tekst w obiekcie ComboBoxContentControl.

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

Aby uzyskać dostęp do listy elementów w obiekcie ComboBoxContentControl, użyj DropDownListEntries właściwości .

Uwaga

Ten interfejs jest wdrażany przy użyciu programu Visual Studio Tools for Office Runtime. Nie jest on przeznaczony do implementacji w kodzie. Aby uzyskać więcej informacji, zobacz omówienie środowiska uruchomieniowego Visual Studio Tools dla pakietu Office.

Formanty zawartości

Jest ComboBoxContentControl to jeden z ośmiu typów kontrolek zawartości, których można użyć do projektowania dokumentów i szablonów w pakiecie Microsoft Office Word. Formanty zawartości mają interfejs użytkownika (UI) kontrolujący dane wejściowe np. formę. Formanty zawartości można użyć, aby uniemożliwić użytkownikom edytowanie chronionych sekcji dokumentu lub szablonu; formanty zawartości można również powiązać ze źródłem danych. Aby uzyskać więcej informacji, zobacz Kontrolki zawartości.

Użycie

W tej dokumentacji opisano wersję tego typu używaną tylko w projektach pakietu Office przeznaczonych dla platformy .NET Framework 4 i nowszych. 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ę dotyczącą tego typu projektów przeznaczonych dla .NET Framework 3.5, zobacz następującą sekcję referencyjną w dokumentacji programu Visual Studio 2008: http://go.microsoft.com/fwlink/?LinkId=160658.

Właściwości

Application	Pobiera obiekt Application reprezentujący bieżące wystąpienie Word pakietu Microsoft Office.
Container	Reprezentuje pole kombi w dokumencie. (Odziedziczone po ContentControlBase)
ContainerComponent	Reprezentuje pole kombi w dokumencie. (Odziedziczone po ContentControlBase)
Creator	Pobiera 32-bitową liczbę całkowitą wskazującą aplikację, w której ComboBoxContentControl utworzono.
DefaultDataSourceUpdateMode	Pobiera lub ustawia wartość domyślną DataSourceUpdateMode dla elementu ContentControlBase. (Odziedziczone po ContentControlBase)
DefaultTextStyle	Pobiera nazwę stylu znaku używanego do formatowania tekstu w obiekcie ComboBoxContentControl.
DropDownListEntries	Pobiera kolekcję elementów wyświetlanych przez element ComboBoxContentControl.
ID	Pobiera unikatowy numer identyfikujący kontrolkę zawartości. (Odziedziczone po ContentControlBase)
InnerObject	Pobiera obiekt źródłowy ContentControl dla obiektu ContentControlBase. (Odziedziczone po ContentControlBase)
LockContentControl	Pobiera lub ustawia wartość określającą, czy ComboBoxContentControl można go usunąć z dokumentu.
LockContents	Pobiera lub ustawia wartość określającą, czy zawartość ComboBoxContentControl obiektu można edytować.
MultiLine	Pobiera lub ustawia wartość określającą, czy ComboBoxContentControl może zawierać podziały wierszy.
Parent	Pobiera element nadrzędny obiektu ComboBoxContentControl.
ParentContentControl	Pobiera nadrzędną kontrolkę zawartości obiektu zagnieżdżonego ComboBoxContentControl w innej kontrolce zawartości.
PlaceholderText	Pobiera lub ustawia tekst wyświetlany w obiekcie ComboBoxContentControl , dopóki tekst nie zostanie zmieniony przez akcję użytkownika lub inną operację.
Range	Pobiera obiekt Range reprezentujący zawartość obiektu ComboBoxContentControl.
ShowingPlaceholderText	Pobiera wartość wskazującą, czy ComboBoxContentControl aktualnie wyświetlany jest tekst zastępczy.
Tag	Pobiera lub ustawia ciąg, który chcesz skojarzyć z elementem ComboBoxContentControl.
Temporary	Pobiera lub ustawia wartość, która określa, czy ComboBoxContentControl element jest automatycznie usuwany z dokumentu podczas edycji kontrolki.
Text	Pobiera lub ustawia tekst w obiekcie ComboBoxContentControl.
Title	Pobiera lub ustawia tytuł .ComboBoxContentControl
XMLMapping	Pobiera element XMLMapping reprezentujący powiązanie między elementem ComboBoxContentControl i w niestandardowej części XML.

Metody

Copy()	Kopiuje element ComboBoxContentControl z dokumentu do Schowka.
Cut()	Usuwa element ComboBoxContentControl z dokumentu i dodaje go do Schowka.
Delete(Boolean)	Usuwa dynamicznie utworzoną kontrolkę zawartości z dokumentu i usuwa ją z ControlCollection dokumentu. (Odziedziczone po ContentControlBase)
SetPlaceholderText(BuildingBlock, Range, String)	Wyświetla tekst, który znajduje się w T:Microsoft.Office.Interop. Word. BuildingBlock, ciąg Rangelub ciąg jako tekst zastępczy w elemecie ComboBoxContentControl.

Zdarzenia

Added	Występuje po dodaniu kontrolki zawartości do dokumentu. (Odziedziczone po ContentControlBase)
BindingContextChanged	Występuje, gdy wartość BindingContext właściwości ContentControlBase zmian. (Odziedziczone po ContentControlBase)
ContentUpdating	Występuje tuż przed Word pakietu Microsoft Office aktualizuje tekst w kontrolce zawartości, jeśli kontrolka zawartości jest powiązana z niestandardową częścią XML. (Odziedziczone po ContentControlBase)
Deleting	Występuje tuż przed usunięciem kontrolki zawartości z dokumentu. (Odziedziczone po ContentControlBase)
Entering	Występuje, gdy użytkownik kliknie kontrolkę zawartości lub gdy kursor zostanie przeniesiony programowo do kontrolki zawartości. (Odziedziczone po ContentControlBase)
Exiting	Występuje, gdy użytkownik kliknie poza kontrolkę zawartości lub gdy kursor zostanie przeniesiony poza kontrolkę zawartości programowo. (Odziedziczone po ContentControlBase)
StoreUpdating	Występuje tuż przed Word pakietu Microsoft Office aktualizuje dane w niestandardowej części XML powiązanej z kontrolką zawartości (czyli po zmianie tekstu w kontrolce zawartości). (Odziedziczone po ContentControlBase)
Validated	Występuje, gdy kontrolka zawartości została pomyślnie zweryfikowana. (Odziedziczone po ContentControlBase)
Validating	Występuje, gdy zawartość kontrolki zawartości jest weryfikowana. (Odziedziczone po ContentControlBase)

Dotyczy

Udostępnij za pośrednictwem