ContentControl Interface
Definição
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. 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 ContentControltype ContentControl = interfacePublic 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 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. |