ComboBoxContentControl Rozhraní

Definice

Představuje pole se seznamem na dokumentu.

[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
Atributy
Implementuje

Příklady

Následující příklad kódu přidá nový ComboBoxContentControl na začátek dokumentu. Uživatelé mohou vybrat název barvy zobrazený ovládacím prvkem nebo mohou zadat název nové barvy.

Tato verze je pro přizpůsobení na úrovni dokumentu. Chcete-li použít tento kód, vložte jej do ThisDocument třídy v projektu a zavolejte AddComboBoxControlAtSelection metodu 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

Tato verze je pro doplněk na úrovni aplikace. Chcete-li použít tento kód, vložte jej do ThisAddIn třídy v projektu a zavolejte AddComboBoxControlAtSelection metodu 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

Poznámky

ComboBoxContentControlZobrazí seznam položek, které mohou uživatelé vybrat. Uživatelé můžou do zadat také vlastní text ComboBoxContentControl .

Chcete-li zobrazit rozevírací seznam položek v textovém poli, které uživatelé nemohou upravovat, použijte DropDownListContentControl .

Chcete-li získat přístup k seznamu položek v ComboBoxContentControl , použijte DropDownListEntries vlastnost.

Poznámka

Toto rozhraní je implementováno modulem Visual Studio Tools for Office Runtime. Rozhraní není určeno k implementaci do vašeho kódu. Další informace najdete v tématu Visual Studio Tools for Office Runtime přehled.

Ovládací prvky obsahu

ComboBoxContentControlJe jedním z osmi typů ovládacích prvků obsahu, které lze použít k návrhu dokumentů a šablon v aplikaci systém Microsoft Office Word. Ovládací prvky obsahu mají uživatelské rozhraní, které má řízený vstup v podobě formuláře. Pomocí ovládacích prvků obsahu můžete uživatelům zabránit v provádění úprav chráněných oddílů dokumentu nebo šablony a ovládací prvky obsahu pak můžete navázat na zdroj dat. Další informace najdete v tématu ovládací prvky obsahu.

Využití

Tato dokumentace popisuje verzi tohoto typu, který se používá v projektech Office cílených na rozhraní .NET Framework 4 nebo novější. V projektech cílených pro rozhraní .NET Framework 3.5 může mít tento typ jiné členy a ukázky kódu, poskytnuté pro tento typ, nemusejí fungovat. Dokumentaci k tomuto typu projektů cílených rozhraní .NET Framework 3.5 najdete v následující informační části dokumentace k Visual Studiu 2008: http://go.microsoft.com/fwlink/?LinkId=160658 .

Vlastnosti

Application

Získá Application , který představuje aktuální instanci systém Microsoft Office Wordu.

Container (Zděděno od ContentControlBase)
ContainerComponent (Zděděno od ContentControlBase)
Creator

Získá 32 celé číslo, které označuje aplikaci, ve které ComboBoxContentControl byl vytvořen.

DefaultDataSourceUpdateMode

Získá nebo nastaví výchozí hodnotu DataSourceUpdateMode pro ContentControlBase .

(Zděděno od ContentControlBase)
DefaultTextStyle

Získá název stylu znaku, který se používá k formátování textu v ComboBoxContentControl .

DropDownListEntries

Získá kolekci položek, které jsou zobrazeny ComboBoxContentControl .

ID

Získá jedinečné číslo identifikující ovládací prvek obsahu.

(Zděděno od ContentControlBase)
InnerObject

Získá základní ContentControl objekt pro ContentControlBase .

(Zděděno od ContentControlBase)
LockContentControl

Získává nebo nastavuje hodnotu, která určuje, jestli se ComboBoxContentControl dá odstranit z dokumentu.

LockContents

Získává nebo nastavuje hodnotu, která určuje, jestli se ComboBoxContentControl dá upravovat obsah.

MultiLine

Získává nebo nastavuje hodnotu, která určuje, jestli ComboBoxContentControl může obsahovat konce řádků.

Parent

Získá nadřazenou položku ComboBoxContentControl .

ParentContentControl

Získá nadřazený ovládací prvek obsahu ComboBoxContentControl , který je vnořen v jiném ovládacím prvku obsahu.

PlaceholderText

Získá nebo nastaví text, který se zobrazí v zobrazení, ComboBoxContentControl dokud se text nezměnil pomocí akce uživatele nebo jiné operace.

Range

Získá Range , který představuje obsah ComboBoxContentControl .

ShowingPlaceholderText

Načte hodnotu, která označuje, zda ComboBoxContentControl aktuálně zobrazuje zástupný text.

Tag

Získá nebo nastaví řetězec, který chcete přidružit k ComboBoxContentControl .

Temporary

Získává nebo nastavuje hodnotu, která určuje, jestli se má ComboBoxContentControl při úpravě ovládacího prvku automaticky odstranit z dokumentu.

Text

Získá nebo nastaví text v ComboBoxContentControl .

Title

Získá nebo nastaví název ComboBoxContentControl .

XMLMapping

Získá XMLMapping , který představuje vazbu mezi ComboBoxContentControl elementem a v vlastní části XML.

Metody

Copy()

Zkopíruje ComboBoxContentControl z dokumentu do schránky.

Cut()

Odebere ComboBoxContentControl z dokumentu a přidá ho do schránky.

Delete(Boolean)

Odstraní dynamicky vytvořený ovládací prvek obsahu z dokumentu a odebere ho z v ControlCollection dokumentu.

(Zděděno od ContentControlBase)
SetPlaceholderText(BuildingBlock, Range, String)

Zobrazí text, který se nachází v T:Microsoft.Office.Interop.Word.BuildingBlock, Range nebo jako zástupný text v ComboBoxContentControl .

Události

Added

Vyvolá se po přidání ovládacího prvku Content do dokumentu.

(Zděděno od ContentControlBase)
BindingContextChanged

Vyvolá se při BindingContext změně hodnoty vlastnosti ContentControlBase .

(Zděděno od ContentControlBase)
ContentUpdating

Nastane těsně před tím, než systém Microsoft Office Word aktualizuje text v ovládacím prvku obsahu, pokud je ovládací prvek obsahu vázaný na vlastní část XML.

(Zděděno od ContentControlBase)
Deleting

Nastane bezprostředně před odstraněním ovládacího prvku obsahu z dokumentu.

(Zděděno od ContentControlBase)
Entering

Vyvolá se v případě, že uživatel klikne v ovládacím prvku obsahu nebo když je kurzor přesunut do ovládacího prvku obsahu programově.

(Zděděno od ContentControlBase)
Exiting

Vyvolá se v případě, že uživatel klikne mimo ovládací prvek obsahu nebo když se kurzor přesune mimo ovládací prvek obsahu programově.

(Zděděno od ContentControlBase)
StoreUpdating

Nastane těsně před tím, než systém Microsoft Office Word aktualizuje data ve vlastní části XML, která je svázána s ovládacím prvkem obsahu (to znamená po změně textu v ovládacím prvku Content Control).

(Zděděno od ContentControlBase)
Validated

Vyvolá se v případě, že byl ovládací prvek obsahu úspěšně ověřen.

(Zděděno od ContentControlBase)
Validating

Vyvolá se při ověřování obsahu ovládacího prvku obsahu.

(Zděděno od ContentControlBase)

Platí pro