ComboBoxContentControl – rozhraní

Článek
01/03/2014

Představuje seznamem v dokumentu.

Obor názvů: Microsoft.Office.Tools.Word
Sestavení: Microsoft.Office.Tools.Word (v Microsoft.Office.Tools.Word.dll)

Syntaxe

'Deklarace
<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 zveřejňuje následující členy.

Vlastnosti

	Název	Popis
	Application	Získá Microsoft.Office.Interop.Word.Application , která představuje aktuální instance aplikace Microsoft Office Word.
	BindingContext	Získá nebo nastaví kolekce vedoucích měny IBindableComponent. (Zděděno z IBindableComponent.)
	Container	Infrastruktura. (Zděděno z ContentControlBase.)
	ContainerComponent	Infrastruktura. (Zděděno z ContentControlBase.)
	Creator	Získá 32bitové celé číslo, označující aplikaci, ve které ComboBoxContentControl byla vytvořena.
	DataBindings	Získá kolekci objektů vázání dat pro tento IBindableComponent. (Zděděno z IBindableComponent.)
	DefaultDataSourceUpdateMode	Získá nebo nastaví výchozí DataSourceUpdateMode k ContentControlBase. (Zděděno z ContentControlBase.)
	DefaultTextStyle	Získá název znakového stylu, který se používá k formátování textu v ComboBoxContentControl.
	DropDownListEntries	Získá kolekce položek, které jsou zobrazeny ComboBoxContentControl.
	ID	Získá jedinečné číslo, které identifikuje ovládací prvek obsahu. (Zděděno z ContentControlBase.)
	InnerObject	Získá základní Microsoft.Office.Interop.Word.ContentControl pro objekt Microsoft.Office.Tools.Word.ContentControlBase. (Zděděno z ContentControlBase.)
	LockContentControl	Získá nebo nastaví hodnotu, která určuje, zda ComboBoxContentControl lze odstranit z dokumentu.
	LockContents	Získá nebo nastaví hodnotu, která určuje, zda obsah ComboBoxContentControl lze upravovat.
	MultiLine	Získá nebo nastaví hodnotu, která určuje, zda ComboBoxContentControl může obsahovat zalomení řádků.
	Parent	Načte nadřazený ComboBoxContentControl.
	ParentContentControl	Získá obsah nadřazeného řízení ComboBoxContentControl který je vnořen do jiného ovládacího prvku obsahu.
	PlaceholderText	Získá nebo nastaví text zobrazený v ComboBoxContentControl dokud text se změní akce uživatele nebo jinou operaci.
	Range	Získá Range , která představuje obsah ComboBoxContentControl.
	ShowingPlaceholderText	Získá hodnotu, která označuje, zda ComboBoxContentControl zobrazuje zástupný text.
	Site	Získá nebo nastaví ISite přidružené IComponent. (Zděděno z IComponent.)
	Tag	Získá nebo nastaví řetězec, který chcete přidružit ComboBoxContentControl.
	Temporary	Získá nebo nastaví hodnotu, která určuje, zda ComboBoxContentControl když upravíte ovládací prvek je automaticky odstraněn z dokumentu.
	Text	Získá nebo nastaví text v ComboBoxContentControl.
	Title	Získá nebo nastaví název ComboBoxContentControl.
	XMLMapping	Získá Microsoft.Office.Interop.Word.XMLMapping , který představuje vazbu mezi ComboBoxContentControl a prvek vlastní části XML.

Nahoru

Metody

	Název	Popis
	BeginInit	Signály objekt spouštění dané inicializace. (Zděděno z ISupportInitialize.)
	Copy	Kopie ComboBoxContentControl z dokumentu do schránky.
	Cut	Odebere ComboBoxContentControl z dokumentu a přidá jej do schránky.
	Delete	Odstraní dynamicky vytvořený ovládací prvek obsahu z dokumentu a odebere ji z ControlCollection v dokumentu. (Zděděno z ContentControlBase.)
	Dispose	Provádí úkoly definované aplikací, které jsou spojeny s uvolněním nebo obnovením nespravovaných prostředků. (Zděděno z IDisposable.)
	EndInit	Signály objekt inicializace, že je dokončena. (Zděděno z ISupportInitialize.)
	SetPlaceholderText	Zobrazí text, který je T:Microsoft.Office.Interop.Word.BuildingBlock, Range, nebo řetězec jako zástupný text ComboBoxContentControl.

Nahoru

Události

	Název	Popis
	Added	Vyvolá se po přidání ovládacího prvku obsahu do dokumentu. (Zděděno z ContentControlBase.)
	BindingContextChanged	Dochází při hodnotu BindingContext vlastnost ContentControlBase změny. (Zděděno z ContentControlBase.)
	ContentUpdating	Nastane těsně před aktualizací aplikace Microsoft Office Word text v ovládacím prvku obsahu, pokud vlastní části XML je vázán ovládací prvek obsahu. (Zděděno z ContentControlBase.)
	Deleting	Nastane těsně před ovládací prvek obsahu z dokumentu odstraněn. (Zděděno z ContentControlBase.)
	Disposed	Představuje metodu, která zpracovává Disposed události komponenty. (Zděděno z IComponent.)
	Entering	Dojde, když uživatel klikne na ovládací prvek obsahu nebo když je kurzor přesunut na ovládací prvek obsahu programově. (Zděděno z ContentControlBase.)
	Exiting	Vyvolá se při kliknutí na tlačítko mimo ovládací prvek obsahu, nebo pokud je kurzor přesunut mimo ovládací prvek obsahu programově. (Zděděno z ContentControlBase.)
	StoreUpdating	Dojde bezprostředně před aplikace Microsoft Office Word aktualizuje data ve vlastní části XML, který je vázán na obsah ovládacího prvku (po textu v obsahu řízení změn). (Zděděno z ContentControlBase.)
	Validated	Vyvolá se v případě úspěšně ověřen na ovládací prvek obsahu. (Zděděno z ContentControlBase.)
	Validating	Vyvolá se v případě ověřuje obsah ovládacího prvku obsahu. (Zděděno z ContentControlBase.)

Nahoru

Poznámky

A ComboBoxContentControl zobrazí seznam položek, které mohou uživatelé vybrat.Uživatelům můžete také zadat vlastní text ComboBoxContentControl.

Zobrazení rozevíracího seznamu položek v textové pole, které uživatelé nemohou upravovat, použít DropDownListContentControl.

Přístup k seznamu položek v ComboBoxContentControl, použít 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 naleznete v tématu Přehled nástrojů Visual Studio Tools for Office runtime.

Ovládací prvky obsahu

ComboBoxContentControl Je jedním z osmi typů ovládací prvky, které slouží k návrhu dokumenty a šablony aplikace Microsoft Office Word.Obsahu, že ovládací prvky uživatelského rozhraní (UI), je řízen vstupní formulář.Ovládací prvky obsahu můžete uživatelům zabránit v provádění úprav chráněné oddíly dokumentu nebo šablony a zdroje dat můžete také navázat ovládací prvky obsahu.Další informace naleznete v tématu Ovládací prvky obsahu.

Použití

Tato dokumentace popisuje verzi tohoto typu, který je používán v projektech systému Office cílených pro rozhraní .NET Framework 4 a .NET Framework 4.5. 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 na rozhraní .NET Framework 3.5 naleznete v následující informační části dokumentace k sadě Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.

Příklady

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

Tato verze je pro vlastní úpravy úrovni dokumentu.Tento kód použít, vložte jej do ThisDocument třídy v projektu a volání AddComboBoxControlAtSelection metoda 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";
}

Tato verze je aplikace úroveň doplněk.Tento kód použít, vložte jej do ThisAddIn třídy v projektu a volání AddComboBoxControlAtSelection metoda 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";            
}