Objeto Control (Access)

O objeto Control representa um controle em um formulário, relatório ou seção, dentro de outro controle, ou anexado a outro controle.

Comentários

Todos os controles em um formulário ou relatório pertencem à coleção Controls para esse objeto Formulário ou Relatório . Os controles de uma seção específica pertencem à coleção Controls dessa seção. Os controles de um controle de guia ou grupo de opções pertencem à coleção Controls desse controle. Um controle de rótulo que está incluído em outro pertence à coleção Controls desse controle.

Ao referir-se a um objeto Control individual da coleção Controls, você pode referir-se à coleção Controls implícita ou explicitamente.

' Implicitly refer to NewData control in Controls 
' collection. 
Me!NewData
' Use if control name contains space. 
Me![New Data]
' Performance slightly slower. 
Me("NewData")
' Refer to a control by its index in the controls 
' collection. 
Me(0)
' Refer to a NewData control by using the subform 
' Controls collection. 
Me.ctlSubForm.Controls!NewData
' Explicitly refer to the NewData control in the 
' Controls collection. 
Me.Controls!NewData
Me.Controls("NewData")
Me.Controls(0)

Observação

Use a palavra-chave Me para representar um objeto Formulário ou Relatório dentro do código somente se você estiver se referindo ao formulário ou relatório do código dentro do módulo de classe. Se você estiver se referindo a um formulário ou relatório de um módulo padrão ou de um módulo de formulário ou relatório diferente, você deve usar a referência completa ao formulário ou relatório.

Cada objeto Control é indicado por uma determinada constante intrínseca. Por exemplo, a constante intrínseca acTextBox está associada a um controle de caixa de texto e acCommandButton está associada a um botão de comando. As constantes para os vários controles do Microsoft Access são definidas na propriedade ControlType do controle.

Para determinar o tipo de um controle existente, você pode utilizar a propriedade ControlType. No entanto, você não precisa saber o tipo específico de controle para usá-lo no código. Você pode simplesmente representá-lo com uma variável do tipo de dados Control.

Se você de fato conhece o tipo de dado do controle ao qual você está se referindo e o controle for um controle interno do Microsoft Access, deve representá-lo com uma variável de um tipo específico. Por exemplo, se você sabe que determinado controle é uma caixa de texto, declare uma variável do tipo TextBox para representá-lo, como mostra o seguinte código.

Dim txt As TextBox 
Set txt = Forms!Employees!LastName 

Observação

Se um controle for um controle ActiveX, você deverá declarar uma variável de controle de tipo para representá-lo; você não pode usar um tipo específico. Se você não tiver certeza de qual tipo de controle uma variável apontará, declare a variável como controle de tipo.

O controle grupo de opções pode conter outros controles dentro de sua coleção Controls, inclusive os controles botão de opção, caixa de seleção, botão de alternância e rótulo.

O controle guia contém um páginas coleção, que é um tipo especial de coleção Controls. A coleção Páginas contém objetos Page , que são controles. Cada objeto Page, por sua vez, contém uma coleção Controls, que contém todos os controles dessa página.

Outros objetos de controle tem uma coleção de controles que pode conter um rótulo anexado. Esses controles incluem a caixa de texto, grupo de opção, botão de opção, botão de alternância, caixa de seleção, caixa de combinação, caixa de listagem, botão de comando, quadro de objeto acoplado e controles de quadro de objeto não acoplado.

Métodos

Propriedades

Confira também

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.