ContentControl Interface

Referência

Definição

Namespace:: Microsoft.Office.Interop.Word

Assembly:: Microsoft.Office.Interop.Word.dll

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.

Um controle de conteúdo individual. Os controles de conteúdo são regiões associadas e potencialmente rotuladas em um documento que servem como contêineres para tipos específicos de conteúdo. 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 do 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 do 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.

Not all content control properties apply to all the different types of content controls. The following table lists which properties apply to which types of content controls.

	BuildingBlockCategory property	BuildingBlock Gallery content controls (wdContentControlBuildingBlockGallery)
	BuildingBlockType property	BuildingBlock Gallery content controls (wdContentControlBuildingBlockGallery)
	DateDisplayFormat property	Date content controls (wdContentControlDate)
	DateDisplayLocale property	Date content controls (wdContentControlDate)
	DateStorageFormat property	Date content controls (wdContentControlDate)
	DropdownListEntries property	Combo box and drop-down list content controls (wdContentControlComboBox and wdContentControlDropdownList)
	MultiLine property	Plain text content controls (wdContentControlText)
	Ungroup() method	Group content controls (wdContentControlGroup)

Propriedades

AllowInsertDeleteSection	Obtém ou define se os usuários podem adicionar ou remover seções do controle de conteúdo de seção recorrente especificado usando a interface de usuário.
Appearance	Retorna ou define a aparência do controle de conteúdo. Leitura/gravaçãoWdContentControlAppearance
Application	Retorna um _Application objeto que representa o aplicativo Microsoft Word.
BuildingBlockCategory	Retorna ou define a categoria de um controle de conteúdo do bloco de construção. Leitura/gravação.
BuildingBlockType	Retorna ou define o tipo de bloco de construção para um controle de conteúdo do bloco de construção. Leitura/gravação.
Checked	Obtém ou define o estado atual (marcado/desmarcado) para uma caixa de seleção.
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 de armazenamento e recuperação de datas quando um controle de conteúdo de data é vinculado ao repositório de dados XML do documento ativo. Leitura/gravação.
DefaultTextStyle	Retorna ou define o nome do estilo de caractere a ser usado para formatar o 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 ela estiver embutida. Somente leitura WdContentControlLevel .
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 de um controle de conteúdo que está aninhado dentro de um controle de Rich-Text ou controle de grupo. Somente leitura.
PlaceholderText	Retorna um BuildingBlock objeto que representa o texto do 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 de repetição no controle de conteúdo de seção recorrente especificado. Somente leitura.
RepeatingSectionItemTitle	Retorna ou define o nome dos itens de seção de repetição usados no menu de contexto associado ao controle de conteúdo de seção recorrente 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 de um controle de conteúdo. Leitura/gravação.
Type	Retorna ou define o tipo de um controle de conteúdo. Leitura/gravação.
XMLMapping	Retorna o mapeamento de um controle de conteúdo para dados XML no repositório 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.

Aplica-se a