Compartilhar via


Método DoCmd.BrowseTo (Access)

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

Sintaxe

expressão. BrowseTo (ObjectType, ObjectName, PathtoSubformControl, WhereCondition, Page, DataMode)

expression Uma variável que representa um objeto DoCmd.

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
ObjectType Obrigatório AcBrowseToObjectType O tipo de objeto que será procurado.
ObjectName Obrigatório Variantes O objeto carregado dentro do controle de subforma referenciado pelo argumento PathtoSubformControl .
PathtoSubformControl Opcional Variantes Se especificado, o caminho da forma principal do aplicativo para o controle de subforma de destino que carrega o objeto especificado pelo argumento ObjectName .
WhereCondition Opcional Variant Se estiver especificado, substitui a condição Where da fonte de registro de objeto.
Page Opcional Variant Se estiver especificado, define a página do formulário contínuo que se tornará a página atual. Esse argumento é somente web.
DataMode Optional AcFormOpenDataMode Se for especificado, o modo de entrada de dados do formulário.

Comentários

Use o método BrowseTo para navegar entre os objetos no lugar. Você também pode alterar o objeto de origem de um controle de subforma especificando o argumento PathtoSubformControl . Use BrowseTo para navegar do Form1 para o Form2 sem abrir uma nova janela.

O argumento PathtoSubformControl deve ser especificado usando a sintaxe no exemplo a seguir.

Main Form.SubForm Ctrl 1>Form 2.SubForm Ctrl 2>Form 3.SubFormCtrl3

Neste exemplo, o formulário principal é o formulário de nível superior no aplicativo cliente do Access. O argumento PathtoSubformControl deve especificar alternadamente nomes de controle de formulário e subformação que levam do formulário principal para o controle de subformação que é o contêiner do objeto especificado pelo argumento ObjectName . Cada controle de subformulário especificado deve ser um controle no formulário que precede a ele. O caminho deve terminar com um controle de subformulário.

Exemplo

O exemplo de código a seguir abre o formulário EventDS em vigor no modo de edição no controle de subformação NavigationSubform do formulário Principal .

DoCmd.BrowseTo ObjectType:=acBrowseToForm, _ 
ObjectName:="EventDS", _ 
PathToSubformControl:="Main.NavigationSubform", _ 
WhereCondition:="", _ 
Page:="", _ 
DataMode:=acFormEdit

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.