Objeto Controls (Access)

  • Artigo

A coleção Controls contém todos os controles em um formulário, relatório ou subformulário, dentro de outro controle, ou anexado a outro controle. A coleção Controls é um membro dos objetos Formulário, Relatório e SubForm .

Comentários

Você pode enumerar controles individuais, contá-los e definir suas propriedades na coleção Controls. Por exemplo, você pode enumerar a coleção de controles de um determinado formulário e defina a propriedade Height de cada controle como um valor especificado.

É mais rápido se referir à coleção Controls implicitamente, como nos exemplos a seguir, que se referem a um controle chamado NewData em um formulário chamado OrderForm. Dos exemplos de sintaxe a seguir, Me!NewData é a maneira mais rápida para se referir ao controle.

Me!NewData               ' Or Forms!OrderForm!NewData.

Me![New Data]            ' Use if control name contains space.

Me("NewData")            ' Performance is slightly slower.

Você também pode consultar a um controle individual fazendo referência explícita à coleção Controls.

Me.Controls!NewData      ' Or Forms!OrderForm.Controls!NewData.

Me.Controls![New Data]

Me.Controls("NewData")

Além disso, você pode consultar a um controle por seu índice na coleção. A coleção de controles é indexada começando com zero.

Me(0)                    ' Refer to first item in collection.

Me.Controls(0)

Observação

Use a palavra-chave Me para representar um 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 formulário ou módulo de relatório. 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.

Para trabalhar com os controles em uma seção de um formulário ou relatório, use a seção propriedade para retornar uma referência a um objeto Section. Em seguida, você pode consultar a coleção Controles do objeto Section .

Dois tipos de objetos de controle, o controle de guia e o controle de grupo de opção, terá conjuntos de controles que podem conter vários controles. A coleção de controles que pertencem ao controle de grupo de opção contém qualquer botão de opção, caixa de seleção, botão de alternância ou controles label do grupo de opção.

O controle guia contém um páginas coleção, que é um tipo especial de coleção Controls. A coleção Pages contém página objetos. Objetos de página também são controles. O ControlType constante de propriedade para um controle de página é acPage. Um objeto Page, por sua vez, tem seu próprio conjunto de controles, que contém todos os controles em uma página individual.

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.

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.