Objeto ContentControl (Word)

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. Objeto ContentControl é um membro da coleção ContentControls.

Comentários

Use o método Add da coleção ContentControls para criar um controle de conteúdo. Use o parâmetro Type do método Add para especificar o tipo de controle de conteúdo a ser criado. O exemplo a seguir cria um novo controle de conteúdo de lista suspensa e adiciona vários itens à lista.

Dim objCC As ContentControl 
 
Set objCC = ActiveDocument.ContentControls.Add(Type:=wdContentControlDropdownList) 
 
'List entries 
objCC.DropdownListEntries.Add "Cat" 
objCC.DropdownListEntries.Add "Dog" 
objCC.DropdownListEntries.Add "Horse" 
objCC.DropdownListEntries.Add "Monkey" 
objCC.DropdownListEntries.Add "Snake" 
objCC.DropdownListEntries.Add "Other"

Use a propriedade Type para alterar o controle de conteúdo para um tipo de controle de conteúdo diferente. 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.

O exemplo a seguir insere um controle de conteúdo de data e define o valor do controle; em seguida, altera o controle para um controle de conteúdo de texto.

Dim objCC As ContentControl 
 
Set objCC = ActiveDocument.ContentControls.Add(wdContentControlDate) 
 
objCC.Range.Text = "January 1, 2007" 
objCC.Type = wdContentControlText

Use o método SetPlaceholderText para alterar o texto de espaço reservado da cadeia de caracteres padrão para algo mais apropriado para o controle. Use a propriedade Title 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.

Propriedade/Método	Aplica-se a
Propriedade BuildingBlockCategory	Controles de conteúdo BuildingBlock Gallery (wdContentControlBuildingBlockGallery)
Propriedade BuildingBlockType	Controles de conteúdo BuildingBlock Gallery (wdContentControlBuildingBlockGallery)
Propriedade DateDisplayFormat	Controles de conteúdo de data (wdContentControlDate)
Propriedade DateDisplayLocale	Controles de conteúdo de data (wdContentControlDate)
Propriedade DateStorageFormat	Controles de conteúdo de data (wdContentControlDate)
Propriedade DropdownListEntries	Controles de conteúdo da caixa de combinação e da lista suspensa (wdContentControlComboBox e wdContentControlDropdownList)
Propriedade MultiLine	Controles de conteúdo de texto simples (wdContentControlText)
Método Ungroup	Controles de conteúdo de grupo (wdContentControlGroup)

Confira também

Referência do modelo de objeto do Word

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.