ComboBoxContentControl Rozhraní

Reference

Definice

Obor názvů:: Microsoft.Office.Tools.Word

Sestavení:: Microsoft.Office.Tools.Word.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Představuje pole se seznamem v dokumentu.

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

Atributy: GuidAttribute

Implementuje: ContentControlBase IComponent ISupportInitialize IDisposable IBindableComponent

Příklady

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

Tato verze je pro přizpůsobení na úrovni dokumentu. Pokud chcete tento kód použít, vložte ho ThisDocument do třídy v projektu a volejte metodu AddComboBoxControlAtSelectionThisDocument_Startup z 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. Pokud chcete tento kód použít, vložte ho ThisAddIn do třídy v projektu a volejte metodu AddComboBoxControlAtSelectionThisAddIn_Startup z 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

Zobrazí ComboBoxContentControl seznam položek, které můžou uživatelé vybrat. Uživatelé můžou také zadat vlastní text v ComboBoxContentControlsouboru .

Pokud chcete zobrazit rozevírací seznam položek v textovém poli, které uživatelé nemůžou DropDownListContentControlupravovat, použijte .

Chcete-li získat přístup k seznamu položek v objektu 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 přehled modulu Visual Studio Tools for Office Runtime.

Ovládací prvky obsahu

Je ComboBoxContentControl jedním z osmi typů ovládacích prvků obsahu, které můžete použít k návrhu dokumentů a šablon v 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 v projektech, které cílí na rozhraní .NET Framework 3.5, naleznete v následující referenční části v dokumentaci k sadě Visual Studio 2008: http://go.microsoft.com/fwlink/?LinkId=160658.

Vlastnosti

Application	Získá, Application který představuje aktuální instanci Microsoft Office Word.
Container	Představuje pole se seznamem v dokumentu. (Zděděno od ContentControlBase)
ContainerComponent	Představuje pole se seznamem v dokumentu. (Zděděno od ContentControlBase)
Creator	Získá 32bitové celé číslo, které označuje aplikaci, ve které ComboBoxContentControl byl vytvořen.
DefaultDataSourceUpdateMode	Získá nebo nastaví výchozí DataSourceUpdateMode hodnotu 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 objektem ComboBoxContentControl.
ID	Získá jedinečné číslo, které identifikuje 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á 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 upravit.
MultiLine	Získá nebo nastaví hodnotu, která určuje, zda ComboBoxContentControl může obsahovat konce řádků.
Parent	Získá nadřazený objekt .ComboBoxContentControl
ParentContentControl	Získá nadřazený obsah ovládací prvek ComboBoxContentControl , který je vnořený v jiném ovládacím prvku obsahu.
PlaceholderText	Získá nebo nastaví text, který je zobrazen v ComboBoxContentControl , dokud se text nezmění akcí uživatele nebo jinou operací.
Range	Získá objekt Range , který představuje obsah objektu ComboBoxContentControl.
ShowingPlaceholderText	Získá hodnotu, která označuje, zda ComboBoxContentControl je aktuálně zobrazen zástupný text.
Tag	Získá nebo nastaví řetězec, který chcete přidružit k ComboBoxContentControl.
Temporary	Získá nebo nastaví hodnotu, která určuje, zda ComboBoxContentControl je automaticky odstraněn z dokumentu při úpravě ovládacího prvku.
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 a element ve vlastní xml části.

Metody

Copy()	Zkopíruje ComboBoxContentControl soubor z dokumentu do schránky.
Cut()	Odebere ComboBoxContentControl objekt z dokumentu a přidá ho do schránky.
Delete(Boolean)	Odstraní dynamicky vytvořený ovládací prvek obsahu z dokumentu a odebere ho ControlCollection z dokumentu. (Zděděno od ContentControlBase)
SetPlaceholderText(BuildingBlock, Range, String)	Zobrazí text, který je v T:Microsoft.Office.Interop. Word. BuildingBlock, Rangenebo řetězec jako zástupný text v objektu ComboBoxContentControl.

Událost

Added	Nastane po přidání ovládacího prvku obsahu do dokumentu. (Zděděno od ContentControlBase)
BindingContextChanged	Nastane, když se BindingContext hodnota vlastnosti ContentControlBase změní. (Zděděno od ContentControlBase)
ContentUpdating	Nastane těsně před microsoft office Word aktualizuje text v ovládacím prvku obsahu, pokud je ovládací prvek obsahu vázán na vlastní část XML. (Zděděno od ContentControlBase)
Deleting	Nastane těsně před odstraněním ovládacího prvku obsahu z dokumentu. (Zděděno od ContentControlBase)
Entering	Nastane, když uživatel klikne na ovládací prvek obsahu nebo když je kurzor přesunut do ovládacího prvku obsahu programově. (Zděděno od ContentControlBase)
Exiting	Nastane, když uživatel klikne mimo ovládací prvek obsahu nebo když je kurzor přesunut mimo ovládací prvek obsahu prostřednictvím kódu programu. (Zděděno od ContentControlBase)
StoreUpdating	Probíhá těsně před aktualizací microsoft Office Word data ve vlastní části XML, která je vázána na ovládací prvek obsahu (to znamená po změně textu v ovládacím prvku obsahu). (Zděděno od ContentControlBase)
Validated	Nastane, když byl ovládací prvek obsahu úspěšně ověřen. (Zděděno od ContentControlBase)
Validating	Nastane při ověřování obsahu obsahu. (Zděděno od ContentControlBase)

Platí pro

Sdílet prostřednictvím