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.