Interface BuildingBlockGalleryContentControl

Artigo
01/09/2014

Representa uma galeria dos 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 Microsoft.Office.Interop.Word.Application que representa a instância atual do Microsoft Office Word.
	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 em BuildingBlockGalleryContentControl.
	BuildingBlockType	Obtém ou define o tipo dos blocos de construção que são exibidos em 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 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 DataSourceUpdateMode padrão para ContentControlBase. (Herdado de ContentControlBase.)
	DefaultTextStyle	Obtém o nome do estilo de caracteres para usar para formatar o texto em BuildingBlockGalleryContentControl.
	ID	Obtém um número exclusivo que identifica o controle de conteúdo. (Herdado de ContentControlBase.)
	InnerObject	Obtém o objeto subjacente de Microsoft.Office.Interop.Word.ContentControl para Microsoft.Office.Tools.Word.ContentControlBase. (Herdado de ContentControlBase.)
	LockContentControl	Obtém ou define um valor que especifica se BuildingBlockGalleryContentControl pode ser excluído do documento.
	LockContents	Obtém ou define um valor que especifica se o conteúdo de BuildingBlockGalleryContentControl podem ser editados.
	Parent	Obtém o pai de BuildingBlockGalleryContentControl.
	ParentContentControl	Obtém o controle de conteúdo pai de BuildingBlockGalleryContentControl que está aninhado em outro controle de conteúdo.
	PlaceholderText	Obtém ou define o texto que é exibido em BuildingBlockGalleryContentControl até que o texto seja alterado por uma ação do usuário ou por alguma outra operação.
	Range	Obtém Range que representa o conteúdo de BuildingBlockGalleryContentControl.
	ShowingPlaceholderText	Obtém um valor que indica se BuildingBlockGalleryContentControl está exibindo o texto atualmente de espaço reservado.
	Site	Obtém ou define o ISite associados a IComponent. (Herdado de IComponent.)
	Tag	Obtém ou define uma cadeia de caracteres que você deseja associar com BuildingBlockGalleryContentControl.
	Temporary	Obtém ou define um valor que especifica se BuildingBlockGalleryContentControl é excluído do documento automaticamente quando o controle é editado.
	Text	Obtém ou define o texto em BuildingBlockGalleryContentControl.
	Title	Obtém ou define o título de BuildingBlockGalleryContentControl.

Superior

Métodos

	Nome	Descrição
	BeginInit	Sinaliza o objeto que a inicialização está iniciando. (Herdado de ISupportInitialize.)
	Copy	Copia BuildingBlockGalleryContentControl do documento para a área de transferência.
	Cut	Remove BuildingBlockGalleryContentControl de documento e o adiciona à área de transferência.
	Delete	Exclui um controle de conteúdo criado dinamicamente do documento e remova-o de ControlCollection no documento. (Herdado de ContentControlBase.)
	Dispose	Realiza tarefas definidas pelo aplicativo associadas à liberação ou à redefinição de 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 que está em Microsoft.Office.Interop.Word.BuildingBlock, em Range, ou em uma cadeia de caracteres como o texto do espaço reservado em BuildingBlockGalleryContentControl.

Superior

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 propriedade de BindingContext de ContentControlBase alterar. (Herdado de ContentControlBase.)
	ContentUpdating	Ocorre antes que o Microsoft Office Word atualiza o texto no controle de conteúdo, se o controle de conteúdo está associado a uma parte personalizado XML. (Herdado de ContentControlBase.)
	Deleting	Ocorre antes que o 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 de conteúdo, ou quando o cursor é movido no controle de conteúdo programaticamente. (Herdado de ContentControlBase.)
	Exiting	Ocorre quando o usuário clica a fora do controle de conteúdo, ou quando o cursor é movida fora do controle de conteúdo programaticamente. (Herdado de ContentControlBase.)
	StoreUpdating	Ocorre antes que o Microsoft Office Word atualiza dados em uma parte personalizado XML que está associada ao controle de conteúdo (isto é, após o texto nas alterações de controle de conteúdo). (Herdado de ContentControlBase.)
	Validated	Ocorre quando o controle de conteúdo é validado com êxito. (Herdado de ContentControlBase.)
	Validating	Ocorre quando o conteúdo do controle de conteúdo são validados. (Herdado de ContentControlBase.)

Superior

Comentários

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 que foi projetado para ser usado várias vezes, como uma folha de rosto comuns, uma tabela formatado, ou um cabeçalho. Para escolher blocos de construção que você deseja exibir, use as propriedades de BuildingBlockCategory e de BuildingBlockType .

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

Dica

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 de tempo de execução do Visual Studio Tools for Office.

Conteúdo de controles

BuildingBlockGalleryContentControl é um 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 de usuário (UI) que controla a entrada como um formulário. Você pode usar controles de conteúdo para impedir que usuários das seções protegidas edição de documento ou modelo, e você também pode 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 apenas nos projetos do Office direcionados ao .NET Framework 4 e ao .NET Framework 4.5. 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. Para conhecer a documentação sobre esse tipo de projeto direcionado 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. BuildingBlockGalleryContentControl exibe os blocos de construção de equação que são fornecidos pelo Microsoft Office Word.

Esta é uma versão para personalização de um documento nível. Para usar este código, colagem na classe de ThisDocument em seu projeto, e chame o método de AddBuildingBlockControlAtSelection de método ThisDocument_Startup .

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 é para um suplemento ao aplicativo. Para usar este código, colagem na classe de ThisAddIn em seu projeto, e chame o método de AddBuildingBlockControlAtSelection de método ThisAddIn_Startup .

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