ControlCollection.AddDropDownListContentControl Yöntem

Başvuru

Tanım

Ad Alanı:: Microsoft.Office.Tools.Word

Bütünleştirilmiş Kodlar:: Microsoft.Office.Tools.Word.dll, Microsoft.Office.Tools.Word.v4.0.Utilities.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Aşırı Yüklemeler

AddDropDownListContentControl(String)	Belgedeki geçerli seçime yeni DropDownListContentControl bir ekler.
AddDropDownListContentControl(ContentControl, String)	Koleksiyona yeni DropDownListContentControl bir ekler. Yeni denetim, belgede zaten var olan yerel içerik denetimine dayalıdır.
AddDropDownListContentControl(Range, String)	Belgede belirtilen aralıkta yeni DropDownListContentControl bir ekler.

AddDropDownListContentControl(String)

Belgedeki geçerli seçime yeni DropDownListContentControl bir ekler.

public:
 Microsoft::Office::Tools::Word::DropDownListContentControl ^ AddDropDownListContentControl(System::String ^ name);

public Microsoft.Office.Tools.Word.DropDownListContentControl AddDropDownListContentControl (string name);

abstract member AddDropDownListContentControl : string -> Microsoft.Office.Tools.Word.DropDownListContentControl

Public Function AddDropDownListContentControl (name As String) As DropDownListContentControl

Parametreler

name: String

Yeni denetimin adı.

Döndürülenler

DropDownListContentControl

Belgeye DropDownListContentControl eklenen.

Özel durumlar

ArgumentNullException

name veya null uzunluğu sıfırdır.

ControlNameAlreadyExistsException

Aynı ada sahip bir denetim zaten içindedir ControlCollection.

Örnekler

Aşağıdaki kod örneği, belgenin başına yeni DropDownListContentControl bir ekler. Örnek, kullanıcıların denetimde seçebileceği öğeler listesine birkaç günün adlarını da ekler.

Bu sürüm, belge düzeyinde özelleştirme içindir. Bu kodu kullanmak için, bunu projenizdeki sınıfına ThisDocument yapıştırın ve yönteminden yöntemini çağırın AddDropDownListControlAtSelectionThisDocument_Startup .

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

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

Bu sürüm, .NET Framework 4 veya .NET Framework 4.5'i hedefleyen bir uygulama düzeyi eklentisi içindir. Bu kodu kullanmak için, bunu projenizdeki sınıfına ThisAddIn yapıştırın ve yönteminden yöntemini çağırın AddDropDownListControlAtSelectionThisAddIn_Startup .

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

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

Açıklamalar

Çalışma zamanında belgedeki geçerli seçime yeni DropDownListContentControl bir eklemek için bu yöntemi kullanın. Daha fazla bilgi için bkz. Çalışma Zamanında Office Belgelerine Denetim Ekleme.

Şunlara uygulanır

AddDropDownListContentControl(ContentControl, String)

Koleksiyona yeni DropDownListContentControl bir ekler. Yeni denetim, belgede zaten var olan yerel içerik denetimine dayalıdır.

public:
 Microsoft::Office::Tools::Word::DropDownListContentControl ^ AddDropDownListContentControl(Microsoft::Office::Interop::Word::ContentControl ^ contentControl, System::String ^ name);

public Microsoft.Office.Tools.Word.DropDownListContentControl AddDropDownListContentControl (Microsoft.Office.Interop.Word.ContentControl contentControl, string name);

abstract member AddDropDownListContentControl : Microsoft.Office.Interop.Word.ContentControl * string -> Microsoft.Office.Tools.Word.DropDownListContentControl

Public Function AddDropDownListContentControl (contentControl As ContentControl, name As String) As DropDownListContentControl

Parametreler

contentControl: ContentControl

ContentControl Bu, yeni denetimin temelini oluşturur.

name: String

Yeni denetimin adı.

Döndürülenler

DropDownListContentControl

Belgeye DropDownListContentControl eklenen.

Özel durumlar

ArgumentNullException

contentControl is null.-or- name is null or has zero length.

ControlNameAlreadyExistsException

Aynı ada sahip bir denetim zaten içindedir ControlCollection.

ArgumentException

contentControlbir yapı taşı galerisi değildir (yani özelliği TypecontentControl Microsoft.Office.Interop.Word değerine sahip değildir. WdContentControlType.wdContentControlDropdownList).

Örnekler

Aşağıdaki kod örneği, belgedeki her yerel açılan liste için yeni DropDownListContentControl bir oluşturur.

Bu sürüm, belge düzeyinde özelleştirme içindir. Bu kodu kullanmak için, bunu projenizdeki sınıfına ThisDocument yapıştırın ve yönteminden yöntemini çağırın CreateDropDownListControlsFromNativeControlsThisDocument_Startup .

private System.Collections.Generic.List
    <Microsoft.Office.Tools.Word.DropDownListContentControl> dropDownControls;

private void CreateDropDownListControlsFromNativeControls()
{
    if (this.ContentControls.Count <= 0)
        return;

    dropDownControls = new System.Collections.Generic.List
        <Microsoft.Office.Tools.Word.DropDownListContentControl>();
    int count = 0;

    foreach (Word.ContentControl nativeControl in this.ContentControls)
    {
        if (nativeControl.Type == Word.WdContentControlType.wdContentControlDropdownList)
        {
            count++;
            Microsoft.Office.Tools.Word.DropDownListContentControl tempControl =
                this.Controls.AddDropDownListContentControl(nativeControl,
                "VSTODropDownListContentControl" + count.ToString());
            dropDownControls.Add(tempControl);
        }
    }
}

Private dropDownListControls As New System.Collections.Generic.List _
        (Of Microsoft.Office.Tools.Word.DropDownListContentControl)

Private Sub CreateDropDownListControlsFromNativeControls()
    If Me.ContentControls.Count <= 0 Then
        Return
    End If

    Dim count As Integer = 0
    For Each nativeControl As Word.ContentControl In Me.ContentControls
        If nativeControl.Type = Word.WdContentControlType.wdContentControlDropdownList Then
            count += 1
            Dim tempControl As Microsoft.Office.Tools.Word.DropDownListContentControl = _
                Me.Controls.AddDropDownListContentControl(nativeControl, _
                "VSTODropDownListContentControl" + count.ToString())
            dropDownListControls.Add(tempControl)
        End If
    Next nativeControl
End Sub

Bu sürüm, .NET Framework 4 veya .NET Framework 4.5'i hedefleyen bir uygulama düzeyi eklentisi içindir. Bu kodu kullanmak için eklenti projenizdeki sınıfına ThisAddIn yapıştırın ve yönteminden yöntemini çağırın CreateDropDownListControlsFromNativeControlsThisAddIn_Startup .

private System.Collections.Generic.List
    <Microsoft.Office.Tools.Word.DropDownListContentControl> dropDownControls;

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

    Document vstoDoc = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
    if (vstoDoc.ContentControls.Count <= 0)
        return;

    dropDownControls = new System.Collections.Generic.List
        <Microsoft.Office.Tools.Word.DropDownListContentControl>();
    int count = 0;

    foreach (Word.ContentControl nativeControl in vstoDoc.ContentControls)
    {
        if (nativeControl.Type == Word.WdContentControlType.wdContentControlDropdownList)
        {
            count++;
            Microsoft.Office.Tools.Word.DropDownListContentControl tempControl =
                vstoDoc.Controls.AddDropDownListContentControl(nativeControl,
                "VSTODropDownListContentControl" + count.ToString());
            dropDownControls.Add(tempControl);
        }
    }
}

Private dropDownListControls As New System.Collections.Generic.List _
        (Of Microsoft.Office.Tools.Word.DropDownListContentControl)

Private Sub CreateDropDownListControlsFromNativeControls()
    If Me.Application.ActiveDocument Is Nothing Then
        Return
    End If

    Dim vstoDoc As Document = Globals.Factory.GetVstoObject(Me.Application.ActiveDocument)
    If vstoDoc.ContentControls.Count <= 0 Then
        Return
    End If

    Dim count As Integer = 0
    For Each nativeControl As Word.ContentControl In vstoDoc.ContentControls
        If nativeControl.Type = Word.WdContentControlType.wdContentControlDropdownList Then
            count += 1
            Dim tempControl As Microsoft.Office.Tools.Word.DropDownListContentControl = _
                vstoDoc.Controls.AddDropDownListContentControl(nativeControl, _
                "VSTODropDownListContentControl" + count.ToString())
            dropDownListControls.Add(tempControl)
        End If
    Next nativeControl
End Sub

Aşağıdaki kod örneği, kullanıcının belgeye eklediği her yerel açılan liste için yeni DropDownListContentControl bir oluşturur.

Bu sürüm, belge düzeyinde özelleştirme içindir. Bu kodu kullanmak için projenizdeki sınıfına ThisDocument yapıştırın. C# için, olay işleyicisini ThisDocument_DropDownListContentControlAfterAdd sınıfının olayına ContentControlAfterAddThisDocument da eklemeniz gerekir.

void ThisDocument_DropDownListContentControlAfterAdd(Word.ContentControl NewContentControl, bool InUndoRedo)
{
    if (NewContentControl.Type == Word.WdContentControlType.wdContentControlDropdownList)
    {
        this.Controls.AddDropDownListContentControl(NewContentControl,
            "DropDownListControl" + NewContentControl.ID);
    }
}

Private Sub ThisDocument_DropDownListContentControlAfterAdd(ByVal NewContentControl As Word.ContentControl, _
    ByVal InUndoRedo As Boolean) Handles Me.ContentControlAfterAdd

    If NewContentControl.Type = Word.WdContentControlType.wdContentControlDropdownList Then
        Me.Controls.AddDropDownListContentControl(NewContentControl, _
            "DropDownListControl" + NewContentControl.ID)
    End If
End Sub

Bu sürüm, .NET Framework 4 veya .NET Framework 4.5'i hedefleyen bir uygulama düzeyi eklentisi içindir. Bu kodu kullanmak için projenizdeki sınıfına ThisAddIn yapıştırın. Ayrıca, olay işleyicisini ActiveDocument_DropDownListContentControlAfterAdd etkin belgenin ContentControlAfterAdd olayına eklemeniz gerekir.

void ActiveDocument_DropDownListContentControlAfterAdd(
    Word.ContentControl NewContentControl, bool InUndoRedo)
{
    Document vstoDoc = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
    if (NewContentControl.Type == Word.WdContentControlType.wdContentControlDropdownList)
    {
        vstoDoc.Controls.AddDropDownListContentControl(NewContentControl,
            "DropDownListControl" + NewContentControl.ID);
    }
}

Private Sub ActiveDocument_DropDownListContentControlAfterAdd( _
    ByVal NewContentControl As Word.ContentControl, _
    ByVal InUndoRedo As Boolean)

    Dim vstoDoc As Document = Globals.Factory.GetVstoObject(Me.Application.ActiveDocument)
    If NewContentControl.Type = Word.WdContentControlType. _
        wdContentControlDropdownList Then
        vstoDoc.Controls.AddDropDownListContentControl(NewContentControl, _
            "DropDownListControl" + NewContentControl.ID)
    End If
End Sub

Açıklamalar

Çalışma zamanında belgedeki yerel içerik denetimini temel alan yeni DropDownListContentControl bir eklemek için bu yöntemi kullanın. Bu, çalışma zamanında bir DropDownListContentControl oluşturduğunuzda ve belgenin bir sonraki açılışında aynı denetimi yeniden oluşturmak istediğinizde kullanışlıdır. Daha fazla bilgi için bkz. Çalışma Zamanında Office Belgelerine Denetim Ekleme.

Şunlara uygulanır

AddDropDownListContentControl(Range, String)

Belgede belirtilen aralıkta yeni DropDownListContentControl bir ekler.

public:
 Microsoft::Office::Tools::Word::DropDownListContentControl ^ AddDropDownListContentControl(Microsoft::Office::Interop::Word::Range ^ range, System::String ^ name);

public Microsoft.Office.Tools.Word.DropDownListContentControl AddDropDownListContentControl (Microsoft.Office.Interop.Word.Range range, string name);

abstract member AddDropDownListContentControl : Microsoft.Office.Interop.Word.Range * string -> Microsoft.Office.Tools.Word.DropDownListContentControl

Public Function AddDropDownListContentControl (range As Range, name As String) As DropDownListContentControl

Parametreler

range: Range

Range Yeni denetim için sınırları sağlayan bir.

name: String

Yeni denetimin adı.

Döndürülenler

DropDownListContentControl

Belgeye DropDownListContentControl eklenen.

Özel durumlar

ArgumentNullException

name veya null uzunluğu sıfırdır.

ControlNameAlreadyExistsException

Aynı ada sahip bir denetim zaten içindedir ControlCollection.

Örnekler

Aşağıdaki kod örneği, belgenin başına yeni DropDownListContentControl bir ekler. Örnek, kullanıcıların denetimde seçebileceği öğeler listesine birkaç günün adlarını da ekler.

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

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()
{
    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";
}

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

Açıklamalar

Çalışma zamanında belgede belirtilen aralıkta yeni DropDownListContentControl bir eklemek için bu yöntemi kullanın. Daha fazla bilgi için bkz. Çalışma Zamanında Office Belgelerine Denetim Ekleme.

Şunlara uygulanır

Aracılığıyla paylaş

ControlCollection.AddDropDownListContentControl Yöntem

Tanım

Aşırı Yüklemeler

AddDropDownListContentControl(String)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Şunlara uygulanır

AddDropDownListContentControl(ContentControl, String)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Şunlara uygulanır

AddDropDownListContentControl(Range, String)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Şunlara uygulanır

Ek kaynaklar