Compartilhar via


Objeto Controlos (Access)

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 Controlos é membro dos objetos Formulário, Relatório e Subformulário .

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 fazer referência à coleção Controlos implicitamente, como nos exemplos seguintes, que se referem a um controlo chamado NewData num formulário denominado 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

Utilize o palavra-chave Me para representar um formulário ou relatório dentro do código apenas se estiver a referir-se ao formulário ou relatório do código no módulo de formulário ou no módulo de relatório. Se estiver a referir-se a um formulário ou relatório de um módulo padrão ou de um formulário ou módulo de relatório diferente, tem de utilizar 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, pode consultar a coleção Controlos do objeto Secção .

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.