Interface BuildingBlockGalleryContentControl

Artigo
08/01/2011

Representa uma Galeria de blocos de construção de documento que os usuários podem inserir em um documento.

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

Sintaxe

'Declaração
<GuidAttribute("d8d887a2-69fe-4a86-a8dd-352003dc0e7e")> _
Public Interface BuildingBlockGalleryContentControl _
    Inherits ContentControlBase, IBindableComponent, IComponent, IDisposable,  _
    ISupportInitialize

[GuidAttribute("d8d887a2-69fe-4a86-a8dd-352003dc0e7e")]
public interface BuildingBlockGalleryContentControl : ContentControlBase, 
    IBindableComponent, IComponent, IDisposable, ISupportInitialize

O tipo BuildingBlockGalleryContentControl expõe os membros a seguir.

Propriedades

	Nome	Descrição
	Application	Obtém um Microsoft.Office.Interop.Word.Application que representa a instância atual do Word de Microsoft Office.
	BindingContext	Obtém ou define uma coleção dos gerenciadores de moeda para o IBindableComponent. (Herdado de IBindableComponent.)
	BuildingBlockCategory	Obtém ou define a categoria dos blocos de construção que são exibidos na BuildingBlockGalleryContentControl.
	BuildingBlockType	Obtém ou define o tipo dos blocos de construção que são exibidos na BuildingBlockGalleryContentControl.
	Container	Infraestrutura. (Herdado de ContentControlBase.)
	ContainerComponent	Infraestrutura. (Herdado de ContentControlBase.)
	Creator	Obtém um inteiro de 32 bits que indica o aplicativo no qual o BuildingBlockGalleryContentControl foi criado.
	DataBindings	Obtém a coleção de objetos de ligação de dados para este IBindableComponent. (Herdado de IBindableComponent.)
	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 do BuildingBlockGalleryContentControl.
	ID	Obtém um número exclusivo que identifica o controle de conteúdo. (Herdado de ContentControlBase.)
	InnerObject	Obtém a base Microsoft.Office.Interop.Word.ContentControl de objeto para o Microsoft.Office.Tools.Word.ContentControlBase. (Herdado de ContentControlBase.)
	LockContentControl	Obtém ou define um valor que especifica se o BuildingBlockGalleryContentControl pode ser excluído do documento.
	LockContents	Obtém ou define um valor que especifica se o conteúdo da BuildingBlockGalleryContentControl pode ser editado.
	Parent	Obtém o pai do BuildingBlockGalleryContentControl.
	ParentContentControl	Obtém o pai de controle de conteúdo uma BuildingBlockGalleryContentControl que está aninhado em outro controle de conteúdo.
	PlaceholderText	Obtém ou define o texto exibido na BuildingBlockGalleryContentControl até que o texto é alterado por uma ação do usuário ou alguma outra operação.
	Range	Obtém um Range que representa o conteúdo do BuildingBlockGalleryContentControl.
	ShowingPlaceholderText	Obtém um valor que indica se a BuildingBlockGalleryContentControl atualmente está exibindo texto de espaço reservado.
	Site	Obtém ou define o ISite associados a IComponent. (Herdado de IComponent.)
	Tag	Obtém ou define uma seqüência de caracteres que você deseja associar a BuildingBlockGalleryContentControl.
	Temporary	Obtém ou define um valor que especifica se o BuildingBlockGalleryContentControl é excluído automaticamente do documento quando o controle é editado.
	Text	Obtém ou define o texto a BuildingBlockGalleryContentControl.
	Title	Obtém ou define o título da BuildingBlockGalleryContentControl.

Início

Métodos

	Nome	Descrição
	BeginInit	Sinaliza o objeto que a inicialização está iniciando. (Herdado de ISupportInitialize.)
	Copy	Cópias do BuildingBlockGalleryContentControl do documento para a área de transferência.
	Cut	Remove o BuildingBlockGalleryContentControl do documento e o adiciona à área de transferência.
	Delete	Exclui um controle criado dinamicamente do conteúdo do documento e remove a partir do ControlCollection do documento. (Herdado de ContentControlBase.)
	Dispose	Executa tarefas de definição de aplicativo associadas liberando, liberando ou redefinindo recursos não gerenciados. (Herdado de IDisposable.)
	EndInit	Sinaliza o objeto que a inicialização for concluída. (Herdado de ISupportInitialize.)
	SetPlaceholderText	Exibe o texto em um Microsoft.Office.Interop.Word.BuildingBlock, um Range, ou uma seqüência de texto de espaço reservado a BuildingBlockGalleryContentControl.

Início

Eventos

	Nome	Descrição
	Added	Ocorre após o controle de conteúdo é adicionado ao documento. (Herdado de ContentControlBase.)
	BindingContextChanged	Ocorre quando o valor da BindingContext propriedade da ContentControlBase alterações. (Herdado de ContentControlBase.)
	ContentUpdating	Ocorre antes de Microsoft Office o Word atualiza o texto no controle content, se o controle de conteúdo está vinculado a um componente XML personalizado. (Herdado de ContentControlBase.)
	Deleting	Ocorre antes do controle de conteúdo é excluído do documento. (Herdado de ContentControlBase.)
	Disposed	Representa o método que manipula o Disposed o evento de um componente. (Herdado de IComponent.)
	Entering	Ocorre quando o usuário clica no controle content, ou quando o cursor é movido para o controle de conteúdo por meio de programação. (Herdado de ContentControlBase.)
	Exiting	Ocorre quando o usuário clica fora do controle de conteúdo, ou quando o cursor é movido programaticamente fora do controle de conteúdo. (Herdado de ContentControlBase.)
	StoreUpdating	Ocorre antes de Microsoft Office o Word atualiza dados em uma parte XML personalizada vinculada ao conteúdo do controle (ou seja, depois que o texto no conteúdo de controle de alterações). (Herdado de ContentControlBase.)
	Validated	Ocorre quando o controle de conteúdo foi validado com êxito. (Herdado de ContentControlBase.)
	Validating	Ocorre quando o conteúdo do controle de conteúdo está sendo validado. (Herdado de ContentControlBase.)

Início

Comentários

A BuildingBlockGalleryContentControl exibe uma lista de blocos de construção de documento que os usuários podem inserir em um documento. Um bloco de construção de documento é uma parte do conteúdo foi criada para ser usada várias vezes, como, por exemplo, uma folha de rosto comuns, uma tabela formatada ou um cabeçalho. Para escolher os blocos de construção que você deseja exibir, use o BuildingBlockCategory e BuildingBlockType Propriedades.

Para obter mais informações sobre os blocos de construção de documento, consulte o que há de novo para desenvolvedores no Word 2007.

Observação
Esta 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 Visual Studio Tools for Office visão geral sobre o tempo de execução.

Controles de conteúdo

O BuildingBlockGalleryContentControl é um dos oito tipos de controles de conteúdo que você pode usar para criar documentos e modelos do Word de Microsoft Office. Conteúdo de controles possuem uma interface de usuário (UI) que foi controlada entrada como um formulário. Você pode usar controles de conteúdo para impedir que usuários editem seções protegidas do documento ou modelo, e você também pode vincular controles de conteúdo a uma fonte de dados. For more information, see Controles de conteúdo.

Usage

Esta documentação descreve a versão deste tipo que é usada em projetos do Office destinados ao .NET Framework 4. Em projetos destinados ao .NET Framework 3.5, este tipo poderá ter membros diferentes, e os exemplos de código fornecidos para o tipo talvez não funcionem. Para obter documentação sobre este tipo em projetos destinados ao .NET Framework 3.5, consulte a seguinte seção de referência na documentação do Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.

Exemplos

O exemplo de código a seguir adiciona um novo BuildingBlockGalleryContentControl para o início do documento. O BuildingBlockGalleryContentControl exibe os blocos de construção equação fornecidos pelo Word de Microsoft Office.

Esta versão é para uma personalização em nível de documento. Para usar esse código, colá-lo na ThisDocument classe em seu projeto e a chamada a AddBuildingBlockControlAtSelection método a partir do ThisDocument_Startup método.

Dim buildingBlockGalleryControl1 As Microsoft.Office.Tools.Word.BuildingBlockGalleryContentControl

Private Sub AddBuildingBlockGalleryControlAtSelection()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Me.Paragraphs(1).Range.Select()
    buildingBlockGalleryControl1 = Me.Controls.AddBuildingBlockGalleryContentControl( _
        "buildingBlockGalleryControl1")
    With buildingBlockGalleryControl1
        .PlaceholderText = "Choose an equation"
        .BuildingBlockCategory = "Built-In"
        .BuildingBlockType = Word.WdBuildingBlockTypes.wdTypeEquations
    End With
End Sub

private Microsoft.Office.Tools.Word.BuildingBlockGalleryContentControl buildingBlockControl1;

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

    buildingBlockControl1 = this.Controls.AddBuildingBlockGalleryContentControl(
        "buildingBlockControl1");
    buildingBlockControl1.PlaceholderText = "Choose an equation";
    buildingBlockControl1.BuildingBlockCategory = "Built-In";
    buildingBlockControl1.BuildingBlockType = Word.WdBuildingBlockTypes.wdTypeEquations;
}

Esta versão é um suplemento em nível de aplicativo. Para usar esse código, colá-lo na ThisAddIn classe em seu projeto e a chamada a AddBuildingBlockControlAtSelection método a partir do ThisAddIn_Startup método.

Dim buildingBlockGalleryControl1 As BuildingBlockGalleryContentControl

Private Sub AddBuildingBlockGalleryControlAtSelection()
    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()
    buildingBlockGalleryControl1 = vstoDoc.Controls.AddBuildingBlockGalleryContentControl( _
        "buildingBlockGalleryControl1")
    With buildingBlockGalleryControl1
        .PlaceholderText = "Choose an equation"
        .BuildingBlockCategory = "Built-In"
        .BuildingBlockType = Word.WdBuildingBlockTypes.wdTypeEquations
    End With
End Sub

private Microsoft.Office.Tools.Word.BuildingBlockGalleryContentControl buildingBlockControl1;

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

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

    buildingBlockControl1 = vstoDoc.Controls.AddBuildingBlockGalleryContentControl(
        "buildingBlockControl1");
    buildingBlockControl1.PlaceholderText = "Choose an equation";
    buildingBlockControl1.BuildingBlockCategory = "Built-In";
    buildingBlockControl1.BuildingBlockType = Word.WdBuildingBlockTypes.wdTypeEquations;
}