DoCmd.OpenForm (Access)

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

Você pode usar o método OpenForm para abrir um formulário no modo Formulário, Design, Prévia 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).

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


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

Arguments

O seguinte argumento é necessário

FormName (String) - 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.

Optional arguments

Os seguintes argumentos são opcionais

View (AcFormView) - Uma constante AcFormView que especifica a exibição na qual o formulário será aberto. O valor padrão é acNormal.


Os valores possíveis são

acDesign O formulário é aberto no modo Design.
acFormDS O formulário é aberto no modo Folha de Dados.
acFormPivotChart O formulário é aberto no modo Gráfico Dinâmico.
acFormPivotTable O formulário é aberto no modo Tabela Dinâmica.
acLayout O formulário é aberto no modo Layout.
acNormal (Padrão) O formulário é aberto no modo Formulário.
acPreview O formulário é aberto no modo Visualizar Impressão.

FilterName (String) - Uma expressão de cadeia de caracteres que é o nome válido de uma consulta no banco de dados atual.

WhereCondition (String) - Uma expressão de cadeia de caracteres que é uma cláusula WHERE do SQL válida sem a palavra WHERE.

DataMode (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.


Os valores possíveis são

acFormAdd O usuário pode adicionar novos registros mas não pode editar registros existentes.
acFormEdit O usuário pode editar os registros existentes e adicionar novos registros.
acFormPropertySettings O usuário só pode alterar as propriedades do formulário.
acFormReadOnly O usuário só pode exibir registros.

WindowMode (AcWindowMode) - Uma constante AcWindowMode que especifica o modo de janela no qual o formulário é aberto. O valor padrão é acWindowNormal.


Os valores possíveis são

acDialog O formulário ou do relatório Modal e PopUp propriedades são definidas como Sim.
acHidden O formulário ou relatório é ocultado.
acIcon O formulário ou relatório é aberto minimizado na barra de tarefas do Windows.
acWindowNormal (Padrão) O formulário ou relatório é aberto no modo definido pelas suas propriedades.

OpenArgs (String) - 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.