ContentControl Interface

Definição

Namespace:

Microsoft.Office.Interop.Word

Assembly:

Microsoft.Office.Interop.Word.dll

Um controle de conteúdo individual. Controles de conteúdo são limitados e potencialmente rotulada como regiões que servem como recipientes para tipos específicos de conteúdo em um documento. Controles de conteúdo individuais podem conter conteúdo como datas, listas ou parágrafos de texto formatado. O objeto ContentControl é um membro da ContentControls coleção.

public interface class ContentControl

[System.Runtime.InteropServices.Guid("EE95AFE3-3026-4172-B078-0E79DAB5CC3D")]
public interface ContentControl

type ContentControl = interface

Public Interface ContentControl

Atributos

GuidAttribute

Comentários

Use o Add(WdContentControlType, Object) método da ContentControls coleção para criar um controle de conteúdo. Use o Type parâmetro do método Add para especificar o tipo de controle de conteúdo a ser criado.

Use a Type propriedade para alterar o controle de conteúdo para um tipo diferente de controle de conteúdo. Por exemplo, talvez você queira alterar de um controle de data para um controle de texto. No entanto, você não poderá alterar a todos os controles de conteúdo para outro tipo; algumas talvez não permita a alteração de seu tipo. Além disso, dependendo do conteúdo de um controle de conteúdo, você não poderá alterar o tipo. Por exemplo, se o controle de conteúdo que você deseja alterar para não permitir que o tipo de conteúdo que está no controle de conteúdo existente, a tentativa de alterar o tipo não é permitida e gera um erro em tempo de execução.

Use o SetPlaceholderText(BuildingBlock, Range, String) método para alterar o texto de espaço reservado da cadeia de caracteres padrão para algo mais apropriado para o controle. Use a Title propriedade para especificar o texto do título para o controle. Isso exibe acima do controle quando o cursor é posicionado dentro do controle ou o ponteiro do mouse estiver posicionado sobre o controle.

Dependendo do tipo de controle de conteúdo que você precisa, você pode não ser capazes de usar todas as propriedades e métodos do objeto ContentControl.

Nem todas as propriedades de controle de conteúdo se aplicam a todos os tipos diferentes de controles de conteúdo. A tabela a seguir lista quais propriedades se aplicam a que tipos de controles de conteúdo.

	BuildingBlockCategory Propriedade	Controles de conteúdo da Galeria BuildingBlock (wdContentControlBuildingBlockGallery)
	BuildingBlockType Propriedade	Controles de conteúdo da Galeria BuildingBlock (wdContentControlBuildingBlockGallery)
	DateDisplayFormat Propriedade	Controles de conteúdo de data (wdContentControlDate)
	DateDisplayLocale Propriedade	Controles de conteúdo de data (wdContentControlDate)
	DateStorageFormat Propriedade	Controles de conteúdo de data (wdContentControlDate)
	DropdownListEntries Propriedade	Caixa de combinação e controles de conteúdo de lista suspensa (wdContentControlComboBox e wdContentControlDropdownList)
	MultiLine Propriedade	Controles de conteúdo de texto simples (wdContentControlText)
	Ungroup() Método	Controles de conteúdo de grupo (wdContentControlGroup)

Propriedades

AllowInsertDeleteSection	Obtém ou define se os usuários podem adicionar ou remover seções do controle de conteúdo da seção repetida especificada usando a interface do usuário.
Appearance	Retorna ou define a aparência do controle de conteúdo. Leitura/gravação WdContentControlAppearance
Application	Retorna um _Application objeto que representa o aplicativo microsoft Word.
BuildingBlockCategory	Retorna ou define a categoria para um controle de conteúdo de bloco de construção. Leitura/gravação.
BuildingBlockType	Retorna ou define o tipo de bloco de construção para um controle de conteúdo de bloco de construção. Leitura/gravação.
Checked	Obtém ou define o estado atual (verificado/desmarcado) para uma caixa de marcar.
Color	Retorna ou define a cor do controle de conteúdo. Leitura/gravação WdColor.
Creator	Retorna um inteiro de 32 bits que indica o aplicativo no qual o suplemento foi criado. Somente leitura.
DateCalendarType	Retorna ou define o tipo de calendário para um controle de conteúdo de calendário. Leitura/gravação.
DateDisplayFormat	Retorna ou define o formato no qual as datas são exibidas. Leitura/gravação.
DateDisplayLocale	Retorna um formato de idioma para a data exibida em um controle de conteúdo de data. Leitura/gravação.
DateStorageFormat	Retorna ou define o formato para armazenamento e recuperação de datas quando um controle de conteúdo de data está vinculado ao armazenamento de dados XML do documento ativo. Leitura/gravação.
DefaultTextStyle	Retorna ou define o nome do estilo de caractere a ser usado para formatar texto em um controle de conteúdo de texto. Leitura/gravação.
DropdownListEntries	Retorna os itens em um controle de conteúdo de lista suspensa ou em um controle de conteúdo de caixa de combinação. Somente leitura.
ID	Retorna a identificação de um controle de conteúdo. Somente leitura.
Level	Retorna o nível do controle de conteúdo , se o controle de conteúdo envolve texto, parágrafos, células de tabela ou linhas de tabela; ou se estiver embutido. Somente WdContentControlLevelleitura .
LockContentControl	Retorna ou define um Boolean que indica se o usuário pode excluir um controle de conteúdo do documento ativo. Leitura/gravação.
LockContents	Retorna ou define um Boolean que indica se o usuário pode editar o conteúdo de um controle de conteúdo. Leitura/gravação.
MultiLine	Retorna um Boolean que indica se um controle de conteúdo de texto permite várias linhas de texto. Leitura/gravação.
Parent	Retorna um que representa o objeto pai do objeto especificado ContentControl .
ParentContentControl	Retorna o controle de conteúdo pai para um controle de conteúdo aninhado dentro de um controle de texto avançado ou controle de grupo. Somente leitura.
PlaceholderText	Retorna um BuildingBlock objeto que representa o texto de espaço reservado para um controle de conteúdo. Somente leitura.
Range	Retorna um Range que representa o conteúdo do controle de conteúdo no documento ativo. Somente leitura.
RepeatingSectionItems	Retorna a coleção de itens de seção repetidos no controle de conteúdo da seção repetida especificada. Somente leitura.
RepeatingSectionItemTitle	Retorna ou define o nome dos itens de seção repetidos usados no menu de contexto associado ao controle de conteúdo da seção repetida especificado. Leitura/gravação.
ShowingPlaceholderText	Retorna um Boolean que indica se o texto de espaço reservado para o controle de conteúdo é exibido. Somente leitura.
Tag	Retorna ou define um valor para identificar um controle de conteúdo. Leitura/gravação.
Temporary	Retorna ou define um Boolean que indica se deseja remover um controle de conteúdo do documento ativo quando o usuário edita o conteúdo do controle. Leitura/gravação.
Title	Retorna ou define o título para um controle de conteúdo. Leitura/gravação.
Type	Retorna ou define o tipo para um controle de conteúdo. Leitura/gravação.
XMLMapping	Retorna o mapeamento de um controle de conteúdo para dados XML no armazenamento de dados de um documento. Somente leitura.

Métodos

Copy()	Copia o controle de conteúdo do documento ativo para a área de transferência.
Cut()	Remove o controle de conteúdo do documento ativo e move o controle de conteúdo para a área de transferência.
Delete(Boolean)	Exclui o controle de conteúdo especificado e o conteúdo do controle de conteúdo.
SetCheckedSymbol(Int32, String)	Define o símbolo usado para representar o estado selecionado de um controle de caixa de seleção de conteúdo.
SetPlaceholderText(BuildingBlock, Range, String)	Define o texto do indicador exibido no controle de conteúdo até que um usuário digite seu próprio texto.
SetUncheckedSymbol(Int32, String)	Define o símbolo usado para representar o estado desmarcado de um controle de caixa de seleção de conteúdo.
Ungroup()	Remove um controle de conteúdo de grupo de um documento, de forma que seus controles de conteúdo de grupo filhos não fiquem mais aninhados e possam ser livremente editados.