Compartilhar via


Objeto CheckBox (Word)

Representa um único campo de formulário caixa de seleção.

Comentários

Use FormFields (Index), em que Index é o número de índice ou o nome do indicador associado à caixa de seleção, para retornar um único objeto FormField . Use a propriedade CheckBox com o objeto FormField para retornar um objeto CheckBox . O exemplo a seguir marca o campo de formulário caixa de seleção chamado "Check1" do documento ativo.

ActiveDocument.FormFields("Check1").CheckBox.Value = True

O número de índice representa a posição do campo de formulário no FormFields coleção. O exemplo a seguir verifica o tipo do primeiro campo de formulário; se for uma caixa de seleção, a caixa de seleção será marcada.

If ActiveDocument.FormFields(1).Type = wdFieldFormCheckBox Then 
 ActiveDocument.FormFields(1).CheckBox.Value = True 
End If

O exemplo a seguir determina se o objeto ffield é válido antes de alterar o tamanho da caixa de seleção para 14 pontos.

Set ffield = ActiveDocument.FormFields(1).CheckBox 
If ffield.Valid = True Then 
 ffield.AutoSize = False 
 ffield.Size = 14 
Else 
 MsgBox "First field is not a check box" 
End If

Use o método Add com o objeto FormFields para adicionar um campo de formulário de caixa de seleção. O exemplo a seguir adiciona uma caixa de seleção no início do documento ativo, define o nome como "Color" e marca a caixa de seleção.

With ActiveDocument.FormFields.Add(Range:=ActiveDocument.Range _ 
 (Start:=0,End:=0), Type:=wdFieldFormCheckBox) 
 .Name = "Color" 
 .CheckBox.Value = True 
End With

Propriedades

Nome
Aplicativo
AutoSize
Creator
Padrão
Parent
Size
Valid
Valor

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.