Definir propriedades de formulário, relatório e controle no Visual Basic

Artigo
04/07/2023

Os objetos Formulário, Relatório e Controle são objetos do Microsoft Access. Você pode definir propriedades para esses objetos em procedimento Sub, Function ou de evento. Você também pode definir propriedades para seções de formulário e relatório.

Definir uma propriedade de um formulário ou relatório

Consulte o formulário ou relatório individual na coleção Formulários ou Relatórios, seguida pelo nome da propriedade e seu valor. Por exemplo, para definir a propriedade Visible do formulário Customers como True (-1), use a seguinte linha de código:

Forms!Customers.Visible = True

Você também pode definir uma propriedade de um formulário ou relatório de dentro do módulo do objeto usando a propriedade Me do objeto. O código que utiliza a propriedade Me é executado com maior velocidade que o código que utiliza um nome de objeto totalmente qualificado. Por exemplo, para definir a propriedade RecordSource do formulário Customers como uma instrução SQL que retorna todos os registros com uma entrada de campo CompanyName começando com "A" de dentro do módulo do formulário Customers, utilize a linha de código a seguir:

Me.RecordSource = "SELECT * FROM Customers " _ 
    & "WHERE CompanyName Like 'A*'"

Definir uma propriedade de um controle

Confira o controle na coleção Controls do objeto Form ou Report no qual ela reside. Consulte a coleção Controles implicitamente ou explicitamente, mas o código é executado mais rapidamente se você usar uma referência implícita. O conjunto de exemplos a seguir define a propriedade Visible de uma caixa de texto chamada CustomerID no formulário Customers:

' Faster method. 
Me!CustomerID.Visible = True

' Slower method. 
Forms!Customers.Controls!CustomerID.Visible = True

A maneira mais rápida de definir uma propriedade de um controle é de dentro de um módulo do objeto usando a propriedade Me do objeto. Por exemplo, é possível usar o código a seguir para alternar a propriedade Visible de uma caixa de texto chamada CustomerID no formulário Customers:

With Me!CustomerID 
    .Visible = Not .Visible 
End With

Definir uma propriedade de uma seção de formulário ou relatório

Consulte o formulário ou relatório presente em na coleção Forms ou Reports, seguida pela propriedade Section e o número inteiro ou constante que identifica a seção. Os exemplos a seguir definem a propriedade Visible da seção de cabeçalho da página do formulário Customers como False:

Forms!Customers.Section(3).Visible = False

Me!Section(acPageHeader).Visible = False

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.

Compartilhar via