Interface ContentControl

Artigo
05/21/2013

Representa um controle do conteúdo de um documento.

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

Sintaxe

'Declaração
<GuidAttribute("ee82979b-2814-48b1-95dd-4bfcc636a7ec")> _
Public Interface ContentControl _
    Inherits ContentControlBase, IBindableComponent, IComponent, IDisposable,  _
    ISupportInitialize

[GuidAttribute("ee82979b-2814-48b1-95dd-4bfcc636a7ec")]
public interface ContentControl : ContentControlBase, 
    IBindableComponent, IComponent, IDisposable, ISupportInitialize

O tipo ContentControl 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 de blocos de construção que são exibidos em ContentControl que representa uma galeria do bloco de construção.
	BuildingBlockType	Obtém ou define o tipo dos blocos de construção que são exibidos em ContentControl que representa uma galeria do bloco de construção.
	Checked	Obtém ou define um valor que indica se ContentControl que representa um controle de caixa de seleção está marcada ou desmarcada.
	Container	Infraestrutura. (Herdado de ContentControlBase.)
	ContainerComponent	Infraestrutura. (Herdado de ContentControlBase.)
	Creator	Obtém um inteiro de 32 bits que indica o aplicativo no qual ContentControl foi criado.
	DataBindings	Obtém a coleção de objetos de ligação de dados para este IBindableComponent. (Herdado de IBindableComponent.)
	DateCalendarType	Obtém ou define o tipo de calendário que é exibido em ContentControl que representa um selecionador de data.
	DateDisplayFormat	Obtém ou define uma cadeia de caracteres que especifica o formato de datas que são exibidas em ContentControl que representa um selecionador de data.
	DateDisplayLocale	Obtém ou define o formato de linguagem de data que é exibida em ContentControl que representa um selecionador de data.
	DateStorageFormat	Obtém ou define o formato em que as datas são salvas em uma parte personalizado XML por ContentControl que representa um selecionador de data.
	DefaultDataSourceUpdateMode	Obtém ou define DataSourceUpdateMode padrão para ContentControlBase. (Herdado de ContentControlBase.)
	DefaultTextStyle	Obtém o nome do estilo de caracteres que é usada para formatar o texto em ContentControl.
	DropDownListEntries	Obtém a coleção de itens que são exibidos por ContentControl que representa uma lista suspensa ou uma caixa combo.
	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 ContentControl pode ser excluído do documento.
	LockContents	Obtém ou define um valor que especifica se o conteúdo de ContentControl podem ser editados.
	MultiLine	Obtém ou define um valor que especifica se ContentControl pode conter quebras de linha.
	Parent	Obtém o pai de ContentControl.
	ParentContentControl	Obtém o controle pai de conteúdo de ContentControl que está aninhado em outro controle de conteúdo.
	PlaceholderText	Obtém o texto que é exibido em ContentControl até que o texto seja alterado por uma ação do usuário ou por outra operação.
	Range	Obtém Range que representa o conteúdo de ContentControl.
	ShowingPlaceholderText	Obtém um valor que especifica se ContentControl 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 ContentControl.
	Temporary	Obtém ou define um valor que especifica se ContentControl é excluído do documento automaticamente quando o controle é editado.
	Title	Obtém ou define o título de ContentControl.
	Type	Obtém ou define um valor que especifica o tipo de controle de conteúdo que representa ContentControl .
	XMLMapping	Obtém XMLMapping que representa a associação entre ContentControl e um elemento em uma parte personalizado XML.

Superior

Métodos

	Nome	Descrição
	BeginInit	Sinaliza o objeto que a inicialização está iniciando. (Herdado de ISupportInitialize.)
	Copy	Copia ContentControl do documento para a área de transferência.
	Cut	Remove ContentControl de documento e o adiciona à área de transferência.
	Delete	Exclui um controle de conteúdo dinamicamente criado do documento e remova-o de ControlCollection no documento. (Herdado de ContentControlBase.)
	Dispose	Executa tarefas definido pelo 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.)
	SetCheckedSymbol	Define o símbolo usado para representar o estado selecionado de ContentControl que representa um controle de caixa de seleção.
	SetPlaceholderText	Exibe o texto que está em BuildingBlock, em Range, ou em uma cadeia de caracteres como o texto de espaço reservado em ContentControl.
	SetUncheckedSymbol	Define o símbolo usado para representar o estado de ContentControl não-verificada que representa um controle de caixa de seleção
	Ungroup	Remove o conteúdo do controle de grupo que contém ContentControl de documento de modo que a região não estiver protegida.

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 do 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 do 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

Um objeto de ContentControl mutável é um controle que pode representar qualquer um dos oito tipos de controles de conteúdo que você pode usar Microsoft Office Word.Por exemplo, se você criar ContentControl que tem inicialmente a funcionalidade de um controle de texto sem formatação, você pode alterá-lo em tempo de execução para que se comporta como uma caixa combo.Outros controles de conteúdo não podem ser usados dessa maneira.Por exemplo, RichTextContentControl só pode representar um controle de texto rico.Para obter mais informações sobre controles de conteúdo, consulte Controles de conteúdo.

Para criar ContentControl, use um dos métodos de AddContentControl .Você não pode adicionar ContentControl a um documento em tempo de design.

Quando você cria ContentControl, você deve especificar o tipo de controle conteúdo que você deseja criar, ou você pode basear o novo controle em um controle de conteúdo existente.Depois de criar ContentControl, você pode alterar o tipo de controle de conteúdo que representa usando a propriedade de Type .

Alguns membros de ContentControl irão acionar uma exceção se você usá-los quando o controle é definido como um tipo de controle que não está deve usar o membro.Por exemplo, a propriedade de DateCalendarType lança uma exceção se você tentar usar na ContentControl que não representa um selecionador de data.

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

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 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.