BuildingBlockGalleryContentControl Interface
Definição
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 galeria de blocos de construção de documento que os usuários podem inserir em um documento.
[System.Runtime.InteropServices.Guid("d8d887a2-69fe-4a86-a8dd-352003dc0e7e")]
public interface BuildingBlockGalleryContentControl : IDisposable, Microsoft.Office.Tools.Word.ContentControlBase, System.ComponentModel.IComponent, System.ComponentModel.ISupportInitialize, System.Windows.Forms.IBindableComponent
- Atributos
- Implementações
Exemplos
O exemplo de código a seguir adiciona um novo BuildingBlockGalleryContentControl ao início do documento. O BuildingBlockGalleryContentControl exibe blocos de construção da equação que são fornecidos pelo Microsoft Office Word.
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 AddBuildingBlockControlAtSelection no método ThisDocument_Startup.
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;
}
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
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 AddBuildingBlockControlAtSelection no método ThisAddIn_Startup.
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;
}
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
Comentários
Um 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 criado para ser usado várias vezes, como uma folha de rosto comum, uma tabela formatada ou um cabeçalho. Para escolher os blocos de construção que você deseja exibir, use as BuildingBlockCategory BuildingBlockType Propriedades e.
Para obter mais informações sobre blocos de construção de documento, consulte What ' s New for Developers in Word 2007.
Observação
Essa interface é implementada pelo Visual Studio Tools para 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 BuildingBlockGalleryContentControl é 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. |
| BuildingBlockCategory |
Obtém ou define a categoria dos blocos de construção exibidos no BuildingBlockGalleryContentControl. |
| BuildingBlockType |
Obtém ou define o tipo dos blocos de construção que são exibidos no BuildingBlockGalleryContentControl. |
| Container | (Herdado de ContentControlBase) |
| ContainerComponent | (Herdado de ContentControlBase) |
| Creator |
Obtém um inteiro de 32 bits que indica o aplicativo no qual o BuildingBlockGalleryContentControl 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 a ser usado para formatar o texto no BuildingBlockGalleryContentControl. |
| 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 BuildingBlockGalleryContentControl pode ser excluído do documento. |
| LockContents |
Obtém ou define um valor que especifica se o conteúdo do BuildingBlockGalleryContentControl pode ser editado. |
| Parent |
Obtém o pai do BuildingBlockGalleryContentControl. |
| ParentContentControl |
Obtém o controle de conteúdo pai de um BuildingBlockGalleryContentControl aninhado em outro controle de conteúdo. |
| PlaceholderText |
Obtém ou define o texto exibido no BuildingBlockGalleryContentControl 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 BuildingBlockGalleryContentControl. |
| ShowingPlaceholderText |
Obtém um valor que indica se o BuildingBlockGalleryContentControl está exibindo o texto do espaço reservado no momento. |
| Tag |
Obtém ou define uma cadeia de caracteres que você deseja associar ao BuildingBlockGalleryContentControl. |
| Temporary |
Obtém ou define um valor que especifica se o BuildingBlockGalleryContentControl será excluído automaticamente do documento quando o controle for editado. |
| Text |
Obtém ou define o texto no BuildingBlockGalleryContentControl. |
| Title |
Obtém ou define o título do BuildingBlockGalleryContentControl. |
Métodos
| Copy() |
Copia o BuildingBlockGalleryContentControl do documento para a Área de Transferência. |
| Cut() |
Remove o BuildingBlockGalleryContentControl 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 BuildingBlock, um Range ou em uma cadeia de caracteres como texto de espaço reservado no BuildingBlockGalleryContentControl. |
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) |