Interface ContentControl

Artigo
08/01/2011

Representa um controle de 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 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 em um ContentControl que representa uma Galeria de bloco de construção.
	BuildingBlockType	Obtém ou define o tipo de blocos de construção são exibidos em um ContentControl que representa uma Galeria de bloco de construção.
	Checked	Obtém ou define um valor que indica se um ContentControl que representa um controle caixa de seleção é marcada ou desmarcada.Esta propriedade pode ser usada somente em Word 2010 projetos.
	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 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 é exibido em um ContentControl que representa um selecionador de data.
	DateDisplayFormat	Obtém ou define uma seqüência de caracteres que especifica o formato das datas são exibidos em um ContentControl que representa um selecionador de data.
	DateDisplayLocale	Obtém ou define o formato de idioma da data que é exibido em um ContentControl que representa um selecionador de data.
	DateStorageFormat	Obtém ou define o formato no qual as datas são salvos em uma parte XML personalizada por um ContentControl que representa um selecionador de data.
	DefaultDataSourceUpdateMode	Obtém ou define o padrão DataSourceUpdateMode para o ContentControlBase. (Herdado de ContentControlBase.)
	DefaultTextStyle	Obtém o nome do estilo de caractere que é usado para formatar o texto da ContentControl.
	DropDownListEntries	Obtém a coleção de itens que são exibidos por um ContentControl que representa uma lista suspensa ou uma caixa de combinação.
	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 ContentControl pode ser excluído do documento.
	LockContents	Obtém ou define um valor que especifica se o conteúdo da ContentControl pode ser editado.
	MultiLine	Obtém ou define um valor que especifica se o ContentControl pode conter quebras de linha.
	Parent	Obtém o pai do ContentControl.
	ParentContentControl	Obtém o pai de controle de conteúdo uma ContentControl que está aninhado em outro controle de conteúdo.
	PlaceholderText	Obtém o texto que é exibido no ContentControl 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 ContentControl.
	ShowingPlaceholderText	Obtém um valor que especifica se o ContentControl 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 ContentControl.
	Temporary	Obtém ou define um valor que especifica se o ContentControl é excluído automaticamente do documento quando o controle é editado.
	Title	Obtém ou define o título da ContentControl.
	Type	Obtém ou define um valor que especifica o tipo de conteúdo de controle que o ContentControl representa.
	XMLMapping	Obtém um XMLMapping que representa a ligação entre o ContentControl e um elemento em um part. XML personalizado

Início

Métodos

	Nome	Descrição
	BeginInit	Sinaliza o objeto que a inicialização está iniciando. (Herdado de ISupportInitialize.)
	Copy	Cópias do ContentControl do documento para a área de transferência.
	Cut	Remove o ContentControl 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.)
	SetCheckedSymbol	Define o símbolo usado para representar o estado selecionado de um ContentControl que representa um controle caixa de seleção.Esse método pode ser usado somente em Word 2010 projetos.
	SetPlaceholderText	Exibe o texto em um BuildingBlock, um Range, ou uma seqüência de texto de espaço reservado a ContentControl.
	SetUncheckedSymbol	Define o símbolo usado para representar o estado desmarcado de um ContentControl que representa um controle caixa de seleção.Esse método pode ser usado somente em Word 2010 projetos
	Ungroup	Remove o controle de conteúdo do grupo que contém o ContentControl do documento para que a região é não mais protegido.

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 ContentControl o objeto é um controle mutável, que pode representar qualquer um dos oito tipos de controles de conteúdo que você pode usar no Word em Microsoft Office. Por exemplo, se você criar um ContentControl inicialmente, que possui a funcionalidade de um controle de texto sem formatação, você pode alterá-lo em tempo de execução para que ele se comporta como uma caixa de combinação. Outro controles de conteúdo não pode ser usado dessa maneira. Por exemplo, um RichTextContentControl só pode representar um controle rich text. Para obter mais informações sobre controles de conteúdo, consulte Controles de conteúdo.

Para criar um ContentControl, use um da AddContentControl métodos. Não é possível adicionar um ContentControl a um documento no tempo de design.

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

Alguns ContentControl membros lançará uma exceção se você usá-los enquanto o controle estiver definido como um tipo de controle que não pretende usar o membro. Por exemplo, o DateCalendarType propriedade lançará uma exceção se você tentar usá-lo em um ContentControl não representa um selecionador de data.

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.

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.