Compartilhar via


ContentControl Interface

Definição

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

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 PropriedadeControles de conteúdo da Galeria BuildingBlock (wdContentControlBuildingBlockGallery)
BuildingBlockType PropriedadeControles de conteúdo da Galeria BuildingBlock (wdContentControlBuildingBlockGallery)
DateDisplayFormat PropriedadeControles de conteúdo de data (wdContentControlDate)
DateDisplayLocale PropriedadeControles de conteúdo de data (wdContentControlDate)
DateStorageFormat PropriedadeControles de conteúdo de data (wdContentControlDate)
DropdownListEntries PropriedadeCaixa de combinação e controles de conteúdo de lista suspensa (wdContentControlComboBox e wdContentControlDropdownList)
MultiLine PropriedadeControles de conteúdo de texto simples (wdContentControlText)
Ungroup() MétodoControles 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.

Aplica-se a