Table of contents
TOC
Recolher sumário
Expandir sumário

Método DoCmd.OpenForm (Access)DoCmd.OpenForm Method (Access)

office 365 dev account|Última Atualização: 22/03/2018
|
2 Colaboradores

O método OpenForm executa a ação OpenForm no Visual Basic.The OpenForm method carries out the OpenForm action in Visual Basic.

SintaxeSyntax

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

expressão Uma variável que representa um objeto DoCmd.expression A variable that represents a DoCmd object.

ParâmetrosParameters

NomeNameObrigatório/opcionalRequired/OptionalTipo de dadosData TypeDescriçãoDescription
FormNameFormNameObrigatórioRequiredVariantVariantUma expressão de cadeia de caracteres que é o nome válido de um formulário no banco de dados atual.A string expression that's the valid name of a form in the current database.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.If you execute Visual Basic code containing the OpenForm method in a library database, Access looks for the form with this name first in the library database, and then in the current database.
ViewViewOpcionalOptionalAcFormViewAcFormViewUma constante AcFormView que especifica a exibição na qual o formulário será aberto.A AcFormView constant that specifies the view in which the form will open.O valor padrão é acNormal.The default value is acNormal.
FilterNameFilterNameOpcionalOptionalVariantVariantUma expressão de cadeia de caracteres que é o nome válido de uma consulta no banco de dados atual.A string expression that's the valid name of a query in the current database.
WhereConditionWhereConditionOpcionalOptionalVariantVariantUma expressão de cadeia de caracteres que é uma cláusula WHERE do SQL válida sem a palavra WHERE.A string expression that's a valid SQL WHERE clause without the word WHERE.
DataModeDataModeOpcionalOptionalAcFormOpenDataModeAcFormOpenDataModeUma constante AcFormOpenDataMode que especifica o modo de entrada de dados para o formulário.A AcFormOpenDataMode constant that specifies the data entry mode for the form.Isso se aplica apenas aos formulários abertos no modo Formulário ou no modo Folha de Dados.This applies only to forms opened in Form view or Datasheet view.O valor padrão é acFormPropertySettings.The default value is acFormPropertySettings.
WindowModeWindowModeOpcionalOptionalAcWindowModeAcWindowModeUma constante AcWindowMode que especifica o modo de janela no qual o formulário está aberto.A AcWindowMode constant that specifies the window mode in which the form opens.O valor padrão é acWindowNormal.The default value is acWindowNormal.
OpenArgsOpenArgsOpcionalOptionalVariantVariantUma expressão de cadeia de caracteresA string expression.Essa expressão é usada para definir a propriedade OpenArgs do formulário.This expression is used to set the form's OpenArgs property.Esta configuração pode então ser usada por código em um módulo de formulário, como o procedimento de evento Open.This setting can then be used by code in a form module, such as the Open event procedure.A propriedade OpenArgs também pode ser referida em macros e expressões.The OpenArgs property can also be referred to in macros and expressions.

Por exemplo, suponha que o formulário que você abre é uma lista contínua de clientes.For example, suppose that the form you open is a continuous-form list of clients.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.If you want the focus to move to a specific client record when the form opens, you can specify the client name with the OpenArgs argument, and then use the FindRecord method to move the focus to the record for the client with the specified name.

ComentáriosRemarks

Você pode usar o método OpenForm para abrir um formulário no modo Formulário, Design, Prévia ou Folha de Dados.You can use the OpenForm method to open a form in Form view, form Design view, Print Preview, or Datasheet view.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.You can select data entry and window modes for the form and restrict the records that the form displays.

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).The maximum length of the WhereCondition argument is 32,768 characters (unlike the Where Condition action argument in the Macro window, whose maximum length is 256 characters).

ExemploExample

O exemplo a seguir abre o formulário Funcionários no modo Formulário e exibe somente os registros com Martins no campo LastName. Os registros exibidos podem ser editados e novos registros podem ser adicionados.The following example opens the Employees form in Form view and displays only records with King in the LastName field. The displayed records can be edited, and new records can be added.

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.The following example opens the frmMainEmployees form in Form view and displays only records that apply to the department chosen in the cboDept combo box.Os registros exibidos podem ser editados e novos registros podem ser adicionados.The displayed records can be edited, and new records can be added.

Código de exemplo fornecido por: Bill Jelen, MrExcel.comSample code provided by: Bill Jelen, MrExcel.com

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.The following example shows how to use the WhereCondition argument of the OpenForm method to filter the records displayed on a form as it is opened.

Código de exemplo fornecido por: A Referência do programador do Microsoft Access 2010Sample code provided by: The Microsoft Access 2010 Programmer's Reference

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


Sobre os colaboradoresAbout the contributors

Holy Macro! Books publica livros divertidos para pessoas que usam o Microsoft Office.Holy Macro! Books publishes entertaining books for people who use Microsoft Office.Consulte o catálogo concluído em MrExcel.com.See the complete catalog at MrExcel.com.

Wrox Press é impulsionada pelo programador para programador filosofia. Livros Wrox são escritos por programadores para programadores, ea marca Wrox significa soluções autoritárias para problemas de programação do mundo real.Wrox Press is driven by the Programmer to Programmer philosophy. Wrox books are written by programmers for programmers, and the Wrox brand means authoritative solutions to real-world programming problems.

Confira tambémSee also

ConceitosConcepts

Objeto DoCmdDoCmd Object

© 2018 Microsoft