ControlCollection.AddDropDownListContentControl – metoda (Range, String)

Článek
05/14/2013

Přidá novou DropDownListContentControl na zadaný rozsah v dokumentu.

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

Syntaxe

'Deklarace
Function AddDropDownListContentControl ( _
    range As Range, _
    name As String _
) As DropDownListContentControl

DropDownListContentControl AddDropDownListContentControl(
    Range range,
    string name
)

Parametry

range
Typ: Microsoft.Office.Interop.Word.Range
A Range , který poskytuje hranice nového ovládacího prvku.

name
Typ: System.String
Název nového ovládacího prvku.

Vrácená hodnota

Typ: Microsoft.Office.Tools.Word.DropDownListContentControl
DropDownListContentControl , Byl přidán do dokumentu.

Výjimky

Výjimka	Podmínka
ArgumentNullException	nameje nullodkaz null (Nothing v jazyce Visual Basic) nebo má nulovou délku.
ControlNameAlreadyExistsException	Ovládací prvek se stejným názvem je již ControlCollection.

Poznámky

Tuto metodu použijte, chcete-li přidat nový DropDownListContentControl v dané oblasti v dokumentu v době běhu.Další informace naleznete v tématu Přidání ovládacích prvků do dokumentů sady Office v době spuštění.

Příklady

Následující příklad kódu přidá novou DropDownListContentControl na začátek dokumentu.V příkladu přidá také názvy několik dní seznam položek, které mohou uživatelé vybrat v ovládacím prvku.

Tato verze je pro přizpůsobení úroveň dokument.Chcete-li použít tento kód, vložte jej do ThisDocument třídy v projektu a volání AddDropDownListControlAtRange metoda z ThisDocument_Startup metoda.

Dim dropDownListControl2 As Microsoft.Office.Tools.Word.DropDownListContentControl

Private Sub AddDropDownListControlAtRange()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    dropDownListControl2 = Me.Controls.AddDropDownListContentControl(Me.Paragraphs(1).Range, _
        "dropDownListControl2")
    With dropDownListControl2
        .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 dropDownListControl2;

private void AddDropDownListControlAtRange()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();

    dropDownListControl2 = this.Controls.AddDropDownListContentControl(this.Paragraphs[1].Range,
        "dropDownListControl2");
    dropDownListControl2.DropDownListEntries.Add("Monday", "Monday", 0);
    dropDownListControl2.DropDownListEntries.Add("Tuesday", "Tuesday", 1);
    dropDownListControl2.DropDownListEntries.Add("Wednesday", "Wednesday", 2);
    dropDownListControl2.PlaceholderText = "Choose a day";
}

Tato verze je pro úroveň aplikace doplněk který se zaměřuje .NET Framework 4 nebo .NET Framework 4.5.Chcete-li použít tento kód, vložte jej do ThisAddIn třídy v projektu a volání AddDropDownListControlAtRange metoda z ThisAddIn_Startup metoda.

Dim dropDownListControl2 As Microsoft.Office.Tools.Word.DropDownListContentControl

Private Sub AddDropDownListControlAtRange()
    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()
    dropDownListControl2 = vstoDoc.Controls.AddDropDownListContentControl( _
        vstoDoc.Paragraphs(1).Range, _
        "dropDownListControl2")
    With dropDownListControl2
        .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 dropDownListControl2;

private void AddDropDownListControlAtRange()
{
    if (this.Application.ActiveDocument == null)
        return;

    Document vstoDoc = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
    vstoDoc.Paragraphs[1].Range.InsertParagraphBefore();

    dropDownListControl2 = vstoDoc.Controls.AddDropDownListContentControl(
        vstoDoc.Paragraphs[1].Range,
        "dropDownListControl2");
    dropDownListControl2.DropDownListEntries.Add("Monday", "Monday", 0);
    dropDownListControl2.DropDownListEntries.Add("Tuesday", "Tuesday", 1);
    dropDownListControl2.DropDownListEntries.Add("Wednesday", "Wednesday", 2);
    dropDownListControl2.PlaceholderText = "Choose a day";
}

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.