DropDownListContentControl – rozhraní

Článek
08/11/2011

Představuje rozevíracího seznamu v dokumentu.

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

Syntaxe

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

Vlastnosti

	Název	Popis
	Application	Získává Microsoft.Office.Interop.Word.Application , představuje aktuální instance aplikace Word systém Microsoft Office .
	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	32Bitové integer označující, ve kterém aplikace získává DropDownListContentControl byl vytvořen.
	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 pro ContentControlBase. (Zděděno z ContentControlBase.)
	DefaultTextStyle	Získá název znakový styl, který se používá k formátování textu DropDownListContentControl.
	DropDownListEntries	Získá kolekce položek zobrazených DropDownListContentControl.
	ID	Získá jedinečné číslo identifikující obsah ovládacího prvku. (Zděděno z ContentControlBase.)
	InnerObject	Získá základní Microsoft.Office.Interop.Word.ContentControlproobjekt Microsoft.Office.Tools.Word.ContentControlBase. (Zděděno z ContentControlBase.)
	LockContentControl	Získá nebo nastaví hodnotu, která určuje, zda DropDownListContentControl lze odstranit z dokumentu.
	LockContents	Získá nebo nastaví hodnotu, která určuje, zda obsah DropDownListContentControl mohou být upravovány.
	MultiLine	Získá nebo nastaví hodnotu, která určuje, zda DropDownListContentControl mohou obsahovat zalomení řádku.
	Parent	Rodiče získává DropDownListContentControl.
	ParentContentControl	Získá kontrolu obsahu nadřazeného DropDownListContentControl který je vnořen do jiného obsahu ovládacího prvku.
	PlaceholderText	Získá nebo nastaví text, který se zobrazí DropDownListContentControl dokud změněn akce uživatele nebo některé jiné operace.
	Range	Získává Range , představuje obsah DropDownListContentControl.
	ShowingPlaceholderText	Získá hodnotu označující, zda DropDownListContentControl aktuálně 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 DropDownListContentControl.
	Temporary	Získá nebo nastaví hodnotu, která určuje, zda DropDownListContentControl je automaticky odstraněn z dokumentu po úpravě ovládací.
	Text	Získá v textu DropDownListContentControl.
	Title	Získá nebo nastaví název DropDownListContentControl.
	XMLMapping	Získává XMLMapping , představuje vazbu mezi DropDownListContentControl a prvek vlastní XML part.

Na začátek

Metody

	Název	Popis
	BeginInit	Objekt signály spuštění dané inicializace. (Zděděno z ISupportInitialize.)
	Copy	Kopie DropDownListContentControl z dokumentu do schránky.
	Cut	Odebere DropDownListContentControl z dokumentu a přidá jej do schránky.
	Delete	Odstraní prvek dynamicky vytvořený obsah z dokumentu a odebere ji ze ControlCollection v dokumentu. (Zděděno z ContentControlBase.)
	Dispose	Provádí úkoly definované aplikací spojených s uvolněním, uvolnění nebo obnovení nespravované prostředky. (Zděděno z IDisposable.)
	EndInit	Objekt signály že Inicializace byla dokončena. (Zděděno z ISupportInitialize.)
	SetPlaceholderText	Zobrazí text v BuildingBlock, Range, nebo řetězce jako zástupný text DropDownListContentControl.

Na začátek

Události

	Název	Popis
	Added	Vyvolá se po přidání ovládacího prvku obsah do dokumentu. (Zděděno z ContentControlBase.)
	BindingContextChanged	Dochází při hodnotu BindingContext Vlastnost ContentControlBase změny. (Zděděno z ContentControlBase.)
	ContentUpdating	Dojde před aktualizací systém Microsoft Office Word text v ovládacím prvku obsah obsah ovládací prvek vázán na vlastní části jazyk XML . (Zděděno z ContentControlBase.)
	Deleting	Dochází právě před odstraněním ovládacího prvku obsah z dokumentu. (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 klepne v ovládacím prvku obsah nebo kurzor programově přesunuta do ovládacího prvku obsah . (Zděděno z ContentControlBase.)
	Exiting	Dojde, když uživatel klepne mimo kontrolu obsah nebo kurzor programově přesunuta mimo kontrolu obsah . (Zděděno z ContentControlBase.)
	StoreUpdating	Nastane těsně před systém Microsoft Office Word aktualizuje data ve vlastní svázané s obsah jazyk XML části řízení (po text v obsah řízení změn). (Zděděno z ContentControlBase.)
	Validated	Vyvolá se při řízení obsah byl úspěšně ověřen. (Zděděno z ContentControlBase.)
	Validating	Vyvolá se při ověřuje obsah ovládacího prvku obsah . (Zděděno z ContentControlBase.)

Na začátek

Poznámky

A DropDownListContentControl zobrazí seznam položek, mohou uživatelé vybrat.

Přístup k seznamu položek DropDownListContentControl, použít DropDownListEntries vlastnost.

Povolit uživatelům zvolit ze seznamu položek nebo přidat vlastní text ovládacího prvku, použijte ComboBoxContentControl.

Poznámka

Toto rozhraní je implementováno modulem runtime nástrojů Visual Studio Tools for Office. Rozhraní není určeno k implementaci do vašeho kódu. Další informace naleznete v tématu Visual Studio Tools for Office Runtime Overview.

Ovládací prvky obsahu

DropDownListContentControl Je jedním z osmi typů ovládacích prvků obsahu lze navrhnout dokumenty a šablony aplikace Microsoft Office Word. Obsahu mají ovládací prvky uživatel rozhraní (UI), byla řízena vstupní formulář, atd. Ovládací prvky obsah můžete zabránit uživatelům v úpravách chráněné oddíly dokumentu nebo šablonaa svázat ovládací prvky obsah zdroj dat. Další informace naleznete v tématu Content Controls.

Použití

Tato dokumentace popisuje verzi tohoto typu, který je používán v projektech systému Office cílených na rozhraní .NET Framework 4. V projektech cílených na rozhraní .NET Framework 3.5 může mít tento typ rozdílné členy a příklady kódů pro tento typ nemusí fungovat. Dokumentaci k tomuto typu v projektech cílených na rozhraní .NET Framework 3.5 naleznete v následující informační části dokumentace k aplikaci Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.

Příklady

Následující příklad kódu přidá nový DropDownListContentControl na začátku dokumentu. Uživatelé mohou vybrat název dne v týdnu v ovládacím prvku.

Tato verze je přizpůsobení úrovni dokumentu. Tento kód použít, vložte ji do ThisDocument třídy v projektu a volání AddDropDownListControlAtSelection Metoda z ThisDocument_Startup metody.

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

Tato verze je aplikace- doplněkúroveň. Tento kód použít, vložte ji do ThisAddIn třídy v projektu a volání AddDropDownListControlAtSelection Metoda z ThisAddIn_Startup metody.

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