ComboBoxContentControl.DropDownListEntries A propriedade (sistema de 2007)

Artigo
08/25/2010

Obtém a coleção de itens exibidos pelo ComboBoxContentControl.

Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word.v9.0 (em Microsoft.Office.Tools.Word.v9.0.dll)

Sintaxe

<TypeConverterAttribute("Microsoft.VisualStudio.OfficeTools.Word2007.Design.DropDownListConverter, Microsoft.VisualStudio.Tools.Office.Designer.Office2007, Version=9.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")> _
Public ReadOnly Property DropDownListEntries As ContentControlListEntries

Dim instance As ComboBoxContentControl
Dim value As ContentControlListEntries

value = instance.DropDownListEntries

[TypeConverterAttribute("Microsoft.VisualStudio.OfficeTools.Word2007.Design.DropDownListConverter, Microsoft.VisualStudio.Tools.Office.Designer.Office2007, Version=9.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public ContentControlListEntries DropDownListEntries { get; }

Valor de propriedade

Tipo: Microsoft.Office.Interop.Word.ContentControlListEntries
A ContentControlListEntries objeto que contém os itens que são exibidos pela ComboBoxContentControl.

Comentários

Quando você adiciona um ComboBoxContentControl para um documento, ele não contém itens por padrão. Para adicionar itens, use o Add método para o DropDownListEntries propriedade.

Exemplos

O exemplo de código a seguir adiciona um novo ComboBoxContentControl para o início do documento. Os usuários podem selecionar um nome de cor exibido pelo controle, ou eles podem digitar o nome de uma nova cor.Este exemplo usa o DropDownListEntries propriedade para especificar os nomes de cores exibidos pelo controle.

Esta versão é para uma personalização em nível de documento.Para usar esse código, cole-o no ThisDocument classe em seu projeto e a telefonar a AddComboBoxControlAtSelection método a partir do ThisDocument_Startup método.

Dim comboBoxControl1 As Microsoft.Office.Tools.Word.ComboBoxContentControl

PrivateSub 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"EndWithEndSub

private Microsoft.Office.Tools.Word.ComboBoxContentControl comboBoxControl1;

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

Esta versão é para um suplemento no nível de aplicativo.Para usar esse código, cole-o no ThisAddIn classe em seu projeto e a telefonar a AddComboBoxControlAtSelection método a partir do ThisAddIn_Startup método.

Dim comboBoxControl1 As Microsoft.Office.Tools.Word.ComboBoxContentControl

PrivateSub AddComboBoxControlAtSelection()
    IfMe.Application.ActiveDocument IsNothingThenReturnEndIfDim vstoDoc As Document = Me.Application.ActiveDocument.GetVstoObject()
    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"EndWithEndSub

private Microsoft.Office.Tools.Word.ComboBoxContentControl comboBoxControl1;

privatevoid AddComboBoxControlAtSelection()
{
    if (this.Application.ActiveDocument == null)
        return;

    Document vstoDoc = this.Application.ActiveDocument.GetVstoObject();
    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";            
}

Permissões

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de códigos parcialmente Confiável.

Consulte também

Referência

ComboBoxContentControl Classe

Membros ComboBoxContentControl

Namespace Microsoft.Office.Tools.Word

Partilhar via