Compartilhar via


Ação da macro EncontrarRegistro

Aplica-se ao: Access 2013, Office 2013

Você pode usar a ação EncontrarRegistro para localizar a primeira instância de dados que atende aos critérios especificados pelos argumentos EncontrarRegistro. Esses dados podem estar no registro atual, em um registro sucessivo ou anterior, ou no primeiro registro. Você pode localizar registros na folha de dados da tabela ativa, na folha de dados de consulta ou no formulário.

Setting

A ação EncontrarRegistro tem os seguintes argumentos.

Argumento da ação

Descrição

Localizar

Especifica os dados que serão localizados no registro. Digite o texto, o número ou a data que será localizado(a) ou digite uma expressão, que é antecedida por uma sinal de igual (=), na caixa Localizar da seção Argumentos da Ação do painel Construtor de Macros. Você pode usar caracteres curinga. Esse é um argumento obrigatório.

Match

Especifica onde os dados estão localizados no campo. Você pode especificar uma pesquisa dos: dados em qualquer parte do campo (Qualquer Parte do Campo); dados que preenchem o campo inteiro (Campo Inteiro); ou dados localizados no início do campo (Início do Campo). O padrão é Campo Inteiro.

Diferenciar Maiúsc. de Minúsc.

Especifica se a pesquisa diferencia maiúsculas de minúsculas. Clique em Sim (conduzir uma pesquisa com diferenciação de maiúsculas e minúsculas) ou Não (pesquisar sem fazer coincidir exatamente as letras maiúsculas e minúsculas). O padrão é Não.

Pesquisa

Especifica se a pesquisa continua partindo do registro atual e sobe até o início dos registros (Acima); desce até o final dos registros (Abaixo); ou desce até o final dos registros e partindo do início dos registros até o registro atual, para que todos os registros sejam pesquisados (Todos). O padrão é Tudo.

Pesquisar como Formatado

Especifica se a pesquisa inclui dados formatados. Clique em Sim (o Microsoft Office Access 2007 pesquisa os dados à medida que são formatados e exibidos no campo) ou Não (o Access pesquisa os dados à medida que são armazenados no banco de dados, o que nem sempre é o mesmo que quando são exibidos). O padrão é Não. Você pode usar esse recurso para restringir a pesquisa a dados de um formato específico. Por exemplo, clique em Sim e digite 1.234 no argumento Localizar para localizar um valor de 1.234 em um campo formatado para incluir pontos. Clique em Não se desejar digitar 1234 para pesquisar dados nesse campo. Para pesquisar datas, clique em Sim para localizar uma data exatamente como ela está formatada, como 08-Julho-2003. Se você clicar em Não, digite a data do argumento Localizar no formato definido nas configurações regionais do Painel de Controle do Windows. Esse formato é mostrado na caixa Formato de data abreviada localizada na guia Data das configurações regionais. Por exemplo, se a caixa Formato de data abreviada estiver definida como M/d/aa, você poderá digitar 7/8/03, e o Access localizará todas as entradas em um campo Data que correspondem a 8 de julho de 2003, independentemente de como esse campo esteja formatado.

OBSERVAÇÃO: O argumento Pesquisar como Formatado só entrará em vigor se o campo atual for um controle vinculado, o argumento Match estiver definido como Campo Inteiro, o argumento Campo Único Atual estiver definido como Sim e o argumento Match Case estiver definido como Não.

Se você definiu Diferenciar Maiúsc. de Minúsc. como Sim, ou Somente Campo Atual como Não, também precisará definir Pesquisar como Formatado como Sim.

Somente Campo Atual

Especifica se a pesquisa está confinada no campo atual em cada registro ou se inclui todos os campos de cada registro. A pesquisa no campo atual é mais rápida. Clique em Sim (confinar a pesquisa no campo atual) ou Não (pesquisar em todos os campos de cada registro). O padrão é Sim.

Localizar Primeiro

Especifica se a pesquisa começa no primeiro registro ou no atual. Clique em Sim (começar no primeiro registro) ou Não (começar no registro atual). O padrão é Sim.

Comentários

Quando uma macro é executada na ação EncontrarRegistro, o Access pesquisa os dados especificados nos registros (a ordem da pesquisa é determinada pela configuração do argumento Pesquisar ). Quando o Access localiza os dados especificados, eles são selecionados no registro.

A ação EncontrarRegistro equivale a clicar em Localizar na guia Página Inicial, e seus argumentos são os mesmos das opções na caixa de diálogo Localizar e Substituir. Se você definir os argumentos EncontrarRegistro no painel Construtor de Macros e executar a macro, verá as opções correspondentes selecionadas na caixa de diálogo Localizar e Substituir ao clicar em Localizar.

O Access retém os argumentos EncontrarRegistro mais recentes durante uma sessão de banco de dados para que não seja necessário inserir os mesmos critérios várias vezes à medida que são executadas operações subsequentes com a ação EncontrarRegistro. Se você deixar um argumento em branco, o Access usará a configuração mais recente do argumento, conforme definida por uma ação EncontrarRegistro anterior ou na caixa de diálogo Localizar e Substituir.

Quando você deseja localizar um registro usando uma macro, use a ação EncontrarRegistro, e não a ação ExecutarComandodeMenu com o respectivo argumento definido para executar o comando Localizar.

Observação

[!OBSERVAçãO] Embora a ação EncontrarRegistro corresponda ao comando Localizar na guia Página Inicial para tabelas, consultas e formulários, ela não corresponde ao comando Localizar no menu Editar da janela Código. Não é possível usar a ação EncontrarRegistro para pesquisar texto em módulos.

Se o texto selecionado no momento for o mesmo do texto de pesquisa quando a ação EncontrarRegistro for executada, a pesquisa começará imediatamente após a seleção, no mesmo campo da seleção e no mesmo registro. Caso contrário, começará no início do registro atual. Isso permite localizar várias instâncias dos mesmos critérios de pesquisa que podem aparecer em um único registro.

No entanto, observe que, se você usar um botão de comando para executar uma macro que contém a ação FindRecord , a primeira instância dos critérios de pesquisa será encontrada repetidamente. Esse comportamento ocorre porque clicar no botão de comando remove o foco do campo que contém o valor correspondente. A ação FindRecord começará a pesquisar desde o início do registro. Para evitar esse problema, execute a macro usando uma técnica que não altere o foco, como um botão de barra de ferramentas personalizado ou uma combinação de chaves definida em uma macro AutoKeys ou defina o foco na macro para o campo que contém os critérios de pesquisa antes de executar a ação FindRecord .

Nota de segurança Nota de segurança
Avoid using the SendKeys statement or an AutoKeys macro with sensitive or confidential information. A malicious user could intercept the keystrokes and compromise the security of your computer and data.

O mesmo comportamento também ocorre se você usa um botão de comando para executar uma macro que contém a ação EncontrarPróximo.

Para executar a ação EncontrarRegistro em um módulo do VBA (Visual Basic for Applications), use o método FindRecord do objeto DoCmd.

Para pesquisas mais complexas, convém usar a ação de macro ProcurarRegistro.