ComboBoxContentControl Classe (sistema de 2007)

Artigo
08/25/2010

Representa uma caixa de combinação em um documento.

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

Sintaxe

<DefaultBindingPropertyAttribute("Text")> _
<PermissionSetAttribute(SecurityAction.Demand, Name := "FullTrust")> _
Public NotInheritable Class ComboBoxContentControl _
    Inherits ContentControlBase _
    Implements ISupportInitializeControl, ISupportInitialize

Dim instance As ComboBoxContentControl

[DefaultBindingPropertyAttribute("Text")]
[PermissionSetAttribute(SecurityAction.Demand, Name = "FullTrust")]
public sealed class ComboBoxContentControl : ContentControlBase, 
    ISupportInitializeControl, ISupportInitialize

Comentários

A ComboBoxContentControl Exibe uma lista de itens que os usuários podem selecionar. Os usuários também podem digitar seu próprio texto em um ComboBoxContentControl.

Para exibir uma lista suspensa de itens em uma caixa de texto que os usuários não podem edição, use um DropDownListContentControl.

Para acesso a lista de itens em um ComboBoxContentControl, use o DropDownListEntries propriedade.

Controles de conteúdo

The ComboBoxContentControl é um dos oito tipos de controles de conteúdo que você pode usar para documentos de design e modelos no Microsoft Office palavra. Conteúdo controles possuem uma interface de usuário (UI) que tem controlada entrada como um formulário.Você pode usar controles de conteúdo para impedir que os usuários editem seções protegidas do documento ou modelo e você também pode BIND controles de conteúdo a uma fonte de dados.Para obter mais informações, consulte Os controles de conteúdo.

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.

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

Hierarquia de herança

System.Object
  Microsoft.VisualStudio.Tools.Office.RemoteComponent
    Microsoft.VisualStudio.Tools.Office.RemoteBindableComponent
      Microsoft.Office.Tools.Word.ContentControlBase
        Microsoft.Office.Tools.Word.ComboBoxContentControl

Acesso thread-safe

Quaisquer membros static (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.