ComboBoxContentControl Interface

Referência

Definição

Namespace:: Microsoft.Office.Tools.Word

Assembly:: Microsoft.Office.Tools.Word.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

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

Atributos: GuidAttribute

Implementações: ContentControlBase IComponent ISupportInitialize IDisposable IBindableComponent

Exemplos

O exemplo de código a seguir adiciona um novo ComboBoxContentControl ao início do documento. Os usuários podem selecionar um nome de cor exibido pelo controle ou podem digitar o nome de uma nova cor.

Esta versão destina-se a uma personalização no nível de documento. Para usar esse código, cole-o na classe ThisDocument do projeto e chame o método AddComboBoxControlAtSelection no método ThisDocument_Startup.

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

Esta versão destina-se a um suplemento no nível de aplicativo. Para usar esse código, cole-o na classe ThisAddIn do projeto e chame o método AddComboBoxControlAtSelection no método ThisAddIn_Startup.

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

Comentários

Um 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 editar, use um DropDownListContentControl.

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

Observação

Essa interface é implementada pelo Visual Studio Tools for Office Runtime. Ela não se destina a ser implementada em seu código. Para obter mais informações, consulte Visão geral do Visual Studio Tools para Office Runtime.

Controles de conteúdo

O ComboBoxContentControl é um dos oito tipos de controles de conteúdo que você pode usar para criar documentos e modelos no Microsoft Office Word. Os controles de conteúdo têm uma interface do usuário que tem uma entrada controlada como um formulário. É possível usar controles de conteúdo para impedir que usuários editem seções protegidas do documento ou do modelo, além de também associar controles de conteúdo a uma fonte de dados. Para obter mais informações, consulte Controles de conteúdo.

Uso

Essa documentação descreve a versão desse tipo que é usada nos projetos do Office direcionados ao .NET Framework 4 ou posterior. Em projetos direcionados ao .NET Framework 3.5, esse tipo pode ter membros diferentes e os exemplos de código fornecidos para este tipo talvez não funcionem. Conheça a documentação sobre este tipo em projetos direcionados ao .NET Framework 3.5 na seguinte seção de referência na documentação do Visual Studio 2008: http://go.microsoft.com/fwlink/?LinkId=160658.

Propriedades

Application	Obtém um Application que representa a instância atual do Microsoft Office Word.
Container	Representa uma caixa de combinação em um documento. (Herdado de ContentControlBase)
ContainerComponent	Representa uma caixa de combinação em um documento. (Herdado de ContentControlBase)
Creator	Obtém um inteiro de 32 bits que indica o aplicativo no qual o ComboBoxContentControl foi criado.
DefaultDataSourceUpdateMode	Obtém ou define o padrão DataSourceUpdateMode para o ContentControlBase. (Herdado de ContentControlBase)
DefaultTextStyle	Obtém o nome do estilo de caractere usado para formatar o texto no ComboBoxContentControl.
DropDownListEntries	Obtém a coleção de itens exibidos pelo ComboBoxContentControl.
ID	Obtém um número exclusivo que identifica o controle do conteúdo. (Herdado de ContentControlBase)
InnerObject	Obtém o objeto ContentControl subjacente para o ContentControlBase. (Herdado de ContentControlBase)
LockContentControl	Obtém ou define um valor que especifica se o ComboBoxContentControl pode ser excluído do documento.
LockContents	Obtém ou define um valor que especifica se o conteúdo do ComboBoxContentControl pode ser editado.
MultiLine	Obtém ou define um valor que especifica se o ComboBoxContentControl pode conter quebras de linha.
Parent	Obtém o pai do ComboBoxContentControl.
ParentContentControl	Obtém o controle de conteúdo pai de um ComboBoxContentControl aninhado em outro controle de conteúdo.
PlaceholderText	Obtém ou define o texto exibido no ComboBoxContentControl até que ele seja alterado por uma ação do usuário ou por outra operação.
Range	Obtém um Range que representa o conteúdo de ComboBoxContentControl.
ShowingPlaceholderText	Obtém um valor que indica se o ComboBoxContentControl está exibindo o texto do espaço reservado no momento.
Tag	Obtém ou define uma cadeia de caracteres que você deseja associar ao ComboBoxContentControl.
Temporary	Obtém ou define um valor que especifica se o ComboBoxContentControl será excluído automaticamente do documento quando o controle for editado.
Text	Obtém ou define o texto no ComboBoxContentControl.
Title	Obtém ou define o título do ComboBoxContentControl.
XMLMapping	Obtém um XMLMapping que representa a associação entre o ComboBoxContentControl e um elemento em uma parte XML personalizada.

Métodos

Copy()	Copia o ComboBoxContentControl do documento para a Área de Transferência.
Cut()	Remove o ComboBoxContentControl do documento e o adiciona à Área de Transferência.
Delete(Boolean)	Exclui um controle de conteúdo criado dinamicamente do documento e o remove do ControlCollection no documento. (Herdado de ContentControlBase)
SetPlaceholderText(BuildingBlock, Range, String)	Exibe o texto que está em um T:Microsoft.Office.Interop. Word. BuildingBlock, um Rangeou uma cadeia de caracteres como o texto de espaço reservado no ComboBoxContentControl.

Eventos

Added	Ocorre após a adição do controle de conteúdo ao documento. (Herdado de ContentControlBase)
BindingContextChanged	Ocorre quando o valor da propriedade BindingContext do ContentControlBase é alterado. (Herdado de ContentControlBase)
ContentUpdating	Ocorrerá logo antes de o Microsoft Office Word atualizar o texto em um controle de conteúdo, se o controle de conteúdo estiver associado a uma parte XML personalizada. (Herdado de ContentControlBase)
Deleting	Ocorre imediatamente antes da exclusão do controle de conteúdo do documento. (Herdado de ContentControlBase)
Entering	Ocorre quando o usuário clica no controle de conteúdo ou o cursor é movido programaticamente para o controle de conteúdo. (Herdado de ContentControlBase)
Exiting	Ocorre quando o usuário clica fora do controle de conteúdo ou quando o cursor é movido para fora do controle de conteúdo programaticamente. (Herdado de ContentControlBase)
StoreUpdating	Ocorrerá imediatamente antes de o Microsoft Office Word atualizar os dados em uma parte XML personalizada vinculada ao controle de conteúdo (ou seja, depois que o texto no controle de conteúdo for alterado). (Herdado de ContentControlBase)
Validated	Ocorre quando o controle de conteúdo for validado com êxito. (Herdado de ContentControlBase)
Validating	Ocorre quando os conteúdos do controle de conteúdo estão sendo validados. (Herdado de ContentControlBase)

Aplica-se a

Compartilhar via