Propriedade ActiveForm

Aplica-se A
Access para Microsoft 365 Access 2021 Access 2019 Access 2016

Aplica-se a

Objeto Screen

Você pode usar a propriedade ActiveForm juntamente com o objeto Screen para identificar ou se referir ao formulário que tem o foco. Objeto Form só de leitura.

expressão.ActiveForm

expressão Obrigatório. Uma expressão que devolve um dos objetos na lista Aplica-se A.

Definição

Esta configuração de propriedade contém uma referência ao objeto de formulário que tem o foco em tempo de execução.

Esta propriedade está disponível ao utilizar uma macro ou código Visual Basic for Applications (VBA) e é só de leitura em todas as vistas.

Observações

Pode utilizar a propriedade ActiveForm para se referir a um formulário ativo, em conjunto com uma das suas propriedades ou métodos. O seguinte exemplo mostra a definição da propriedade Nome do formulário ativo.

Dim frmCurrentForm As Form
Set frmCurrentForm = Screen.ActiveForm
MsgBox "Current form is " & frmCurrentForm.Name

Se um subformulário tiver o foco, o ActiveForm refere-se ao formulário principal. Se nem um formulário nem um subformulário tiver o foco quando utilizar a propriedade ActiveForm, ocorrerá um erro.