Método DoCmd.OpenForm (Access)

O método OpenForm executa a ação OpenForm no Visual Basic.

Sintaxe

expression.OpenForm (FormName, View, FilterName, WhereCondition, DataMode, WindowMode, OpenArgs)

expression Uma variável que representa um objeto DoCmd.

Parâmetros

Nome	Obrigatório/Opcional	Tipo de dados	Descrição
FormName	Obrigatório	Variant	Uma expressão de cadeia de caracteres que é o nome válido de um formulário no banco de dados atual. Se você executar o código do Visual Basic contendo o método OpenForm em um banco de dados da biblioteca, o Access procurará o formulário com esse nome primeiro no banco de dados da biblioteca e, em seguida, no banco de dados atual.
View	Optional	AcFormView	Uma constante AcFormView que especifica a exibição na qual o formulário será aberto. O valor padrão é acNormal.
FilterName	Opcional	Variant	Uma expressão de cadeia de caracteres que é o nome válido de uma consulta no banco de dados atual.
WhereCondition	Opcional	Variant	Uma expressão de cadeia de caracteres que é uma cláusula WHERE do SQL válida sem a palavra WHERE.
DataMode	Optional	AcFormOpenDataMode	Uma constante AcFormOpenDataMode que especifica o modo de entrada de dados para o formulário. Isso se aplica apenas aos formulários abertos no modo Formulário ou no modo Folha de Dados. O valor padrão é acFormPropertySettings.
WindowMode	Optional	AcWindowMode	Uma constante AcWindowMode que especifica o modo de janela no qual o formulário é aberto. O valor padrão é acWindowNormal.
OpenArgs	Opcional	Variant	Uma expressão de cadeia de caracteres Essa expressão é usada para definir a propriedade OpenArgs do formulário. Esta configuração pode então ser usada por código em um módulo de formulário, como o procedimento de evento Open. A propriedade OpenArgs também pode ser referida em macros e expressões. Por exemplo, suponha que o formulário aberto seja uma lista de formulário contínuo de clientes. Se quiser que o foco se mova para um registro de cliente específico quando o formulário for aberto, você pode especificar o nome do cliente com o argumento OpenArgs e, em seguida, usar o método FindRecord para mover o foco para o registro do cliente com o nome especificado.

Comentários

Você pode usar o método OpenForm para abrir um formulário no modo Formulário, Design, Prévia de Impressão ou Folha de Dados. Você pode selecionar a entrada de dados e os modos de janela para o formulário e restringir os registros que o formulário exibe.

O comprimento máximo do argumento WhereCondition é de 32.768 caracteres (ao contrário do argumento da ação Where Condition na janela Macro, cujo comprimento máximo é de 256 caracteres).

Exemplo

O exemplo a seguir abre o formulário Funcionários no modo de exibição de Formulário e exibe somente os registros com Martins no campo LastName. Os registros exibidos podem ser editados e novos registros podem ser adicionados.

DoCmd.OpenForm "Employees", , ,"LastName = 'King'"

O exemplo a seguir abre o formulário frmMainEmployees no modo Formulário e exibe apenas os registros que se aplicam ao departamento escolhido na caixa de combinação cboDept. Os registros exibidos podem ser editados e novos registros podem ser adicionados.

Private Sub cmdFilter_Click()
    DoCmd.OpenForm "frmMainEmployees", , , "DepartmentID=" & cboDept.Value
End Sub

O exemplo a seguir mostra como usar o argumento WhereCondition do método OpenForm para filtrar os registros exibidos em um formulário quando ele é aberto.

Private Sub cmdShowOrders_Click()
If Not Me.NewRecord Then
    DoCmd.OpenForm "frmOrder", _
        WhereCondition:="CustomerID=" & Me.txtCustomerID
End If
End Sub

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.