Vous êtes sur la page 1sur 49

1.

REFERNCIA DE MACROS DO MICROSOFT ACCESS

AES DE MACRO E OS PARMETROS DE CADA UMA :

Ao
AbrirConsulta

Descrio
possvel utilizar a ao AbrirConsulta para abrir uma consulta seleo ou de tabela de referncia cruzada no modo Folha de Dados, modo Estrutura ou Visualizar Impresso. Essa ao executa uma consulta ao. Voc pode tambm selecionar um modo de entrada de dados para a consulta.

Parmetros

AbrirFormulrio

Nome da Consulta ->O nome da consulta a ser aberta. A caixa Nome da Consulta na seo Argumentos da Ao da janela Macro exibe todas as consultas no banco de dados atual. Esse um argumento requerido. Se voc executar uma macro contendo a ao AbrirConsulta em um banco de dados biblioteca, o Microsoft Access procurar a consulta com esse nome primeiro no banco de dados biblioteca e depois no banco de dados atual. Exibir ->O modo no qual a consulta ser aberta. Clique em Folha de Dados, Estrutura ou Dica -> Voc pode selecionar uma consulta na janela Banco de Visualizar Impresso na caixa Exibir. O padro Dados e arrast-la para a linha de Folha de Dados. Modo de Dados ->O modo de entrada de dados ao de uma macro. Isso cria para a consulta. Aplica-se somente a consultas automaticamente uma ao abertas no modo Folha de Dados. Clique em AbrirConsulta que abre a Adicionar (o usurio pode adicionar novos consulta no modo Folha de registros, mas no pode editar os registros Dados. existentes), Editar (o usurio pode editar os registros existentes e adicionar novos registros) ou Somente Leitura (o usurio somente pode ver os registros). O padro Editar. Nome do Formulrio ->O nome de o possvel utilizar a ao formulrio a ser aberto. A caixa Nome do AbrirFormulrio para abrir um formulrio no modo Formulrio, Formulrio na seo Argumentos da Ao da janela Macro mostra todos os formulrios no modo Estrutura do formulrio, banco de dados atual. Esse um argumento Visualizar Impresso ou modo requerido. Se voc executar uma macro Folha de Dados. Voc pode contendo a ao AbrirFormulrio em um banco selecionar entradas de dados e de dados biblioteca, o Microsoft Access modos de janela para o procurar o formulrio com esse nome primeiro formulrio e restringir os no banco de dados biblioteca e depois no banco registros exibidos pelo de dados atual. formulrio. Exibir -> O modo em que o formulrio ser aberto. Clique em Formulrio, Estrutura, OBS -> Banco de dados Visualizar Impresso ou Folha de Dados na biblioteca uma coleo de procedimentos e caixa Exibir. O padro Formulrio. Observao A definio do argumento Exibir objetos de banco de dados que anula as definies das propriedades voc pode chamar a partir de qualquer aplicativo. Para utilizar ModoPadro e ModosPermitidos do formulrio. os itens da biblioteca, primeiro Por exemplo, se a propriedade ModosPermitidos de um formulrio for definida como Folha de necessrio estabelecer uma 1.

1.

REFERNCIA DE MACROS DO MICROSOFT ACCESS referncia partindo do banco de dados atual para o banco de dados biblioteca. Essa ao semelhante a clicar no boto Abrir ou no boto Estrutura na janela Banco de Dados depois de selecionar um formulrio na guia Formulrios. Um formulrio pode ser de janela restrita (ele deve ser fechado ou mantido oculto para que o usurio possa realizar qualquer outra ao) ou de janela norestrita (o usurio pode mover para outras janelas enquanto o formulrio est aberto). Ele pode tambm ser um formulrio popup (um formulrio utilizado para reunir ou exibir informaes que permanecem no topo de todas as outras janelas do Microsoft Access). Voc define as propriedades JanelaRestrita e PopUp quando cria a estrutura do formulrio. Caso utilize Normal para o argumento Modo Janela, o formulrio ser aberto no modo especificado pelas definies dessa propriedade. Se voc utilizar Dilogo para o argumento Modo Janela, essas duas propriedades sero definidas como Sim. Um formulrio aberto como oculto ou como um cone retorna ao modo especificado pelas definies de suas propriedades quando voc o exibe ou restaura. Dados, voc ainda poder utilizar a ao AbrirFormulrio para abrir o formulrio no modo Formulrio. Nome do Filtro -> Um filtro que restringe ou classifica os registros do formulrio. possvel digitar o nome tanto de uma consulta existente quanto de um filtro que tenha sido salvo como uma consulta. Entretanto, a consulta deve incluir todos os campos no formulrio que voc esteja abrindo ou que tenha sua propriedade ResultadoDeTodosOsCampos definida como Sim. Condio Onde -> Uma clusula SQL WHERE vlida (sem a palavra WHERE) ou expresso que o Microsoft Access utiliza para selecionar registros a partir da tabela ou consulta base do formulrio. Se voc selecionar um filtro sem o argumento Nome do Filtro, o Microsoft Access aplicar essa clusula WHERE aos resultados do filtro. Para abrir um formulrio e restringir seus registros queles especificados pelo valor de um controle em outro formulrio, utilize a expresso a seguir: [nomedocampo]=Forms![nomedoformulrio]! [nomedocontrole em outro formulrio]

Continuao da Ao AbrirFormulrio

O argumento nomedocampo o nome de um campo na tabela ou consulta base do formulrio que voc deseja abrir. O argumento nomedocontrole em outro formulrio o nome do controle no outro formulrio que contm o valor ao qual voc deseja que os registros no primeiro formulrio correspondam. Observao: O comprimento mximo do argumento Condio Onde de 256 caracteres. Se voc precisar inserir uma clusula SQL WHERE mais complexa, maior que o comprimento mximo, utilize, em vez dela, o mtodo OpenForm do objeto DoCmd no Visual Quando voc abre um formulrio Basic. Voc pode digitar instrues da clusula SQL WHERE com at 32.768 caracteres no com o argumento Modo Janela Visual Basic. definido como Dilogo, o Modo de Dados -> O modo de entrada de dados Microsoft Access suspende a 1.

1.

REFERNCIA DE MACROS DO MICROSOFT ACCESS para o formulrio. Isso se aplica somente aos formulrios abertos no modo Formulrio ou no modo Folha de Dados. Clique em Adicionar (o usurio pode adicionar novos registros, mas no pode editar os registros existentes), Editar (o usurio pode editar os registros existentes e adicionar novos registros) ou Somente Leitura (o usurio somente pode ver os registros). O Dica -> Voc pode selecionar padro Editar. um formulrio na janela Banco de Dados e arrast-lo para a linha Observaes: de ao de uma macro. Isso cria A definio do argumento Modo de Dados automaticamente uma ao anula as definies das propriedades AbrirFormulrio que abre o PermitirEdies, PermitirExcluses, formulrio no modo Formulrio. PermitirAdies e EntradaDeDados do formulrio. Por exemplo, se a propriedade PermitirAdies de um formulrio for definida como No, voc ainda poder utilizar a ao AbrirFormulrio para abrir o formulrio no modo Editar. Alternar para o modo Estrutura enquanto o formulrio est aberto Se voc deixar esse argumento em branco, o remove a definio da maior Microsoft Access abrir o formulrio no parte dos argumentos para o modo de entrada de dados definido pelas formulrio, como as definies propriedades PermitirEdies, dos argumentos Modo de Dados PermitirExcluses, PermitirAdies e e Modo Janela. Elas no tero EntradaDeDados do formulrio. efeito mesmo que o usurio Modo Janela -> O modo da janela em que retorne ao modo Formulrio ou o formulrio aberto. Clique em Normal para ao modo Folha de Dados. que o formulrio fique no modo definido por suas propriedades, Oculto (o formulrio O filtro e a condio WHERE oculto), cone (o formulrio aberto que voc aplicar se tornam a minimizado como uma pequena barra de ttulo definio da propriedade Filtro na parte inferior da tela) ou Dilogo (as do formulrio. propriedades JanelaRestrita e PopUp do formulrio so definidas como Sim). O padro Normal. Voc pode utilizar a ao AbrirMdulo para Nome do Mdulo -> O nome do mdulo que abrir um mdulo especificado do Visual voc deseja abrir. Voc pode deixar este Basic em um procedimento especificado. argumento em branco se quiser procurar um Este pode ser um procedimento Sub, um procedimento Function ou um procedimento procedimento em todos os mdulos padro do de evento. banco de dados, e abrir o mdulo apropriado Comentrios: nesse procedimento. Voc pode utilizar essa ao para abrir um procedimento de evento especificando o Se voc executar uma macro contendo a ao argumento Nome do Mdulo e o argumento AbrirMdulo em um banco de dados biblioteca, Nome do Procedimento. Por exemplo, para o Microsoft Access procurar primeiro o abrir o procedimento de evento Click (Ao Clicar) do boto ImprimirFatura do mdulo com esse nome no banco de dados macro at que o formulrio seja fechado ou ocultado. possvel ocultar um formulrio definindo sua propriedade Visvel como No ao utilizar a ao DefinirValor.
formulrio Pedidos, defina o argumento

AbrirMdulo

1.

1.

REFERNCIA DE MACROS DO MICROSOFT ACCESS


Nome do Mdulo como Form.Pedidos e defina o argumento Nome do Procedimento como ImprimirFatura_Click. Para visualizar o procedimento de evento de um formulrio ou relatrio, o formulrio ou relatrio precisa estar aberto. Esta ao tem o mesmo efeito que selecionar um mdulo na janela Banco de Dados e em seguida, pressionar o boto Estrutura. Esta ao tambm permite que voc especifique um nome de procedimento e procure pelos procedimentos nos mdulos padro de um banco de dados. Dica Voc pode selecionar um mdulo na janela Banco de Dados e arrast-lo at a linha de ao de uma macro. Isto cria automaticamente uma ao AbrirMdulo que abre o mdulo para a seo Declaraes. Para executar a ao AbrirMdulo no Visual Basic, utilize o mtodo OpenModule do objeto DoCmd.

biblioteca e, em seguida, no banco de dados atual. Nome do Procedimento -> O nome do procedimento para o qual voc deseja abrir o mdulo. Se voc deixar este argumento em branco, o mdulo abrir para a seo Declaraes. Observao: Voc precisa inserir um nome vlido no argumento Nome do Mdulo ou Nome do Procedimento.

AbrirRelatrio

Continuao da Ao AbrirRelatrio

possvel utilizar a ao AbrirRelatrio para abrir um relatrio no modo Estrutura ou Visualizar Impresso ou para imprimir o relatrio imediatamente. Voc pode tambm restringir os registros que sero impressos no relatrio. A definio Imprimir para o argumento Exibir imprime o relatrio imediatamente utilizando as definies de impressora atuais, sem abrir a caixa de dilogo Imprimir. Voc pode tambm utilizar a ao AbrirRelatrio para abrir e configurar um relatrio e, em seguida, utilizar a ao Imprimir para imprimi-lo. Por exemplo, convm alterar o relatrio ou utilizar a ao Imprimir para alterar as configuraes da impressora antes de imprimir. O filtro e a condio WHERE que voc aplicar se tornam a definio da propriedade Filtro do relatrio. A ao AbrirRelatrio semelhante a clicar no boto 1.

Nome do Relatrio -> O nome do relatrio a ser aberto. A caixa Nome do Relatrio na seo Argumentos da Ao da janela Macro exibe todos os relatrios no banco de dados atual. Esse um argumento requerido. Se voc executar uma macro contendo a ao AbrirRelatrio em um banco de dados biblioteca, o Microsoft Access procurar pelo relatrio com esse nome primeiro no banco de dados biblioteca e depois no banco de dados atual. Exibir -> O modo no qual o relatrio ser aberto. Clique em Imprimir (imprime o relatrio imediatamente), Estrutura ou Visualizar Impresso na caixa Exibir. O padro Imprimir. Nome do Filtro -> Um filtro que restringe os registros do relatrio. Voc pode digitar o nome de uma consulta existente ou de um filtro que tenha sido salvo como uma consulta. Entretanto, a consulta precisa incluir todos os campos no relatrio que voc est abrindo ou ter sua propriedade ResultadoDeTodosOsCampos definida como Sim. Condio Onde -> Uma clusula SQL WHERE vlida (sem a palavra WHERE) ou expresso que o Microsoft Access utiliza para selecionar registros a partir da tabela ou consulta base do relatrio. Caso selecione um filtro com o argumento Nome do Filtro, o Microsoft Access aplicar essa clusula WHERE aos resultados do filtro. Para abrir um

1.

REFERNCIA DE MACROS DO MICROSOFT ACCESS Estrutura, no boto Visualizar ou no comando Imprimir no menu Arquivo da janela Banco de Dados depois de selecionar um relatrio. Dicas Para imprimir relatrios semelhantes para conjuntos de dados diferentes, utilize um filtro ou uma clusula WHERE para restringir os registros impressos no relatrio. Em seguida, edite uma macro para aplicar um filtro diferente ou alterar o argumento Condio Onde. possvel selecionar um relatrio na janela Banco de Dados e arrast-lo para a linha de ao de uma macro. Isso cria automaticamente uma ao AbrirRelatrio que abre o relatrio no modo Visualizar Impresso. possvel utilizar a ao AbrirTabela para abrir uma tabela no modo Folha de Dados, modo Estrutura ou Visualizar Impresso. Voc pode tambm selecionar um modo de entrada de dados para a tabela. Essa ao semelhante a clicar no boto Abrir ou no boto Estrutura na janela Banco de Dados depois de selecionar uma tabela na guia Tabelas. Dica: Voc pode selecionar uma tabela na janela Banco de Dados e arrast-la para a linha de ao de uma macro. Isso cria automaticamente uma ao AbrirTabela que abre a tabela no modo Folha de Dados. relatrio e restringir seus registros queles especificados pelo valor de um controle em um formulrio, utilize a expresso a seguir: [nomedocampo]=Forms![nomedoformulrio] ! [nomedocontrole no formulrio] O argumento nomedocampo o nome de um campo na tabela ou consulta base do relatrio que voc deseja abrir. O argumento nomedocontrole no formulrio o nome do controle no formulrio que contm o valor ao qual voc deseja que os registros no relatrio correspondam. Observao: O comprimento mximo do argumento Condio Onde de 256 caracteres. Caso precise inserir uma clusula SQL WHERE mais complexa e maior do que esse comprimento mximo, utilize, em vez disso, o mtodo OpenReport do objeto DoCmd no Visual Basic. Voc pode inserir instrues da clusula SQL WHERE com at 32.768 caracteres no Visual Basic. Nome da Tabela -> O nome da tabela a ser aberta. A caixa Nome da Tabela na seo Argumentos da Ao da janela Macro exibe todas as tabelas no banco de dados atual. Esse um argumento requerido. Se voc executar uma macro contendo a ao AbrirTabela em um banco de dados biblioteca, o Microsoft Access procurar pela tabela com esse nome primeiro no banco de dados biblioteca e depois no banco de dados atual. Exibir -> O modo no qual a tabela aberta. Clique em Folha de Dados, Estrutura ou Visualizar Impresso na caixa Exibir. O padro Folha de Dados. Modo de Dados -> O modo de entrada de dados para a tabela. Aplica-se somente a tabelas abertas no modo Folha de Dados. Clique em Adicionar (o usurio pode adicionar novos registros, mas no pode editar os registros existentes), Editar (o usurio pode editar os

AbrirTabela

1.

1.

REFERNCIA DE MACROS DO MICROSOFT ACCESS Alternar para o modo Estrutura enquanto a tabela est aberta remove a definio do argumento Modo de Dados da tabela. Essa definio no tem efeito mesmo que o usurio retorne ao modo Folha de Dados. Nome do Menu -> O nome do menu suspenso a possvel utilizar a ao ser adicionado barra de menu personalizada ou AdicionarMenu para criar: global. Digite o nome do menu na caixa Nome do Menu, na seo Argumentos da Ao da Uma barra de menu janela Macro. Esse um argumento requerido personalizada para um para barras de menu personalizadas e globais. formulrio ou relatrio. A barra de menu personalizada Esse argumento ignorado para menus de atalho personalizados e globais. substitui a barra de menu interna para o formulrio ou Para criar uma tecla de acesso de forma que voc possa utilizar o teclado para escolher o relatrio. menu, digite um "e" comercial (&) antes da letra Um menu de atalho que voc deseja ser a tecla de acesso. Essa letra personalizado para um ser sublinhada no nome do menu na barra de formulrio, controle de menu. formulrio ou relatrio. O menu de atalho personalizado Nome da Macro do Menu -> O nome do grupo de macros que contm as macros para os substitui o menu de atalho comandos do menu. Esse um argumento interno para o formulrio, requerido. Se voc executar uma macro que controle de formulrio ou contm a ao AdicionarMenu em um banco de relatrio. Uma barra de menu global. A dados Biblioteca, o Microsoft Access procurar um grupo de macros com esse nome somente no barra de menu global banco de dados atual. substitui a barra de menu interna para todas as janelas Texto da Barra de Status -> O texto a ser do Microsoft Access, exceto exibido na barra de status quando o menu selecionado. Esse argumento ignorado para naquelas em que voc tiver menus de atalho personalizados e menus de adicionado uma barra de menu personalizada para um atalho globais. formulrio ou relatrio. Um menu de atalho global. O menu de atalho global substitui o Observao : Embora no Microsoft Access voc ainda possa criar todos esses tipos de menu de atalho interno para menus personalizados utilizando macros que campos em folhas de dados da tabela e consulta, formulrios no contm aes AdicionarMenu (e todos os menus modo Formulrio, modo Folha de personalizados existentes que voc tenha criado Dados e Visualizar Impresso e utilizando macros ainda funcionem), recomendvel cri-los utilizando a caixa de relatrios em Visualizar registros existentes e adicionar novos registros) ou Somente Leitura (o usurio somente pode ver os registros). O padro Editar.

AdicionarMenu

1.

1.

REFERNCIA DE MACROS DO MICROSOFT ACCESS Impresso, exceto naquelas em que voc tiver adicionado um menu de atalho personalizado para um formulrio, controle de formulrio ou relatrio. dilogo Personalizar, disponvel apontando para Barras de Ferramentas no menu Exibir e clicando em Personalizar. Enquanto a caixa de dilogo Personalizar est sendo exibida, voc pode facilmente criar um novo menu ou personalizar um menu interno. No Possui Argumentos

AlarmeSonoro

possvel utilizar a ao AlarmeSonoro para emitir um alarme sonoro pelo alto-falante do computador. possvel utilizar a ao AlarmeSonoro para sinalizar as ocorrncias a seguir: Ocorreram alteraes importantes na tela. Foi digitado um tipo incorreto de dados em um controle. Por exemplo, o usurio inseriu dados numricos em um controle caixa de texto. Uma macro atingiu um ponto especfico ou completou suas aes. A freqncia e durao do sinal sonoro dependem do hardware, que pode variar de um computador para outro possvel utilizar a ao Ampulheta para alterar o ponteiro do mouse para uma imagem de uma ampulheta (ou outro cone que voc escolha) enquanto uma macro est sendo executada. Essa ao pode fornecer uma indicao visual de que a macro est sendo executada. Isso especialmente til quando uma ao de macro ou a prpria macro demorar muito para ser executada. No Microsoft Windows 95, o cone mostrado por essa ao aquele que voc definiu para Ocupado na guia Ponteiros da caixa de dilogo

Ampulheta

Ampulheta Ativa -> Clique em Sim (exibe o cone) ou em No (exibe o ponteiro normal do mouse) na caixa Ampulheta Ativa na seo Argumentos da Ao da janela Macro. O padro Sim. Voc utilizar essa ao com freqncia se tiver desativado o eco utilizando a ao Eco. Quando o eco est desativado, o Microsoft Access suspende as atualizaes da tela at que a execuo da macro seja concluda. O Microsoft Access redefine automaticamente o argumento Ampulheta Ativa como No quando a execuo da macro concluda.

1.

1.

REFERNCIA DE MACROS DO MICROSOFT ACCESS Propriedades de Mouse do Painel de Controle do Windows (O padro um cone de ampulheta animado). No Windows NT, esse o cone que voc definiu para Aguardar na caixa de dilogo Cursores do Painel de Controle do Windows (O padro tambm um cone de ampulheta). Em ambos os casos, voc pode escolher outro cone se desejar. possvel utilizar a ao AplicarFiltro para aplicar um filtro, uma consulta ou uma clusula SQL WHERE a uma tabela, formulrio ou relatrio para restringir ou classificar os registros na tabela ou os registros da tabela ou consulta base ou consulta do formulrio ou relatrio.

AplicarFiltro

Nome do Filtro -> O nome de um filtro ou consulta que restringe ou classifica os registros da tabela, formulrio ou relatrio. Digite o nome de uma consulta existente ou um filtro que tenha sido salvo como uma consulta na caixa Nome do Filtro na seo Argumentos da Ao da janela Macro.

Condio Onde Uma -> Clusula SQL WHERE vlida (sem a palavra WHERE) ou uma expresso que restringe os registros da Para relatrios, possvel utilizar tabela, formulrio ou relatrio. essa ao somente em uma macro Observao: Em uma expresso de argumento especificada pela propriedade de Condio Onde, o lado esquerdo da expresso normalmente contm um nome de campo da evento AoAbrir do relatrio tabela ou consulta base para o formulrio ou possvel aplicar um filtro ou relatrio. O lado direito da expresso consulta a um formulrio no geralmente contm os critrios que voc deseja modo Formulrio ou no modo aplicar a esse campo, de forma a restringir ou Folha de Dados. classificar os registros. O filtro e a condio WHERE Por exemplo, os critrios podem ser o nome de que voc aplicar se tornam a um controle em outro formulrio que contm o definio da propriedade Filtro valor ao qual voc deseja que os registros do do formulrio ou relatrio. primeiro formulrio correspondam. O nome do Para tabelas e formulrios, essa controle deve ser totalmente qualificado, por ao semelhante a clicar em exemplo: Aplicar Filtro/Classificao no menu Registros ou clicar em Forms!nomedoformulrio!nomedocontrole O comprimento mximo do argumento Aplicar Filtro na barra de ferramentas. O comando de menu Condio Onde de 256 caracteres. Se voc precisar inserir uma clusula SQL WHERE ou boto se aplicam ao filtro maior, utilize o mtodo ApplyFilter do objeto criado mais recentemente na DoCmd no Visual Basic. Voc pode inserir tabela ou formulrio, enquanto

1.

1.

REFERNCIA DE MACROS DO MICROSOFT ACCESS que a ao AplicarFiltro se aplica instrues de clusula SQL WHERE com at ao filtro ou consulta especificada. 32.768 caracteres no Visual Basic

Continuao da Ao AplicarFiltro

Se voc apontar para Filtrar no menu Registros e, em seguida, clicar em Filtrar/Classificar Avanado depois de executar a ao AplicarFiltro, a janela Filtrar/Classificar Avanado mostrar os critrios de filtragem que voc havia selecionado com essa ao. Para remover um filtro e exibir todos os registros de uma tabela ou formulrio, possvel utilizar a ao MostrarTodosRegistros, o comando Remover Filtro/Classificao no menu Registros ou Remover Filtro na barra de ferramentas. Quando voc salva uma tabela ou formulrio, o Microsoft Access salva qualquer filtro definido atualmente naquele objeto, mas no aplica automaticamente o filtro da prxima vez em que o objeto for aberto (embora aplique automaticamente qualquer classificao que voc tenha aplicado ao objeto antes de salvlo). Se voc desejar aplicar um filtro automaticamente quando um formulrio aberto pela primeira vez, especifique uma macro contendo a ao AplicarFiltro ou um procedimento de evento contendo o mtodo ApplyFilter do objeto DoCmd como a definio da propriedade de evento AoAbrir do formulrio. Voc pode tambm aplicar um filtro utilizando a ao AbrirFormulrio ou AbrirRelatrio ou seus mtodos correspondentes. Para aplicar automaticamente um filtro 1.

Observao: necessrio utilizar um ou os dois argumentos. Voc pode utilizar o argumento Nome do Filtro se j tiver definido um filtro que fornea os dados apropriados. possvel utilizar o argumento Condio Onde para inserir diretamente os critrios de restrio. Se voc utilizar ambos os argumentos, o Microsoft Access aplicar a clusula WHERE aos resultados do filtro.

1.

REFERNCIA DE MACROS DO MICROSOFT ACCESS quando uma tabela aberta pela primeira vez, possvel abrir a tabela utilizando uma macro contendo a ao AbrirTabela, imediatamente seguida pela ao AplicarFiltro.

CaixaDeMensagem

possvel utilizar a ao CaixaDeMensagem para exibir uma caixa de mensagem contendo uma mensagem de aviso ou de informao. Por exemplo, possvel utilizar a ao CaixaDeMensagem com macros de validao. Quando um controle ou registro no passa por uma condio de validao na macro, uma caixa de mensagem pode exibir uma mensagem de erro e fornecer instrues sobre o tipo de dados que deve ser inserido.

CancelarEvento

possvel utilizar a ao CancelarEvento para cancelar o evento que fez com que o Microsoft Access executasse a macro contendo essa ao. O nome da macro a definio de uma propriedade de evento como AntesDeAtualizar, AoAbrir, AoDescarregar ou AoImprimir. Observao possvel utilizar a ao CancelarEvento com o evento MouseDown somente para cancelar o evento que ocorre quando voc clica com o boto direito do mouse em um objeto. Se a configurao da propriedade de evento AoClicarDuasVezes de um controle especificar uma macro que contm a ao CancelarEvento, a ao cancelar o evento DblClick. Para eventos que podem ser cancelados, o

Mensagem -> O texto na caixa de mensagem. Digite o texto da mensagem na caixa Mensagem da seo Argumentos da Ao da janela Macro. possvel digitar at 255 caracteres ou inserir uma expresso (precedida por um sinal de igual). AlarmeSonoro -> Especifica se o alto-falante do seu computador emitir um aviso sonoro uma vez quando a mensagem for exibida. Clique em Sim (soa o aviso sonoro) ou No (no soa o aviso sonoro). O padro Sim. Tipo -> O tipo da caixa de mensagem. Cada tipo tem um cone diferente. Clique em Nenhum, Crtico, Aviso?, Aviso! ou Informao. O padro Nenhum. Ttulo -> O texto exibido na barra de ttulo da caixa de mensagem. Por exemplo, possvel fazer com que a barra de ttulo exiba "Validao do Cdigo do Cliente ". Se voc deixar esse argumento em branco, ser exibido o texto "Microsoft Access". No Possui parmetros Em um formulrio, geralmente voc utiliza a ao CancelarEvento em uma macro de validao com a propriedade de evento AntesDeAtualizar. Quando um usurio insere dados em um controle ou registro, o Microsoft Access executa a macro antes de adicionar os dados ao banco de dados. Se os dados no satisfizerem as condies de validao na macro, a ao CancelarEvento cancelar o processo de atualizao antes que ele seja iniciado.

1.

1.

REFERNCIA DE MACROS DO MICROSOFT ACCESS


comportamento padro para o evento (isto , o que o Microsoft Access normalmente faz quando o evento ocorre) ocorre depois que a macro para o evento executada. Isso permite cancelar o comportamento padro. Por exemplo, quando voc clica duas vezes em uma palavra onde est o ponto de insero em uma caixa de texto, o Microsoft Access normalmente seleciona a palavra. possvel cancelar esse comportamento padro na macro para o evento DblClick e executar alguma outra ao, como abrir um formulrio que contm informaes sobre os dados na caixa de texto. Para eventos que no podem ser cancelados, o comportamento padro ocorre antes que a macro seja executada.

Freqentemente voc utiliza essa ao com a ao CaixaDeMensagem para indicar que os dados no satisfizeram as condies da validao e fornecer informaes teis sobre o tipo de dados que deveria ser inserido.

CopiarObjeto

Destino -> Um caminho e um nome de arquivo vlidos para o banco de dados de destino. Digite o caminho e o nome do arquivo na caixa Banco de Dados de Destino na seo Argumentos da Ao da janela Macro. Deixe esse argumento em branco se desejar selecionar o banco de dados atual. Se voc executar uma macro contendo a ao CopiarObjeto em um banco de dados Biblioteca e deixar esse argumento em branco, o Microsoft Access copiar o objeto para o banco de dados Biblioteca. Novo Nome -> Um novo nome para o objeto. Quando copiar para um banco de dados diferente, deixe esse argumento em branco para manter o nome atual. A ao CopiarObjeto Tipo do Objeto de Origem -> O tipo do objeto semelhante a selecionar um objeto na janela Banco de Dados, que voc deseja copiar. Clique em Tabela, clicar em Copiar no menu Editar Consulta, Formulrio, Relatrio, Macro ou Mdulo. Para copiar o objeto selecionado na e, ento, clicar em Colar, no menu Editar. A caixa de dilogo janela Banco de Dados, deixe esse argumento em branco. Colar Como exibida para que voc possa dar um novo nome ao Nome do Objeto de Origem -> O nome do objeto a ser copiado. A caixa Nome do Objeto objeto. A ao CopiarObjeto de Origem mostra todos os objetos no banco de executa todas essas etapas dados do tipo selecionado pelo argumento Tipo automaticamente. do Objeto de Origem. Na caixa Nome do Objeto Voc pode tambm copiar um de Origem, clique no objeto a ser copiado. Se objeto selecionado na janela voc deixar o argumento Tipo do Objeto de Banco de Dados ou um objeto Origem em branco, deixe tambm esse aberto na janela Tabela, janela argumento em branco. Se voc executar uma Consulta, janela Formulrio, janela Relatrio, janela Macro ou macro que contm a ao CopiarObjeto em um banco de dados biblioteca, o Microsoft Access janela Mdulo clicando em Salvar Como/Exportar, no menu ir procurar o objeto com esse nome primeiro no banco de dados biblioteca e depois no banco de Arquivo. A caixa de dialogo possvel utilizar a ao CopiarObjeto para copiar o objeto de banco de dados especificado para outro banco de dados do Microsoft Access ou para o mesmo banco de dados com um novo nome. Por exemplo, possvel copiar ou efetuar backup de um objeto existente em um outro banco de dados ou criar rapidamente um objeto semelhante com algumas alteraes. 1.

1.

REFERNCIA DE MACROS DO MICROSOFT ACCESS Salvar Como oferece a opo de salvar uma cpia do objeto no banco de dados atual com um novo nome ou salvar o objeto em outro banco de dados. Caso esse objeto j tiver sido salvo e voc salv-lo no banco de dados atual com um novo nome, a verso original ainda existir com o seu nome anterior. O caminho e o nome de arquivo do banco de dados de destino devem existir antes de a macro executar a ao CopiarObjeto. Se eles no existirem, o Microsoft Access exibir uma mensagem de erro. Voc pode utilizar a ao DefinirAvisos para ativar ou desativar as mensagens do sistema. Executar esta ao com o argumento Avisos Ativos definido como No tem o mesmo efeito que pressionar ENTER sempre que um aviso ou caixa de mensagem for exibido. Tipicamente, um boto OK ou Sim escolhido em resposta ao aviso ou mensagem. Quando a macro termina, o Microsoft Access ativa automaticamente a exibio das mensagens do sistema. Freqentemente, voc utilizar esta ao com a ao Eco, que oculta os resultados de uma macro at ela terminar. Voc pode utilizar a ao DefinirAvisos para ocultar os avisos e tambm as caixas de mensagem. Voc pode utilizar a ao DefinirItemDoMenu para definir dados atual. necessrio digitar um valor tanto para um quanto para ambos os argumentos Banco de Dados de Destino e Novo Nome para essa ao. Se voc deixar os argumentos Tipo do Objeto de Origem e Nome do Objeto de Origem em branco, o Microsoft Access copiar o objeto selecionado na janela Banco de Dados. Para selecionar um objeto na janela Banco de Dados, possvel utilizar a ao SelecionarObjeto com o argumento Na Janela Banco de Dados definido como Sim. Avisos Ativos -> Especifica se as mensagens do sistema so exibidas. Clique em Sim (para ativar as mensagens do sistema) ou No (para no desativar as mensagens do sistema) na caixa Avisos Ativos na seo Argumentos da Ao da janela Macro. O padro No. Voc pode utilizar esta ao para evitar que avisos modais e caixas de mensagem interrompam a macro. Entretanto, as mensagens de erro so sempre exibidas. Alm disso, o Microsoft Access exibe qualquer caixa de dilogo que exija entrada que no seja apenas a escolha de um boto ( como OK, Cancelar, Sim ou No) por exemplo, qualquer caixa de dilogo que exija que voc digite texto ou selecione uma dentre vrias opes. Cuidado : Embora a ao DefinirAvisos possa simplificar as interaes com macros, voc precisa ser cuidadoso ao desativar as mensagens do sistema. Em algumas situaes, voc no desejar continuar uma macro se uma determinada mensagem de aviso for exibida. A menos que voc esteja seguro das conseqncias de todas as aes de macro, voc deve evitar usar esta ao. ndice de Menu -> O ndice do menu que contm o comando cujo estado voc deseja

Continuao da Ao CopiarObjeto

DefinirAvisos

DefinirItemDoMenu

1.

1.

REFERNCIA DE MACROS DO MICROSOFT ACCESS o estado dos itens de menu (ativado ou desativado, com ou sem marca de verificao) na barra de menu personalizada ou barra de menu global da janela ativa. Observao -> A ao DefinirItemDoMenu s funciona com barras de menu personalizadas e barras de menu globais criadas atravs da utilizao de macros de barra de menu. A ao DefinirItemDoMenu foi includa nesta verso do Microsoft Access somente por questes de compatibilidade com as verses anteriores. Ela no funciona com a nova funcionalidade das barras de comando. Entretanto, voc pode utilizar as propriedades Enable e State no Visual Basic para desativar ou ativar e para marcar ou desmarcar os itens nas novas barras de menu, barras de ferramentas e menus de atalho. A ao DefinirItemDoMenu s funciona em uma barra de menu personalizada ou barra de menu global para a janela ativa. Ela no funciona nas barras de menu internas do Microsoft Access, e se a janela ativa no tiver uma barra de menu personalizada ou uma barra de menu global, a execuo de uma macro contendo a ao DefinirItemDoMenu causar um erro em tempo de execuo. Observe que uma barra de menu global, se voc tiver definido uma, substitui a barra de menu interna para todas as janelas do Microsoft Access, exceto onde voc tiver adicionado uma barra de menu 1. definir. Digite um valor Inteiro, comeando a partir de 0, para o ndice do menu desejado na barra de menu personalizada ou barra de menu global para a janela ativa. Digite o valor do ndice na caixa ndice de Menu na seo Argumentos da Ao da janela Macro. O ndice relativo posio do menu na macro de barra de menu para a barra de menu personalizada ou para a barra de menu global (a posio da ao AdicionarMenu deste menu na macro da barra de menu, contando a partir de 0). A exibio da barra de menu poder ser um tanto diferente, uma vez que voc pode utilizar expresses condicionais na macro de barra de menu para ocultar ou exibir itens de menu personalizados. Este um argumento requerido. Se voc selecionar um menu com esse argumento e deixar vazios os argumentos ndice de Comando e ndice de Subcomando, voc poder ativar ou desativar o prprio nome do menu. Voc no poder, contudo, ativar ou desativar um nome de menu (o Microsoft Access ignora as definies Ativar e Desativar do argumento Sinalizador para nomes de menu). ndice de Comando -> O ndice do comando cujo estado voc deseja definir. Digite um valor Inteiro, comeando a partir de 0, para o ndice do comando desejado no menu selecionado pelo argumento ndice de Menu. O ndice relativo posio do comando no grupo de macro que define o menu selecionado para a barra de menu personalizada ou barra de menu global (a posio da macro deste comando no grupo de macro, contanto a partir de 0). A exibio do menu pode ser um tanto diferente, uma vez que voc pode utilizar expresses condicionais no grupo de macro do menu para ocultar ou exibir comandos de menu personalizados. ndice de Subcomando ->O ndice do subcomando cujo estado voc deseja definir. Isto s se aplica se o comando desejado tem um submenu. Digite um valor Inteiro, comeando a partir de 0, para o ndice do subcomando desejado no submenu selecionado pelo argumento ndice de Comando. O ndice relativo posio do subcomando no grupo de menu que define o submenu selecionado para a

1.

REFERNCIA DE MACROS DO MICROSOFT ACCESS personalizada para um formulrio ou relatrio. Voc pode utilizar esta ao para definir o estado dos comandos e subcomandos de menu, mas no subcomandos de subcomandos. Para executar a ao DefinirItemDoMenu no Visual Basic, utilize o mtodo SetMenuItem do objeto DoCmd. barra de menu personalizada ou barra de menu global (a posio da macro deste subcomando no grupo de macro, comeando a partir de 0). Sinalizador -> O estado para o qual voc deseja definir o comando ou subcomando. Clique em Cinza (para desativar o comando ele aparece esmaecido), Anular Cinza (para ativ-lo), Ativar (para colocar uma marca de verificao ao lado do comando normalmente indicando que foi selecionado ou alternado) ou Desativar (para remover a marca). O padro Anular Cinza.
Item -> O nome do campo, controle ou propriedade cujo valor voc deseja definir. Digite o nome do campo, do controle ou da propriedade na caixa Item na seo Argumentos da Ao da janela Macro. Voc precisa utilizar a sintaxe completa para se referir a este item, como em nomedocontrole (para um controle no formulrio ou relatrio a partir do qual a macro foi chamada) ou Forms!nomedoformulrio!nomedocontrole. Este um argumento requerido. Expresso -> A expresso que o Microsoft Access utiliza para definir o valor deste item. Voc precisa sempre utilizar a sintaxe completa para se referir a qualquer um dos objetos na expresso. Por exemplo, para aumentar em 10 por cento o valor em um controle Salrio de um formulrio Funcionrios, utilize Forms!Funcionrios!Salrio*1.1. Este um argumento requerido. Observao: Voc no deve utilizar um sinal de igualdade (=) antes da expresso desse argumento. Se voc o fizer, o Microsoft Access avaliar a expresso e, em seguida, usar este valor como expresso nesse argumento. Isto pode produzir resultados inesperados se a expresso for uma seqncia. Por exemplo, se voc digitar ="Seqncia1" para este argumento, o Microsoft Access primeiro avaliar a expresso como Seqncia1. Ele ento usar Seqncia1 como expresso nesse argumento, esperando encontrar um controle ou propriedade chamada Seqncia1 no formulrio ou relatrio que chamou a macro. Voc pode utilizar esta ao para definir um valor para um campo ou controle de um formulrio, uma folha de dados de formulrio ou um relatrio. Voc tambm pode definir o valor para quase todas as propriedades de controle, formulrio ou relatrio em qualquer modo. Para descobrir se uma determinada propriedade pode ser definida pela utilizao de uma macro e em quais modos ela pode ser definida, consulte o tpico sobre essa propriedade. Voc pode tambm definir o valor de um campo na tabela base de um formulrio mesmo que o formulrio no contenha um controle acoplado ao campo. Utilize a sintaxe Forms!nomedoformulrio!nomedocampo na caixa Item para definir o valor de tal campo. Voc tambm pode se referir a um campo na tabela base de um relatrio utilizando a sintaxe Reports!nomedorelatrio!nomedocampo , mas precisa haver um controle no relatrio acoplado a esse campo ou o campo precisa estar referido em um controle calculado no relatrio. Quando voc define o valor de um controle em um formulrio, a ao DefinirValor no aciona as regras de validao do controle no nvel do formulrio, mas aciona as regras de validao do

DefinirValor

Voc pode utilizar a ao DefinirValor para definir o valor de um campo, controle ou propriedade do Microsoft Access em um formulrio, na folha de dados de um formulrio, ou em um relatrio. Observao: Voc no pode utilizar a ao DefinirValor para definir o valor dos controles a seguir: Controles acoplados e controles calculados em relatrios. Controles calculados em formulrios.

Dica: Voc pode utilizar a ao DefinirValor para ocultar ou exibir um formulrio no modo Formulrio. Insira Forms!nomedoformulrio.Visvel na caixa Item e No ou Sim na caixa Expresso. A definio da propriedade Visvel de um formulrio modal como No oculta o formulrio e o torna no modal. A definio da propriedade como Sim exibe o formulrio e o torna modal novamente.

1.

1.

REFERNCIA DE MACROS DO MICROSOFT ACCESS A alterao do valor ou o acrscimo de novos dados em um controle pelo uso da ao DefinirValor em uma macro no aciona eventos tais como BeforeUpdate, BeforeInsert ou Change que ocorrem quando voc altera ou insere dados nesses controles atravs da interface do usurio. Esses eventos tambm no ocorrem se voc definir o valor do controle utilizando o Visual Basic.
campo base no nvel de tabela se o controle for um controle acoplado. A ao DefinirValor tambm aciona o reclculo, mas este pode no acontecer imediatamente. Para acionar um redesenho imediato e forar a concluso do reclculo, utilize a ao RedesenharObjeto. O valor que voc define em um controle utilizando a ao DefinirValor tambm no afetado por uma mscara de entrada definida na propriedade MscaraDeEntrada do controle ou do campo base. Para alterar o valor de um controle, voc pode utilizar a ao DefinirValor em uma macro especificada pela propriedade de evento ApsAtualizar do controle. Entretanto, voc no pode utilizar a ao DefinirValor em uma macro especificada pela propriedade de evento AntesDeAtualizar de um controle para alterar o valor do controle (embora voc possa utilizar DefinirValor para alterar o valor de outros controles). Voc tambm pode utilizar a ao DefinirValor em uma macro especificada pela propriedade AntesDeAtualizar ou ApsAtualizar de um formulrio para alterar o valor de qualquer um dos controles do registro atual.

Eco

possvel utilizar a ao Eco para especificar se o eco est ativo. Por exemplo, voc pode utilizar essa ao para ocultar ou exibir os resultados de uma macro enquanto ela est sendo executada. possvel executar a ao Eco mais de uma vez em uma macro. Isso permite que voc altere o texto da barra de status durante a execuo de uma macro.

Eco Ativo -> Clique em Sim (ativar o eco) ou em No (desativar o eco) na caixa Eco Ativo na seo Argumentos da Ao da janela Macro. O padro Sim. Texto da Barra de Status -> O texto a ser exibido na barra de status quando o eco est ativo. Por exemplo, quando o eco est desativado, a barra de status pode exibir "A macro est sendo executada."

EncontrarPrximo LocalizarPrximo

Quando o Microsoft Access executa uma macro, as atualizaes da tela freqentemente mostram informaes que no so essenciais ao funcionamento da macro. Ao definir o argumento Eco Ativo como No, a macro ser Se voc desativar o eco, poder executada sem atualizar a tela. Quando a macro utilizar a ao Ampulheta para alterar o ponteiro do mouse para concluda, o Microsoft Access um cone de ampulheta (ou automaticamente reativa o eco e redesenha a janela. A definio No para o argumento Eco qualquer cone de ponteiro do Ativo no afeta a macro ou seus resultados. mouse que voc tenha definido A ao Eco no suprime a exibio de caixas de para "Ocupado" no Microsoft dilogo de janelas restritas, como as mensagens Windows 95 ou "Aguardar" no Windows NT) para fornecer uma de erro, ou formulrios pop-up, como folhas de indicao visual de que a macro propriedades. Voc pode utiliz-las para reunir ou exibir informaes quando o eco est est sendo executada. desativado. Utilize a ao DefinirAvisos para desativar todas as mensagens ou caixas de dilogo, exceto as caixas de mensagens de erro e as caixas de dilogo que requerem que o usurio insira informaes. possvel utilizar a ao Esta Ao no possui Parmetros.

1.

1.

REFERNCIA DE MACROS DO MICROSOFT ACCESS LocalizarPrximo para localizar o prximo registro que satisfaz os critrios especificados pela ao LocalizarRegistro anterior ou a caixa de dilogo Localizar no Campo, disponvel clicando em Localizar no menu Editar. Voc pode utilizar a ao LocalizarPrximo para pesquisar registros repetidamente. Por exemplo, possvel mover sucessivamente por todos os registros para um cliente especfico. Essa ao tem o mesmo efeito de utilizar o boto Localizar Prximo na caixa de dilogo Localizar no Campo. Observao: Embora a ao LocalizarRegistro corresponda ao comando Localizar do menu Editar para tabelas, consultas e formulrios, ela no corresponde ao comando Localizar do menu Editar da janela Mdulo. No possvel utilizar a ao LocalizarRegistro ou a ao LocalizarPrximo para localizar textos em mdulos. Dica : Se voc tiver definido o argumento Somente Campo Atual da ao LocalizarRegistro como Sim, talvez precise utilizar a ao IrParaControle para mover o foco para o controle contendo os dados que voc est localizando antes de utilizar a ao LocalizarPrximo. A ao LocalizarPrximo no tem argumentos. A ao LocalizarPrximo encontra o prximo registro que satisfaz os critrios definidos pela ao LocalizarRegistro ou na caixa de dilogo Localizar no Campo. Os argumentos para a ao LocalizarRegistro so compartilhados com as opes da caixa de dilogo Localizar no Campo. Para definir os critrios de localizao, utilize a ao LocalizarRegistro. Normalmente, voc insere uma ao LocalizarRegistro em uma macro e, depois, utiliza a ao LocalizarPrximo para localizar registros subseqentes que satisfazem os mesmos critrios. Para localizar registros somente quando uma determinada condio for satisfeita, voc pode inserir uma expresso condicional na coluna Condio da linha de ao para a ao LocalizarPrximo.

EncontrarRegistro LocalizarRegistro

possvel utilizar a ao LocalizarRegistro para localizar a primeira instncia de dados que satisfazem os critrios especificados pelos argumentos LocalizarRegistro. Ela pode estar no registro atual, em um registro subseqente ou anterior ou no primeiro registro. Voc pode localizar registros na folha de dados da tabela, na folha de dados da consulta, na folha de dados do formulrio

Localizar -> Especifica os dados que voc deseja localizar no registro. Insira o texto, nmero ou data que deseja localizar ou digite uma expresso, que precedida por um sinal de igual (=), na caixa Localizar na seo Argumentos da Ao da janela Macro. Voc pode utilizar caracteres curinga. Esse um argumento requerido. Coincidir -> Especifica onde os dados esto localizados no campo. Voc pode especificar uma localizao de dados em qualquer parte do campo (Qualquer Parte do Campo), de dados

1.

1.

REFERNCIA DE MACROS DO MICROSOFT ACCESS


ou no formulrio ativos. que preenchem todo o campo (Campo Inteiro) ou de dados localizados no incio do campo (Incio do Campo). O padro Quando uma macro executa uma ao Campo Inteiro. LocalizarRegistro, o Microsoft Access Maiscula/minscula -> Especifica se a localizao coincide procura os dados especificados nos registros maisculas e minsculas (letras maisculas e minsculas devem (a ordem da localizao determinada pela ter correspondncia exata). Clique em Sim (realizar uma definio do argumento Localizar). Quando localizao que coincide maisculas de minsculas) ou No o Microsoft Access encontra os dados (localizao sem correspondncia exata de letras maisculas e especificados, esses dados so selecionados minsculas). O padro No. no registro. Localizar -> Especifica se a localizao realizada a partir do A ao LocalizarRegistro equivalente a registro atual at o incio dos registros (Acima), at o final dos clicar em Localizar, no menu Editar, e seus registros (Abaixo) ou at o final dos registros e depois a partir argumentos so os mesmos das opes na do incio dos registros at o registro atual, de maneira que todos caixa de dilogo Localizar no Campo, os registros so localizados (Tudo). O padro Tudo. disponvel clicando em Localizar no menu Localizar Como Formatado -> Especifica se a localizao Editar. Se voc definir os argumentos inclui dados formatados. Clique em Sim (o Microsoft Access LocalizarRegistro na janela Macro e, depois, localiza os dados da maneira como eles esto formatados e executar a macro, ver as opes exibidos no campo) ou No (o Microsoft Access localiza os correspondentes selecionadas na caixa de dados da maneira como eles esto armazenados no banco de dilogo Localizar no Campo quando clicar dados, o que nem sempre igual a forma como eles so em Localizar. exibidos). O padro No. Voc pode utilizar esse recurso para restringir a localizao aos dados em um determinado formato. O Microsoft Access retm os argumentos Por exemplo, clique em Sim e digite 1.234 no argumento LocalizarRegistro mais recentes durante uma Localizar para localizar um valor 1.234 em um campo formatado para incluir ponto. Clique em No se desejar inserir sesso de banco de dados, de maneira que voc no precisa inserir os mesmos critrios 1234 para a localizao dos dados nesse campo. Para localizar datas, clique em Sim para localizar uma data exatamente como repetidamente medida que executa ela est formatada, como 03-Maro-1991. Se voc clicar em operaes LocalizarRegistro subseqentes. Se voc deixar um argumento em branco, o No, insira a data no argumento Localizar no formato definido na caixa de dilogo Propriedades de Configuraes Regionais no Microsoft Access utilizar a configurao Painel de Controle do Windows. (Essa a caixa Estilo de Data mais recente para o argumento, como Abreviada encontrada na guia Data da caixa de dilogo definida por uma ao LocalizarRegistro anterior ou na caixa de dilogo Localizar no Propriedades de Configuraes Regionais.) Por exemplo, se a caixa Estilo de Data Abreviada estiver definida como M/d/aa, Campo. voc poder digitar 3/9/91, e o Microsoft Access ir localizar Quando voc desejar localizar um registro todas as entradas em um campo Data que correspondam a 9 de utilizando uma macro, utilize a ao maro de 1991, sem considerar a formatao do campo. LocalizarRegistro, no a ao Observao Esse argumento tem efeito somente se o campo ExecutarComando com seus argumentos atual for um controle acoplado, o argumento Coincidir estiver definidos para executar o comando definido como Campo Inteiro, o argumento Somente Campo Localizar. Atual estiver definido como Sim e o argumento Maiscula/minscula estiver definido como No. Se voc definir Observao: Embora a ao LocalizarRegistro corresponda ao comando Maiscula/minscula como Sim, ou Somente Campo Atual como No, tambm ter que definir Localizar Como Formatado Localizar, no menu Editar, para tabelas, consultas e formulrios, ela no corresponde como Sim. Somente Campo Atual -> Especifica se a localizao restrita ao comando Localizar, no menu Editar, da janela Mdulo. No possvel utilizar a ao ao campo atual em cada registro ou se inclui todos os campos em cada registro. A localizao no campo atual mais rpida. LocalizarRegistro para localizar textos em Clique em Sim (restringir a localizao ao campo atual) ou No mdulos. (localizar em todos os campos em cada registro). O padro Sim. Localizar Primeira -> Especifica se a localizao deve ser iniciada no primeiro registro ou no registro atual. Clique em Sim (inicia no primeiro registro) ou No (inicia no registro atual). O padro Sim. Voc pode utilizar uma ao EnviarObjeto Tipo de Objeto -> O tipo de objeto a incluir na mensagem de para incluir a folha de dados, o formulrio, correio. Clique em Tabela (para uma folha de dados de tabela), relatrio ou mdulo especificado do Consulta (para uma folha de dados de consulta), Formulrio Microsoft Access em uma mensagem de (para um formulrio ou folha de dados de formulrio), Relatrio correio eletrnico, onde ela pode ser ou Mdulo na caixa Tipo de Objeto na seo Argumentos da visualizada e passada adiante. Voc pode Ao da janela Macro. Voc no pode enviar uma macro. Se incluir objetos em formato Microsoft Excel voc desejar incluir o objeto ativo, selecione seu tipo com este

EnviarObjeto

1.

1.

REFERNCIA DE MACROS DO MICROSOFT ACCESS


97 (*.xls), Texto do MS-DOS (*.txt), richtext (*.rtf), ou HTML (*.html) em mensagens para o Microsoft Exchange, Microsoft Mail, o correio do Microsoft Windows para Workgroups ou um outro aplicativo de correio eletrnico que utilize a Interface de Programao de Aplicativos Microsoft Mail (MAPI). Se voc tem um aplicativo de correio eletrnico que utiliza o protocolo Vendor Independent Mail (VIM) e se voc instalou e configurou a biblioteca de vnculo dinmico (Mapivim.dll) que converte mensagens de correio em protocolo VIM, voc poder enviar objetos do Microsoft Access ao aplicativo de correio VIM. A ao EnviarObjeto s estar disponvel se voc tiver instalado em seu computador um aplicativo de correio eletrnico concordante com MAPI ou se tiver um aplicativo de correio eletrnico concordante com VIM e tiver instalado e configurado o Mapivim.dll. Para obter informaes sobre como instalar e configurar o suporte do Microsoft Access para aplicativos de correio VIM, consulte o Microsoft Office 97 Resource Kit. O objeto na mensagem de correio est no formato de sada selecionado. Quando voc clica duas vezes no objeto, o aplicativo apropriado iniciado com o objeto aberto. O aplicativo para cada tipo de formato de sada o Microsoft Excel (para arquivos .xls), o Bloco de Notas do Microsoft Windows (para arquivos .txt) e o Microsoft Word (para arquivos .rtf). Para arquivos .html, o seu navegador padro para Internet (como o Microsoft Internet Explorer) iniciado. argumento, mas deixe o argumento Nome do Objeto em branco. Nome do Objeto -> O nome do objeto a incluir na mensagem de correio. A caixa Nome do Objeto mostra todos os objetos de banco de dados do tipo selecionado pelo argumento Tipo de Objeto. Se voc deixar os argumentos Tipo de Objeto e Nome do Objeto em branco, o Microsoft Access enviar uma mensagem ao aplicativo de correio sem nenhum objeto do banco de dados. Se voc executar uma macro contendo a ao EnviarObjeto em um banco de dados biblioteca, o Microsoft Access procurar primeiro o objeto com esse nome no banco de dados biblioteca e, em seguida, no banco de dados atual. Formato de Sada -> O tipo de formato a ser usado para o objeto includo. Voc pode clicar em HTML (*.html), Microsoft Excel (*.xls), Texto do MS-DOS (*.txt) ou Formato Rich Text (*.rtf) na caixa Formato de Sada. Os mdulos podem ser enviados somente no formato Texto do MS-DOS. Se voc deixar este argumento em branco, o Microsoft Access pedir a voc o formato de sada. Observao Voc no pode incluir objetos no formato Microsoft Active Server Pages (*.asp) ou Microsoft IIS (*.htx, *.idc), embora essas selees estejam includas na lista Para -> Os destinatrios da mensagem cujos nomes voc queira colocar na linha Para da mensagem de correio. Se voc deixar este argumento em branco, o Microsoft Access pedir a voc os nomes dos destinatrios. Separe os nomes dos destinatrios que voc especificar nesse argumento e nos argumentos Cc e Cco com um ponto-e-vrgula (;) ou com o separador de lista definido na guia Nmero da caixa de dilogo Propriedades das Configuraes Regionais do Painel de Controle do Windows. Se o aplicativo de correio no puder identificar os nomes dos destinatrios, a mensagem no ser enviada. Cc -> Os destinatrios da mensagem cujos nomes voc deseja colocar na linha Cc ("cpia carbono") na mensagem de correio. Se voc deixar este argumento em branco, a linha Cc da mensagem de correio ficar em branco. Cco ->Os destinatrios da mensagem cujos nomes voc deseja colocar na linha Cco ("com cpia oculta") na mensagem de correio. Se voc deixar este argumento em branco, a linha Cco na mensagem de correio ficar em branco. Assunto -> O assunto da mensagem. Este texto aparece na linha Assunto da mensagem de correio. Se voc deixar este argumento em branco, a linha Assunto da mensagem de correio ficar em branco. Texto da Mensagem -> Qualquer texto que voc queira incluir na mensagem, alm do objeto do banco de dados. Esse texto aparece no corpo principal da mensagem de correio, aps o objeto. Se voc deixar este argumento em branco, nenhum texto adicional ser includo na mensagem de correio. Se deixar os argumentos Tipo de Objeto e Nome do Objeto em branco, voc poder utilizar esse argumento para enviar uma mensagem de correio sem um objeto do banco de dados. Editar Mensagem -> Especifica se a mensagem pode ser editada antes de ser enviada. Se voc selecionar Sim, o aplicativo de correio eletrnico ser iniciado automaticamente e a mensagem poder ser editada. Se voc selecionar No, a mensagem ser enviada sem lhe oferecer uma oportunidade de editar a mensagem. O padro No. Arquivo Modelo -> O caminho e nome de um arquivo que voc queira utilizar como modelo para um arquivo .html. O arquivo modelo um arquivo contendo marcas HTML.

1.

1. Continuao da Ao EnviarObjeto

REFERNCIA DE MACROS DO MICROSOFT ACCESS

1.

1. Comentrios sobre a Ao Enviar Objeto


Comentrios

REFERNCIA DE MACROS DO MICROSOFT ACCESS


A ao EnviarObjeto s estar disponvel se voc tiver instalado em seu computador um aplicativo de correio eletrnico concordante com MAPI ou se tiver um aplicativo de correio eletrnico concordante com VIM e tiver instalado e configurado o Mapivim.dll. Para obter informaes sobre como instalar e configurar o suporte do Microsoft Access para aplicativos de correio VIM, consulte o Microsoft Office 97 Resource Kit. O objeto na mensagem de correio est no formato de sada selecionado. Quando voc clica duas vezes no objeto, o aplicativo apropriado iniciado com o objeto aberto. O aplicativo para cada tipo de formato de sada o Microsoft Excel (para arquivos .xls), o Bloco de Notas do Microsoft Windows (para arquivos .txt) e o Microsoft Word (para arquivos .rtf). Para arquivos .html, o seu navegador padro para Internet (como o Microsoft Internet Explorer) iniciado. As regras a seguir se aplicam quando voc utiliza a ao EnviarObjeto para incluir um objeto do banco de dados em uma mensagem de correio: Voc pode enviar folhas de dados de tabela, consulta e formulrio. No objeto includo, todos os campos da folha de dados conservam a aparncia que tinham no Microsoft Access, exceto os campos contendo os objetos OLE. As colunas para esses campos so includas no objeto, mas os campos ficam em branco. Para um controle acoplado a um campo Sim/No (um boto alternar, boto de opo ou caixa de seleo), o arquivo de sada exibe o valor 1 (Sim) ou 0 (No). Para uma caixa de texto acoplada a um campo Hyperlink, o arquivo de sada exibe o hyperlink para todos os formatos de sada, exceto o Texto do MS-DOS (neste caso, o hyperlink simplesmente exibido como texto normal). Se voc enviar um formulrio no modo Formulrio, o objeto includo sempre conter o modo Folha de Dados do formulrio. Se voc enviar um relatrio, somente os controles includos no objeto sero caixas de texto (para arquivos .xls), ou caixas de texto e rtulos (para arquivos .rtf, .txt e .html). Todos os outros controles sero ignorados. As informaes de cabealho e rodap tambm no sero includas. A nica exceo que, quando voc envia um relatrio no formato do Microsoft Excel, uma caixa de texto em um rodap de grupo contendo uma expresso com a funo Soma includa no objeto. Nenhum outro controle em um cabealho ou rodap (e nenhuma funo agregada alm de Soma) includo no objeto. Os sub-relatrios so includos no objeto, mas os subformulrios no so. Quando voc envia uma folha de dados ou um formulrio no formato HTML, um nico arquivo .html criado. Quando voc envia um relatrio no formato HTML, um nico arquivo .html criado para cada pgina do relatrio.

Para obter maiores informaes sobre regras e restries durante a incluso de objetos no formato HTML, consulte Exportar uma folha de dados para um formato HTML esttico e Exportar um relatrio para um formato HTML esttico. Dica: Se voc enviar os dados de um relatrio e se as colunas e linhas de dados do objeto includo no se alinharem como no relatrio, as dicas a seguir podero ser teis: Voc pode apontar para Dimensionar no menu Formatar e clicar ento em Para Caber para dimensionar os controles. Voc deve evitar sobrepor os controles ou colocar os controle muitos prximos entre si. Voc pode apontar para Alinhar no menu Formatar e em seguida clicar no comando apropriado para alinhar os controles no relatrio. Os controles que no estiverem alinhados na mesma linha podero ser colocados em linhas diferentes no objeto includo, causando espaamento adicional. A ao EnviarObjeto tem o mesmo efeito que clicar em Enviar no menu Arquivo, e os argumentos de ao correspondem s definies das caixas de dilogo Enviar. O comando Enviar, contudo, aplica-se somente ao objeto ativo. Se utilizar a ao EnviarObjeto, voc poder especificar o objeto que deseja enviar.

Observao: Voc pode enviar os dados selecionados com o comando Enviar. Entretanto, essa funcionalidade no est disponvel com a ao EnviarObjeto.

1.

1.

REFERNCIA DE MACROS DO MICROSOFT ACCESS Pressionamento de Teclas -> Os pressionamentos de teclas que voc deseja que o Microsoft Access ou o aplicativo processe. Digite os pressionamentos de tecla na caixa Pressionamento de Teclas na seo Argumentos da Ao da janela Macro. Voc pode digitar at 255 caracteres. Este um argumento requerido. Aguardar -> Especifica se a macro deve fazer uma pausa at que os pressionamentos de tecla tenham sido processados. Clique em Sim (para fazer uma pausa) ou No (para no fazer uma pausa). O padro No. O Microsoft Access processa os pressionamentos de teclas que recebe atravs da ao EnviarSeqnciaDeCaracteres exatamente como se voc os tivesse digitado diretamente em uma janela do Microsoft Access. Para especificar os pressionamentos de teclas, utilize a mesma sintaxe que a instruo SendKeys. Observao: Poder ocorrer um erro se o argumento Pressionamento de Teclas contiver sintaxe incorreta, texto incorretamente grafado ou outros valores que no forem apropriados para a janela para a qual os pressionamentos de tecla so enviados.

EnviarSqnciaDeC Voc pode utilizar a ao EnviarSeqnciaDeCaracteres aracteres para enviar pressionamentos de teclas diretamente para o Microsoft Access ou para um aplicativo ativo baseado no Windows. Observaes Como a caixa de dilogo suspende a macro, voc precisa colocar a ao EnviarSeqnciaDeCaractere s antes da ao que faz com que a caixa de dilogo seja aberta e definir o argumento Aguardar como No. A temporizao dos pressionamentos de teclas que chegam ao Microsoft Access ou a um outro aplicativo pode ser complicada. Como resultado, recomendvel que, se houver algum outro mtodo (como a ao LocalizarRegistro) que voc possa usar para efetuar uma tarefa desejada, voc utilize esse mtodo em vez de usar a ao EnviarSeqnciaDeCaractere s para preencher as opes em uma caixa de dilogo.

Voc pode utilizar esta ao para inserir informaes em uma caixa de dilogo, particularmente se voc no quiser interromper a macro para responder manualmente caixa de dilogo. Algumas aes do Microsoft Access, como Imprimir e LocalizarRegistro, selecionam automaticamente as opes de certas caixas de Se voc quiser enviar mais de dilogo freqentemente utilizadas. Voc pode 255 caracteres para o Microsoft utilizar a ao EnviarSeqnciaDeCaracteres Access ou um outro aplicativo baseado em Windows, voc pode para selecionar as opes em caixas de dilogo menos freqentemente utilizadas. usar vrias aes EnviarSeqnciaDeCaracteres em sucesso numa macro.

1.

1.

REFERNCIA DE MACROS DO MICROSOFT ACCESS

BACKSPACE {BACKSPACE}, {BS} ou {BKSP} BREAK {BREAK} CAPS LOCK {CAPSLOCK} DEL ou DELETE {DELETE} ou {DEL} SETA ABAIXO {DOWN} Para especificar teclas combinadas com qualquer {END} combinao das teclas SHIFT, CTRL e ALT, preceda END {ENTER}ou ~ o cdigo de teclas de um ou mais dos cdigos a seguir: ENTER ESC {ESC} HELP {HELP} Tecla Cdigo HOME {HOME} SHIFT + INS ou INSERT {INSERT} ou {INS} CTRL ^ SETA ESQUERDA {LEFT} ALT % NUM LOCK {NUMLOCK} PAGE DOWN {PGDN} PAGE UP {PGUP} PRINT SCREEN {PRTSC} SETA DIREITA {RIGHT} SCROLL LOCK {SCROLLLOCK} TAB {TAB} SETA ACIMA {UP} F1 {F1} F2 {F2} F3 {F3} F4 {F4} F5 {F5} F6 {F6} F7 {F7} F8 {F8} F9 {F9} F10 {F10} F11 {F11} F12 {F12} F13 {F13} F14 {F14} F15 {F15} F16 {F16} Voc pode utilizar a ao ExcluirObjeto para Tipo de Objeto -> O tipo de objeto a excluir. Clique em Tabela, ExcluirObjeto ATENO Para especificar caracteres que no so exibidos quando voc pressiona uma tecla, como ENTER ou TAB, e teclas que representam aes em vez de caracteres, utilize os cdigos a seguir.
excluir um objeto de banco de dados especificado. Consulta, Formulrio, Relatrio, Macro ou Mdulo na caixa Tipo de Objeto na seo Argumentos da Ao da janela Macro. Para excluir o objeto selecionado na janela Banco de Dados, Voc pode utilizar a ao ExcluirObjeto para deixe este argumento em branco. excluir objetos temporrios que voc tenha Nome do Objeto -> O nome do objeto a excluir. A caixa Nome criado durante a execuo da macro. Por do Objeto mostra todos os objetos do banco de dados que sejam exemplo, voc poderia utilizar a ao do tipo selecionado pelo argumento Tipo de Objeto. Se voc AbrirConsulta para executar uma consulta deixar o argumento Tipo de Objeto em branco, deixe esse criar-tabela que crie uma tabela temporria. argumento em branco tambm. Ao terminar de usar a tabela temporria, Se voc executar uma macro contendo a ao ExcluirObjeto em voc poder utilizar a ao ExcluirObjeto um banco de dados biblioteca, o Microsoft Access procurar o para exclu-la. objeto com esse nome primeiro no banco de dados biblioteca, e

1.

1.

REFERNCIA DE MACROS DO MICROSOFT ACCESS


Esta ao tem o mesmo efeito que selecionar um objeto na janela Banco de Dados e, em seguida, pressionar a tecla DEL ou clicar em Excluir no menu Editar. ento no banco de dados atual. Aviso : Se voc deixar os argumentos Tipo de Objeto e Nome do Objeto em branco, o Microsoft Access excluir o objeto selecionado na janela Banco de Dados sem exibir uma mensagem de aviso quando encontrar a ao ExcluirObjeto. Para selecionar um objeto na janela Banco de Dados, voc pode utilizar a ao SelecionarObjeto com o argumento Na Janela Banco de Dados definido como Sim.

ExecutarAplicativo

Voc pode utilizar a ao ExecutarAplicativo para executar um aplicativo baseado no Windows ou no MSDOS, tal como o Microsoft Excel, Microsoft Word ou Microsoft PowerPoint, de dentro do Microsoft Access. Por exemplo, voc pode querer colar dados de uma planilha Microsoft Excel no seu banco de dados do Microsoft Access.

ExecutarCdigo

Linha de Comando : A linha de comando utilizada para iniciar o aplicativo (incluindo o caminho e qualquer outro tipo de parmetro necessrio, como chaves que executem o aplicativo em um determinado modo). Insira a linha de comando na caixa Linha de Comando na seo Argumentos da Ao da janela Macro. Este um argumento requerido. Os aplicativos baseados no MS-DOS so executados numa janela MS-DOS dentro do O aplicativo selecionado com esta ao ambiente Windows. carregado e executado em primeiro plano. A No Windows 3.1, esta ao tem o mesmo macro contendo esta ao continua a ser efeito que um clique duplo no cone de um programa do grupo de programas Windows executada. ou que executar um programa a partir da Voc pode transferir dados entre outros caixa de dilogo Executar no Gerenciador de aplicativos e o Microsoft Access utilizando o Programas do Windows. No Windows 95, recurso de intercmbio dinmico de dados existem vrias maneiras de iniciar um aplicativo, incluindo iniciar o programa a (DDE, Dynamic Data Exchange) ou a rea de partir do Windows Explorer, utilizar o comando Executar no menu Iniciar e dar um Transferncia do Windows. Voc pode utilizar a ao EnviarSeqnciaDeCaracteres para enviar clique duplo no cone de um programa na rea de Trabalho do Windows. pressionamentos de teclas para o outro aplicativo (embora o DDE seja um mtodo mais eficiente de transferncia de dados). Voc tambm pode compartilhar dados entre aplicativos utilizando a Automao. Nome da Funo ->O nome do procedimento Voc pode utilizar a ao ExecutarCdigo para chamar um Function do Visual Basic a chamar. Coloque procedimento Function do Visual qualquer dos argumentos da funo entre parnteses. Digite o nome da funo na caixa Basic. Nome da Funo na seo Argumentos da Ao Se voc utilizar a ao da janela Macro. Este um argumento ExecutarCdigo para chamar uma funo, o Microsoft Access requerido. procurar pela funo com o Os procedimentos Function definidos pelo nome especificado pelo argumento Nome da Funo nos usurio so armazenados nos mdulos do Microsoft Access. mdulos padres do banco de Voc precisa incluir parnteses, mesmo que o dados. Entretanto, quando esta procedimento Function no utilize argumento ao executada em resposta escolha de um comando de menu algum, como no exemplo a seguir: em um formulrio ou relatrio ou em resposta a um evento em um FunoDeTeste() formulrio ou relatrio, o

1.

1.

REFERNCIA DE MACROS DO MICROSOFT ACCESS Microsoft Access procurar pela funo primeiro no mdulo classe do formulrio ou dos relatrios e depois nos mdulos padres. O Microsoft Access no procurar os mdulos classe que aparecem na guia Mdulos da janela Banco de Dados da funo especificada pelo argumento Nome da Funo. Ao contrrio de nomes das funes definidas pelo usurio utilizadas para definies de propriedade de evento, o nome da funo no argumento Nome da funo no comea com um sinal de igualdade (=). O Microsoft Access ignora o valor de retorno da funo.

ExecutarComando

Dica: Para executar um procedimento Sub ou procedimento de evento escrito em Visual Basic, crie um procedimento Function que chame o procedimento Sub ou procedimento de evento. Utilize ento a ao ExecutarCdigo para executar o procedimento Function. Comando -> O nome do comando que voc Voc pode utilizar a ao ExecutarComando para executar deseja executar. A caixa Comando mostra os comandos internos disponveis no Microsoft um comando interno do Access, em ordem alfabtica. Este um Microsoft Access. O comando argumento requerido. pode aparecer em uma barra de No Microsoft Access, a ao ExecutarComando menu, barra de ferramentas ou substitui a ao ExecutarItemDoMenu. Quando menu de atalho do Microsoft voc abre e salva uma macro de uma verso Access. anterior do Microsoft Access que contm uma ao ExecutarItemDoMenu, a ao e seus Observao: O menu Arquivo argumentos de ao sero automaticamente do Microsoft Access mostra os bancos de dados mais utilizados convertidos na ao ExecutarComando equivalente. A ao ExecutarItemDoMenu no recentemente. Voc pode clicar aparece mais na lista de aes da janela Macro em um desses bancos de dados em vez de clicar em Abrir Banco do Microsoft Access. Voc pode utilizar a ao ExecutarComando de Dados. Esses itens de banco de dados no aparecem na caixa para executar um comando do Microsoft Access a partir de uma barra de menu personalizada, de listagem suspensa do argumento Comando e no esto barra de menu global, menu de atalho personalizado ou menu de atalho global. disponveis pela utilizao da ao ExecutarComando em uma Entretanto, normalmente mais fcil utilizar a caixa de dilogo Personalizar, disponvel macro. apontando-se para Barras de Ferramentas do menu Exibir e clicando-se em Personalizar, para adicionar comandos do Microsoft Access para menus personalizados e menus de atalho. A guia Comandos, na caixa de dilogo Personalizar, lista os comandos internos do Microsoft Access que aparecem nas barras de ferramentas e menus do Microsoft Access. Voc pode utilizar a ao ExecutarComando em 1.

1.

REFERNCIA DE MACROS DO MICROSOFT ACCESS uma macro com expresses condicionais para executar um comando, dependendo de determinadas condies. Nome da Macro -> O nome da macro a Voc pode utilizar a ao executar. A caixa Nome da Macro na seo ExecutarMacro para executar uma macro. A macro pode estar Argumentos da Ao da janela Macro mostra todas macros (e grupos de macro) do banco de em um grupo de macro. dados atual. Se a macro estiver em um grupo de Voc pode utilizar esta ao: macro, ela estar listada sob o nome do grupo de Para executar uma macro de macro como nomedogrupodemacro.nomedamacro. dentro de outra macro. Este um argumento requerido. Para executar uma macro Se voc executar uma macro contendo a ao com base em uma ExecutarMacro de um banco de dados determinada condio. Para anexar uma macro a um biblioteca, o Microsoft Access procurar pela macro com esse nome no banco de dados comando de menu biblioteca e no procurar por ela no banco de personalizado. dados atual. Dica : Voc pode utilizar a ao Contagem de Repetio ->O nmero mximo de vezes que a macro ser executada. Se voc ExecutarMacro em grupo de deixar este argumento vazio (e o argumento macro que defina comandos personalizados para uma barra de Expresso de Repetio tambm estiver em menu personalizada para executar branco), a macro s ser executada uma vez. Expresso de Repetio -> Uma expresso a uma macro a partir do menu ser avaliada como True (1) ou False (0). A personalizado. Contudo, mais execuo da macro suspensa quando a fcil utilizar a nova expresso avaliada como False. A expresso funcionalidade das barras de avaliada cada vez que a macro executada. comando para executar uma macro a partir de uma barra de Se voc inserir um nome de grupo de macro no menu, barra de ferramentas ou menu de atalho. No menu Exibir, argumento Nome da Macro, o Microsoft Access executar a primeira macro do grupo de macro. aponte para Barras de Ferramentas e clique em Personalizar para exibir a caixa de dilogo Personalizar. Na guia Esta ao semelhante a clicar em Macro no Barras de Ferramentas, selecione menu Ferramentas, que voc pode utilizar para selecionar e executar uma macro especificada. a barra de menu, barra de ferramentas ou menu de atalho a Entretanto, o comando s executa a macro uma vez, enquanto a ao ExecutarMacro pode partir do qual voc deseja executar uma macro tantas vezes quantas voc executar a macro. Na guia quiser. Comandos, clique em Todas as Macros na caixa Categorias e, em Dica: Voc pode utilizar os argumentos seguida, na caixa Comandos, Contagem de Repetio e Expresso de selecione e arraste a macro que voc deseja executar at a barra Repetio para determinar quantas vezes uma de menu, barra de ferramentas ou macro executada:

ExecutarMacro

1.

1.

REFERNCIA DE MACROS DO MICROSOFT ACCESS menu de atalho. Quando voc clicar no cone desta macro na barra de menu, barra de ferramentas ou menu de atalho, o Microsoft Access executar a macro. Voc tambm pode arrastar uma macro desde a janela Banco de Dados at uma barra de menu ou barra de ferramentas e o Microsoft Access criar um cone que executar a macro. Se voc deixar ambos os argumentos em branco, a macro s ser executada uma vez. Se voc digitar um nome para Contagem de Repetio, mas deixar Repetir Expresso em branco, a macro ser executada o nmero especificado de vezes. Se voc deixar Contagem de Repetio em branco, mas digitar uma expresso para Repetir Expresso, a macro ser executada at a expresso ser avaliada como False. Se voc digitar valores para ambos os argumentos, a macro ser executada o nmero de vezes especificado em Contagem de Repetio ou at a Expresso de Repetio ser avaliada como False, o que ocorrer primeiro.

Quando voc executa uma macro contendo a ao ExecutarMacro, e ela chega esta ao, o Microsoft Access executa a macro chamada. Quando a macro chamada tiver terminado, o Microsoft Access retornar macro original e executar a prxima ao. Observaes Voc pode chamar uma macro do mesmo grupo ou de outro. Voc pode aninhar macros. Ou seja, voc pode executar a macro A, que por sua vez chama a macro B, e assim por diante. Em cada caso, quando a macro chamada termina, o Microsoft Access volta para a macro que a chamou e executa a prxima ao dessa macro. Instruo SQL -> A instruo SQL da consulta Voc pode utilizar a ao ExecutarSQL para executar uma ao ou de definio de dados que voc deseja executar. O comprimento mximo desta consulta ao do Microsoft instruo de 256 caracteres. Este um Access utilizando a instruo SQL correspondente. Voc pode argumento requerido. Usar Transao -> Selecione Sim para incluir tambm executar uma consulta esta consulta em uma transao. Selecione No de definio de dados. Voc pode utilizar consultas ao se voc no desejar utilizar uma transao. O padro Sim. As verses anteriores do para acrescentar, excluir e atualizar registros e para salvar o Microsoft Access sempre incluam a consulta em uma transao quando voc executava esta conjunto de resultados de uma

ExecutarSQL

1.

1.

REFERNCIA DE MACROS DO MICROSOFT ACCESS consulta como uma nova tabela. Voc pode utilizar consultas de definio de dados para criar, alterar e excluir tabelas, e para criar e excluir ndices. Com a ao ExecutarSQL, voc pode efetuar essas operaes diretamente de uma macro, sem ter de utilizar consultas armazenadas. possvel utilizar a ao Fechar para fechar tanto uma janela do Microsoft Access especificada quanto a janela ativa se nenhuma for especificada. ao. Se voc selecionar No para este argumento, a consulta poder ser executada com maior rapidez.

Fechar

Imprimir

Tipo de Objeto -> O tipo do objeto cuja janela voc deseja fechar. Clique em Tabela, Consulta, Formulrio, Relatrio, Macro ou Mdulo na caixa Tipo de Objeto na seo Argumentos da Ao da janela Macro. Para selecionar a janela ativa, deixe esse argumento em branco. Nome do Objeto -> O nome do objeto a ser Se o argumento Salvar for fechado. A caixa Nome do Objeto mostra todos definido como Aviso e o objeto os objetos no banco de dados do tipo ainda no tiver sido salvo antes selecionado pelo argumento Tipo de Objeto. de a ao Fechar ser executada, Clique no objeto a ser fechado. Se voc deixar o uma caixa de dilogo solicitar que o usurio salve o objeto antes argumento Tipo de Objeto em branco, deixe tambm esse argumento em branco. que a macro o feche. Se voc Salvar -> Determina se as alteraes feitas no tiver definido o argumento objeto sero salvas quando ele for fechado. Avisos Ativos da ao DefinirAvisos como No, a caixa Clique em Sim (salva o objeto), No (fecha o objeto sem salv-lo) ou Aviso (pergunta ao de dilogo no ser exibida e o usurio se o objeto deve ou no ser salvo). O objeto ser salvo padro Aviso. automaticamente Intervalo de Impresso -> O intervalo para possvel utilizar a ao Imprimir para imprimir o objeto imprimir. Clique em Tudo (o usurio pode imprimir o objeto inteiro), Seleo (o usurio ativo no banco de dados aberto. pode imprimir a parte do objeto que est Voc pode imprimir folhas de selecionada) ou Pginas (o usurio pode dados, relatrios, formulrios e especificar um intervalo de pginas nos mdulos. argumentos Da Pgina e Pgina) na caixa Intervalo de Impresso na seo Argumentos da Dica Caso tenha definies de Ao da janela Macro. O padro Tudo. impresso especficas que voc utiliza com freqncia, crie uma Da Pgina -> A primeira pgina a ser impressa. macro contendo a ao Imprimir A impresso inicia no topo dessa pgina. Esse argumento ser requerido se voc selecionar com essas definies em seus Pginas na caixa Intervalo de Impresso. argumentos. Pgina -> A ltima pgina a ser impressa. A impresso interrompida na parte inferior dessa Os argumentos para essa ao correspondem s opes na caixa pgina. Esse argumento ser requerido se voc de dilogo Imprimir. Entretanto, selecionar Pginas na caixa Intervalo de

1.

1.

REFERNCIA DE MACROS DO MICROSOFT ACCESS Impresso. Qualidade de Impresso -> A qualidade da impresso. Clique em Alta, Mdia, Baixa ou Rascunho. Quanto mais baixa a qualidade, mais rpida a impresso do objeto. O padro Alta. Cpias O nmero de cpias a serem impressas. O padro 1. Agrupar Cpias -> Clique em Sim (agrupa as cpias impressas) ou No (no agrupa as cpias). A impresso do objeto pode ser mais rpida se esse argumento for definido como No. O padro Sim. Nome do Controle ->O nome do campo ou possvel utilizar a ao IrParaControle para mover o foco controle onde voc deseja colocar o foco. Digite o nome do campo ou controle na caixa Nome do para o campo ou controle especificado no registro atual do Controle na seo Argumentos da Ao da janela Macro. Esse um argumento requerido. formulrio aberto, na folha de dados do formulrio, na folha de Observao: Digite somente o nome do campo ou controle no argumento Nome do Controle, e dados da tabela ou na folha de no o identificador totalmente qualificado, como dados da consulta. Voc pode utilizar essa ao quando desejar Forms!Products![Product ID]. que um determinado campo ou No possvel utilizar a ao IrParaControle controle tenha o foco. Esse para mover o foco para um controle em um campo ou controle pode, ento, formulrio oculto. ser utilizado para comparaes ou aes LocalizarRegistro. Voc Dica Voc pode utilizar a ao IrParaControle pode tambm utilizar essa ao para navegar em um formulrio para mover para um subformulrio, que um de acordo com certas condies. tipo de controle. Voc poder, ento, utilizar a Por exemplo, se o usurio digitar ao IrParaRegistro para mover para um No em um controle Casado em determinado registro no subformulrio. Voc um formulrio de seguro sade, o pode tambm mover para um controle em um foco pode automaticamente pular subformulrio utilizando a ao IrParaControle para mover primeiro para o subformulrio e, o controle Nome do Cnjuge e depois, para o controle no subformulrio. mover para o controle seguinte. Nmero da Pgina -> O nmero da pgina possvel utilizar a ao IrParaPgina para mover o foco para a qual voc deseja mover o foco. Digite o nmero da pgina na caixa Nmero da Pgina no formulrio ativo para o primeiro controle em uma pgina na seo Argumentos da Ao da janela Macro. Caso deixe esse argumento em branco, o foco especificada. Voc poder utilizar essa ao se tiver criado permanecer na pgina atual. possvel utilizar os argumentos Direita e Abaixo para exibir a um formulrio com quebras de parte da pgina que voc deseja examinar. pgina que contenha grupos de Direita -> A posio horizontal daquele ponto informaes relacionadas. Por na pgina, medido a partir da borda esquerda da exemplo, voc pode ter um janela que a contm, a qual deve aparecer na formulrio Funcionrios com diferentemente da ao LocalizarRegistro e da caixa de dilogo Localizar no Campo, as definies do argumento no so compartilhadas com as opes da caixa de dilogo Imprimir.

IrParaControle

IrParaPgina

1.

1.

REFERNCIA DE MACROS DO MICROSOFT ACCESS informaes pessoais em uma pgina, informaes comerciais em outra pgina e informaes sobre vendas em uma terceira pgina. possvel utilizar a ao IrParaPgina para mover para a pgina desejada. Tambm possvel apresentar vrias pginas de informaes em um nico formulrio utilizando controles guia. borda esquerda da janela. Isso exigido se voc especificar um argumento Abaixo. Abaixo -> A posio vertical daquele ponto na pgina, medido a partir da borda superior da janela que a contm, a qual deve aparecer na borda superior da janela. Isso exigido se voc especificar um argumento Direita. Observao : Os argumentos Direita e Abaixo so medidos em polegadas ou centmetros, dependendo das unidades definidas para Sistema de Medidas na guia Nmero da caixa de dilogo Propriedades de Configuraes Regionais no Painel de Controle do Windows. Tipo de Objeto -> O tipo do objeto contendo o registro que voc deseja tornar o registro atual. Clique em Tabela, Consulta ou Formulrio na caixa Tipo de Objeto na seo Argumentos da Ao da janela Macro. Deixe esse argumento em branco para selecionar o objeto ativo. Nome do Objeto -> O nome do objeto contendo o registro que voc deseja tornar o registro atual. A caixa Nome do Objeto mostra todos os objetos no banco de dados atual do tipo selecionado pelo argumento Tipo de Objeto. Se voc deixar em branco o argumento Tipo de Objeto, deixe tambm esse argumento em branco. Registro -> O registro a ser tornado registro atual. Clique em Anterior, Prximo, Primeiro, ltimo, Ir Para ou Novo na caixa Registro. O padro Prximo. Deslocamento -> Um inteiro ou expresso que avaliada como um inteiro. Uma expresso deve ser precedida por um sinal de igual (=). Esse argumento especifica o registro a ser tornado registro atual. Voc pode utilizar o argumento Deslocamento de duas maneiras : Quando o argumento Registro Prximo ou Anterior, o Microsoft Access move para adiante ou para trs o nmero de registros especificado no argumento Deslocamento.

IrParaRegistro

possvel utilizar a ao IrParaRegistro para tornar o registro especificado o registro atual em uma tabela, formulrio ou conjunto de resultados de consulta abertos. Se o foco estiver em um determinado controle de um registro, essa ao o deixar no mesmo controle para o novo registro. possvel utilizar a definio Novo para o argumento Registro para mover para o registro em branco na parte final de um formulrio ou tabela para que voc possa inserir novos dados. Essa ao semelhante a clicar em Ir Para no menu Editar. Os subcomandos Primeiro, ltimo, Prximo, Anterior e Novo Registro do comando Ir Para tm o mesmo efeito que as definies Primeiro, ltimo, Prximo, Anterior e Novo para o argumento Registro sobre o objeto selecionado. Tambm possvel mover para registros utilizando os botes de navegao na parte inferior da janela. 1.

1.

REFERNCIA DE MACROS DO MICROSOFT ACCESS Voc pode utilizar a ao IrParaRegistro para fazer de um registro contido em um formulrio oculto o registro atual caso especifique o formulrio oculto nos argumentos Tipo de Objeto e Nome do Objeto. Observao: Se voc utilizar a definio Primeiro, ltimo ou Novo para o argumento Registro, o Microsoft Access ir ignorar o argumento Deslocamento. Se voc inserir um argumento Deslocamento muito grande, o Microsoft Access exibir uma mensagem de erro. No possvel informar nmeros negativos para o argumento Deslocamento. possvel utilizar a ao No Possui Argumentos Maximizar para aumentar a Essa ao tem o mesmo efeito de clicar no boto janela ativa de maneira que ela Maximizar no canto superior direito da janela preencha a janela do Microsoft Access. Essa ao permitir que ou clicar em Maximizar no menu Controle. possvel utilizar a ao Restaurar para voc veja tanto quanto possvel restaurar uma janela maximizada ao seu do objeto na janela ativa. tamanho anterior. Talvez voc precise utilizar a ao SelecionarObjeto se a janela que voc deseja maximizar no for a janela ativa. Ao maximizar uma janela no Microsoft Access, todas as outras janelas tambm so maximizadas quando voc as abre ou alterna para elas. No Possui Argumentos possvel utilizar essa ao para remover uma janela da tela deixando o objeto aberto. Voc pode tambm utilizar essa ao para abrir um objeto sem exibir sua janela. Para exibir o objeto, utilize a ao SelecionarObjeto tanto com a ao Maximizar como com a ao Restaurar. A ao Restaurar restaura uma janela minimizada ao seu tamanho anterior. A ao Minimizar tem o mesmo efeito de clicar no boto Minimizar no canto superior direito da janela ou de clicar em Minimizar no menu Controle. Quando o argumento Registro Ir Para, o Microsoft Access move para o registro com o nmero igual ao argumento Deslocamento. O nmero do registro mostrado na caixa nmero do registro na parte inferior da janela.

Maximizar

Minimizar

possvel utilizar a ao Minimizar para reduzir a janela ativa a uma barra de ttulo pequena na parte inferior da janela do Microsoft Access.

1.

1.

REFERNCIA DE MACROS DO MICROSOFT ACCESS Talvez voc precise primeiro utilizar a ao SelecionarObjeto se a janela que deseja minimizar no for a janela ativa. Para minimizar a janela Banco de Dados, utilize a ao SelecionarObjeto com o argumento Na Janela Banco de Dados definido como Sim e, em seguida, utilize a ao Minimizar. possvel utilizar o comando Ocultar, no menu Janela, para ocultar a janela ativa. Ao invs de ser reduzida a um cone, a janela se torna invisvel. O comando Reexibir, no menu Janela, far a janela reaparecer. Voc pode utilizar a ao ExecutarComando para executar qualquer um desses comandos a partir de uma macro. Voc pode tambm utilizar a ao DefinirValor para definir a propriedade Visvel de um formulrio para ocultar ou exibir a janela do formulrio.

MostrarBarraDeFe rramentas

Voc pode utilizar a ao MostrarBarraDeFerramentas para exibir ou ocultar uma barra de ferramentas interna ou personalizada. Voc pode exibir uma barra de ferramentas interna em todas as janelas do Microsoft Access ou somente no modo no qual a barra de ferramentas normalmente exibida (por exemplo, a barra de ferramentas Modo Formulrio no modo Formulrio).

Nome da Barra de Ferramentas -> O nome da barra de ferramentas que voc deseja exibir ou ocultar. A caixa Nome da Barra de Ferramentas na seo Argumentos da Ao da janela Macro mostra todas as barras de ferramentas internas do Microsoft Access, seguidas por quaisquer barras de ferramentas personalizadas que voc tenha definido no banco de dados atual. Este um argumento requerido. Se a caixa de seleo Permitir Barras de Ferramentas Internas da caixa de dilogo Inicializar (disponvel clicando-se em Inicializar no menu Ferramentas) estiver desmarcada, voc s poder utilizar esta ao para exibir e ocultar barras de Observao: A ao ferramentas personalizadas. MostrarBarraDeFerramentas afeta somente Se voc executar uma macro contendo a ao as barras de ferramentas, no as barras de MostrarBarraDeFerramentas em um banco de dados biblioteca, menu ou os menus de atalho. o Microsoft Access procurar primeiro a barra de ferramentas Se desejar exibir uma determinada barra de com esse nome no banco de dados biblioteca, e em seguida, no ferramentas em apenas um formulrio ou banco de dados atual. relatrio, voc poder definir a propriedade Mostrar -> Especifica se a barra de ferramentas ser exibida ou Ao Ativar do formulrio ou relatrio como o ocultada e em quais modos. O padro No (ocultar a barra de nome de uma macro que contenha uma ao ferramentas). MostrarBarraDeFerramentas para exibir a Para barras de ferramentas internas, voc pode selecionar Sim barra de ferramentas. Defina ento a para exibir a barra de ferramentas em todas janelas do Microsoft propriedade Ao Desativar do formulrio ou Access que ficarem ativas, Quando Adequado para exibir a barra relatrio com o nome de uma macro que de ferramentas apenas no modo no qual ela normalmente contenha uma ao exibida (como o Microsoft Access faz por padro), ou No para MostrarBarraDeFerramentas para ocult-la. ocultar a barra de ferramentas em todas as janelas do Microsoft Access. A ao MostrarBarraDeFerramentas tem o Para barras de ferramentas personalizadas, voc pode selecionar mesmo efeito que apontar para Barras de Sim ou Quando Adequado para exibir a barra de ferramentas Ferramentas no menu Exibir, clicar em personalizada em todas as janelas do Microsoft Access que Personalizar e, ento, selecionar ou limpar ficarem ativas ou No para ocultar a barra de ferramentas em uma barra de ferramentas especfica na guia todas as janelas do Microsoft Access. Barras de Ferramentas da caixa de dilogo Personalizar. A ao MostrarBarraDeFerramentas permite que voc especifique se uma barra de ferramentas interna ser exibida em todas as

1.

1.

REFERNCIA DE MACROS DO MICROSOFT ACCESS


janelas do Microsoft Access ou apenas no modo no qual ela normalmente exibida.

MostrarTodos Registros

Voc pode utilizar a ao MostrarTodosRegistros para remover qualquer filtro aplicado da tabela, do conjunto de resultados da consulta ou do formulrio ativos e exibir todos os registros da tabela ou conjunto de registros ou todos os registros na tabela base ou consulta base do formulrio.

No Possui Argumentos

MoverDimensionar

PararMacro

Voc pode utilizar esta ao para assegurar que todos os registros (incluindo qualquer registro alterado ou novo) sejam exibidos para uma tabela, um conjunto de resultados de consulta ou formulrio. Esta ao causa uma reconsulta dos registros de um formulrio ou subformulrio. Voc tambm pode utilizar esta ao para remover qualquer filtro que tenha sido aplicado com a ao AplicarFiltro, com o comando Aplicar Filtro/Classificao no menu Registros, ou com o argumento Nome do Filtro ou Condio Onde da ao AbrirFormulrio. Direita -> A nova posio horizontal do canto possvel utilizar a ao superior esquerdo da janela, medido a partir da MoverDimensionar para mover ou redimensionar a janela ativa. borda esquerda da janela que a contm. Digite a posio na caixa Direita, na seo Argumentos da Ao da janela Macro. Essa ao semelhante a clicar Abaixo -> A nova posio vertical do canto em Mover ou Dimensionar no menu Controle da janela. Com os superior esquerdo da janela, medido a partir da comandos de menu, voc utiliza borda superior da janela que a contm. Largura -> A nova largura da janela. as teclas de direo do teclado Altura -> A nova altura da janela. para mover ou redimensionar a janela. Utilizando a ao MoverDimensionar, voc insere Se voc deixar um argumento em branco, o Microsoft Access utilizar a definio atual da diretamente a posio e as janela. medidas de dimensionamento. necessrio inserir um valor para pelo menos Voc pode tambm utilizar o mouse para mover e dimensionar um argumento. janelas. possvel utilizar essa ao em Observao: Cada medida est em polegadas ou centmetros, dependendo da definio das qualquer janela e em qualquer unidades em Sistema de Medidas na guia modo. Nmero da caixa de dilogo Propriedades de Para mover uma janela sem Configuraes Regionais no Painel de Controle redimension-la, insira valores do Windows. para os argumentos Direita e Abaixo, mas deixe em branco os argumentos Largura e Altura. Para redimensionar uma janela sem mov-la, insira valores para os argumentos Largura e Altura, mas deixe em branco os argumentos Direita e Abaixo. Voc pode utilizar a ao No Possui Argumentos 1.

1.

REFERNCIA DE MACROS DO MICROSOFT ACCESS PararMacro para parar a macro atualmente em execuo.
Tipicamente, voc utiliza esta ao quando uma condio torna necessrio parar a macro. Voc pode utilizar uma expresso condicional na linha de ao da macro que contm essa ao. Quando a expresso avaliada como True (1), o Microsoft Access pra a macro. Por exemplo, voc poderia criar uma macro que abrisse um formulrio mostrando os totais de pedidos dirios da data inserida em uma caixa de dilogo personalizada. Voc poderia utilizar uma expresso condicional para se certificar de que o controle Data do Pedido da caixa de dilogo contm uma data vlida. Se no contiver, a ao CaixaDeMensagem

poderia exibir uma mensagem de erro e a ao PararMacro poderia parar a macro. Se a macro tiver utilizado as aes Eco ou DefinirAvisos para desativar o eco ou a exibio de mensagens do sistema, a ao PararMacro as reativar automaticamente PararTodas Macros Voc pode utilizar a ao PararTodasMacros para parar todas as macros atualmente em execuo. No Possui Argumentos Tipicamente, voc utiliza esta ao quando uma condio de erro torna necessrio parar todas as macros. Voc pode utilizar uma expresso condicional na linha de ao da macro que contenha essa ao. Quando a expresso for avaliada como True (1), o Microsoft Access ir parar todas as macros. Por exemplo, voc pode ter uma macro que exiba uma caixa de mensagem como uma dentre vrias aes complexas, incluindo a execuo de outras macros. Se o usurio clicar em Cancelar nessa caixa de mensagem, a ao PararTodasMacros pode parar todas as macros que estejam em execuo.

Redesenhar Objeto

Se uma macro tiver utilizado as aes Eco ou DefinirAvisos para desativar o eco ou a exibio das mensagens do sistema, a ao PararTodasMacros as reativar automaticamente. Tipo de Objeto -> O tipo de objeto a Voc pode utilizar a ao redesenhar. Clique em Tabela, Consulta, RedesenharObjeto para Formulrio, Relatrio, Macro ou Mdulo na completar qualquer tipo de caixa Tipo de Objeto na seo Argumentos da atualizaes de tela pendentes Ao da janela Macro. Deixe este argumento em para um objeto de banco de dados especificado ou o objeto de branco para selecionar o objeto ativo. banco de dados ativo, se nenhum Nome do Objeto -> O nome do objeto a redesenhar. A caixa Nome do Objeto mostra tiver sido especificado. Tais todos os objetos do banco de dados do tipo atualizaes incluem qualquer 1.

1.

REFERNCIA DE MACROS DO MICROSOFT ACCESS um dos reclculos pendentes para selecionado pelo argumento Tipo de Objeto. Se voc deixar o argumento Tipo de Objeto em os controles do objeto. branco, deixe este argumento em branco tambm. Esta ao no causa uma reconsulta do banco de dados, portanto ela no mostra registros O Microsoft Access espera para completar as atualizaes de tela pendentes at terminar novos e alterados, nem remove outras tarefas pendentes. Com essa ao, voc registros excludos da tabela ou consulta base do objeto. Utilize a pode forar o redesenho imediato dos controles no objeto especificado. Voc pode utilizar esta ao RepetirConsulta para reconsultar a origem do objeto de ao: um de seus controle Utilize a ao MostrarTodosRegistros para Quando voc utiliza a ao DefinirValor exibir os registros mais recentes e para alterar valores em vrios controles. O remover qualquer tipo de filtros Microsoft Access pode no mostrar as aplicados. alteraes imediatamente, especialmente se A ao RedesenharObjeto no outros controles (como controles calculados) tem o mesmo efeito que escolher dependerem dos valores dos controles o comando Atualizar a partir do alterados. menu Registros, que mostra Quando voc quiser se certificar de que o qualquer alterao que voc ou formulrio sendo visualizado exibe dados outros usurios tenham feito nos em todos os seus controle. Por exemplo, registros atualmente exibidos em controles contendo objetos OLE no exibem formulrios e folhas de dados. seus dados imediatamente aps voc abrir um formulrio. Novo Nome -> Um novo nome para o objeto de Voc pode utilizar a ao banco de dados. Digite o nome do objeto na Renomear para renomear um caixa Novo Nome da seo Argumentos da objeto de banco de dados Ao da janela Macro. Este um argumento especificado. requerido. Voc tambm pode renomear um Tipo de Objeto -> O tipo de objeto que voc deseja renomear. Clique em Tabela, Consulta, objeto clicando nele na janela Formulrio, Relatrio, Macro ou Mdulo. Para Banco de Dados, clicando nele renomear o objeto selecionado na janela Banco novamente para poder editar o nome dele, e digitando um novo de dados, deixe este argumento em branco. Nome Antigo -> O nome do objeto a ser nome. Com a ao Renomear, renomeado. A caixa Nome Antigo mostra todos voc no precisa primeiro os objetos do banco de dados do tipo selecionar um objeto na janela Banco de dados nem interromper selecionado pelo argumento Tipo de Objeto. Se voc deixar o argumento Tipo de Objeto em a macro para digitar o novo branco, deixe este argumento em branco nome. tambm. Observao Se voc executar uma Esta ao difere da ao CopiarObjeto, que cria uma cpia macro contendo a ao Renomear em um banco de dados biblioteca, o Microsoft Access do objeto sob um novo nome. procurar pelo objeto com esse nome primeiro no banco de dados biblioteca, e depois do banco

Renomear

1.

1.

REFERNCIA DE MACROS DO MICROSOFT ACCESS de dados atual. O novo nome do objeto de banco de dados precisa seguir as convenes de denominao padres para objetos do Microsoft Access. Voc no pode renomear um objeto aberto. Se voc deixar vazios os argumentos Tipo de Objeto e Nome Antigo, o Microsoft Access renomear o objeto selecionado na janela Banco de dados. Para selecionar um objeto na janela Banco de dados, voc pode utilizar a ao SelecionarObjeto com o argumento Na Janela Banco de Dados definido como Sim. Nome do Controle ->O nome do controle que Voc pode utilizar a ao RepetirConsulta para atualizar os voc deseja atualizar. Digite o nome do controle na caixa Nome do Controle na seo dados em um controle Argumentos da Ao da janela Macro. Voc especificado no objeto ativo deve utilizar somente o nome do controle e no reconsultando a origem do controle. Se nenhum controle for o identificador completamente qualificado (como especificado, essa ao reconsultar a origem do prprio Formulrios!nomedoformulrio!nomedocontrol e). Deixe argumento em branco para reconsultar objeto. Utilize esta ao para garantir que o objeto ativo ou um a origem do objeto ativo. Se o objeto ativo for de seus controles exiba os dados uma folha de dados ou o conjunto de resultados de uma consulta, voc precisa deixar este mais atuais. argumento em branco. Se o controle especificado no estiver baseado em uma consulta Comentrios ou tabela, esta ao fora um A ao RepetirConsulta faz uma das coisas a reclculo do controle. seguir: Se voc deixar o argumento Nome do Controle em branco, a ao RepetirConsulta ter o Reexecuta a consulta na qual o controle ou mesmo efeito que pressionar objeto se baseia. SHIFT+F9 quando o objeto tiver Exibe qualquer um dos registros novos ou o foco. Se um controle alterados e remove qualquer registro subformulrio tiver o foco, essa excludo da tabela na qual o controle ou ao reconsultar somente a objeto se baseia. origem do subformulrio (como faz o pressionamento de SHIFT+F9). Os controles baseados em uma consulta ou tabela incluem: Caixas de listagem e caixas de combinao. Controles de subformulrio. Objetos OLE, como grficos.

RepetirConsulta

1.

1.

REFERNCIA DE MACROS DO MICROSOFT ACCESS Controles contendo funes agregadas de domnio, como DSoma. No Possui Argumentos Esta ao atua sob o objeto selecionado. Se um objeto tiver sido minimizado, voc pode primeiro selecion-lo usando a ao SelecionarObjeto e, em seguida, restaur-lo a seu tamanho anterior utilizando a ao Restaurar. Voc pode utilizar a ao MoverDimensionar para mover ou dimensionar uma janela que voc tenha restaurado. A ao Restaurar tem o mesmo efeito que clicar no boto Restaurar no canto superior direito da janela ou clicar no comando Restaurar no menu Controle da janela.
Tipo de Objeto -> O tipo de objeto contendo os dados a dar sada. Clique em Tabela (para uma folha de dados de tabela), Consulta (para uma folha de dados de consulta), Formulrio (para um formulrio ou folha de dados de formulrio), Relatrio ou Mdulo na caixa Tipo de Objeto na seo Argumentos da Ao da janela Macro. Voc no pode dar sada a uma macro. Se voc desejar dar sada ao objeto ativo, selecione seu tipo com este argumento, mas deixe o argumento Nome do Objeto em branco. Este um argumento requerido. O padro Tabela. Nome do Objeto -> O nome do objeto contendo os dados a dar sada. A caixa Nome do Objeto mostra todos os objetos de banco de dados do tipo selecionado pelo argumento Tipo de Objeto. Se voc executar uma macro contendo a ao SadaPara em um banco de dados biblioteca, o Microsoft Access procurar pelo objeto com esse nome, primeiro no banco de dados biblioteca, depois no banco de dados atual. Formato de Sada -> O tipo de formato a ser utilizado para dar sada aos dados. Voc pode clicar em HTML (*.html), Microsoft Active Server Pages (*.asp), Microsoft Excel (*.xls), Microsoft IIS (*.htx, *.idc), Texto do MS-DOS (*.txt) ou Formato Rich Text (*.rtf) na caixa. Os mdulos s podem sair em formato de texto do MS-DOS. Os formatos Microsoft Internet Information Server e Microsoft Active Server Page esto disponveis somente para tabelas, consultas e formulrios. Se voc deixar este argumento em branco, o Microsoft Access pedir a voc o formato de sada. Arquivo de Sada -> O arquivo para o qual voc deseja dar sada aos dados, incluindo o caminho completo. Pode-se incluir a extenso padro de nome de arquivo (.asp, .htm ou .html, .htx, .xls, .txt ou .rtf) para o formato de sada que voc seleciona com o argumento Formato de Sada, mas ela no requerida. Se voc der sada para os arquivos do Microsoft Internet Information Server ou Microsoft Active Server Pages, o Microsoft Access sempre criar arquivos com as extenses padro de nome de arquivo .htx e .idc ou .asp. Se deixar o argumento Arquivo de Sada em branco, o Microsoft Access pedir a voc um nome de arquivo de sada. AutoIniciar -> Especifica se voc deseja que o aplicativo

Restaurar

Voc pode utilizar a ao Restaurar para restaurar uma janela maximizada ou minimizada a seu tamanho anterior.

SadaPara

Voc pode utilizar a ao SadaPara para dar sada aos dados do objeto do banco de dados do Microsoft Access especificado (uma folha de dados, formulrio, relatrio ou mdulo) para um arquivo em formato do Microsoft Excel 97 (*.xls), texto do MSDOS (*.txt) ou rich-text (*.rtf). Voc tambm pode dar sada a um arquivo no formato HTML (*.html), a arquivos no formato Microsoft Internet Information Server (*.htx, *.idc) ou no formato Microsoft Active Server Pages (*.asp). Os arquivos no formato Microsoft Internet Information Server tambm podem ser utilizados com o Microsoft Personal Web Server.

1.

1.

REFERNCIA DE MACROS DO MICROSOFT ACCESS


apropriado seja iniciado imediatamente aps a execuo da ao SadaPara, com o arquivo especificado pelo argumento Arquivo de Sada j aberto. Se selecionar Sim, um dos aplicativos a seguir ser iniciado com o arquivo de sada do objeto do Microsoft Access j aberto: Microsoft Excel (para arquivos .xls), Bloco de Notas do Microsoft Windows (para arquivos .txt) ou Microsoft Word (para arquivos .rtf). Para arquivos .html, o seu navegador padro para Internet (como o Microsoft Internet Explorer) iniciado. Este argumento ser ignorado para arquivos do Microsoft Internet Information Server e Microsoft Active Server Pages. Se voc selecionar No, o aplicativo no ser iniciado. O padro No. Arquivo Modelo O caminho de um arquivo e o nome que voc deseja utilizar como modelo para um arquivo .html, .htx ou .asp. O arquivo modelo um arquivo contendo marcas HTML.

Continuao da Ao SadaPara

1.

1.
Alguns Comentrios sobre a Ao SadaPara:

REFERNCIA DE MACROS DO MICROSOFT ACCESS

Os dados do Microsoft Access saem no formato selecionado e podem ser lidos por qualquer aplicativo que utilize o mesmo formato. Por exemplo, voc pode dar sada a um relatrio do Microsoft Access e sua formatao para um documento em formato rich-text e, em seguida, abrir o documento no Microsoft Word. Se voc der sada ao objeto do banco de dados para o formato HTML, o Microsoft Access criar um arquivo no formato HTML contendo os dados do objeto. Voc pode utilizar o argumento Arquivo Modelo para especificar um arquivo a ser utilizado como modelo para o arquivo .html. Se voc der sada ao objeto para o formato Microsoft Internet Information Server, o Microsoft Access criar dois arquivos: Um arquivo .idc, que contm informaes sobre como conectar-se a uma fonte de dados ODBC, e uma instruo SQL para ser executada contra esta fonte de dados. Neste caso, o objeto do Microsoft Access ao qual voc est dando sada conter os dados definidos pela instruo SQL e o banco de dados atual do Microsoft Access ser a fonte de dados ODBC. Um arquivo .htx, que especifica como formatar dados retornados da instruo SQL especificados no arquivo .idc como um documento HTML. Voc pode utilizar o argumento Arquivo Modelo para especificar um arquivo .html a ser utilizado como modelo.

O Microsoft Internet Information Server utiliza os arquivos .htx e .idc para criar um arquivo .html com os dados do objeto do Microsoft Access ao qual voc d sada. Se voc der sada ao objeto do banco de dados para o formato Microsoft Active Server Page, o Microsoft Access criar um arquivo no formato .asp que conter informaes sobre como acessar e formatar os dados do objeto. O Microsoft Internet Information Server utiliza o arquivo .asp para criar um arquivo .html com os dados do objeto do Microsoft Access ao qual voc d sada. Voc pode utilizar o argumento Arquivo Modelo para especificar um arquivo .html a ser utilizado como modelo para o arquivo .asp. As regras a seguir aplicam-se quando voc utiliza a ao SadaPara a fim de dar sada a um objeto do banco de dados para qualquer um dos formatos de sada, exceto Microsoft Active Server Pages (algumas destas regras tambm se aplicam ao formato do Microsoft Active Server Page): Voc pode dar sada aos dados da folha de dados de tabela, consulta e formulrio. No arquivo de sada, todos os campos da folha de dados mantm o aspecto que tinham no Microsoft Access, exceto os campos contendo objetos OLE. As colunas desses campos so includas no arquivo de sada, mas os campos ficam em branco. Para um controle acoplado a um campo Sim/No (um boto alternar, boto de opo ou caixa de seleo), o arquivo de sada exibe o valor 1 (Sim) ou 0 (No). Para uma caixa de texto acoplada a um campo Hyperlink, o arquivo de sada exibe o hyperlink para todos os formatos de sada, exceto texto do MS-DOS (neste caso, o hyperlink exibido apenas como texto normal). Se voc der sada aos dados de um formulrio no modo Formulrio, o arquivo de sada sempre conter o modo Folha de Dados do formulrio. Se voc der sada aos dados de um relatrio, os nicos controles includos no arquivo de sada sero caixas de texto (para arquivos de sada .xls), ou caixas de texto e rtulos (para arquivos de sada .rtf, .txt e .html). Todos os outros controles sero ignorados. As informaes de cabealho e rodap no so includas no arquivo de sada. A nica exceo que, ao dar sada aos dados de um relatrio para um arquivo do Microsoft Excel, uma caixa de texto em um rodap de grupo contendo a expresso com a funo Soma ser includa no arquivo de sada. Nenhum outro controle em um cabealho ou rodap (e nenhuma outra funo agregada alm de Soma) ser includo no arquivo de sada. Os sub-relatrios so includos no arquivo de sada, mas os subformulrios no. Quando voc d sada a uma folha de dados ou formulrio no formato HTML, um nico arquivo .html criado. Quando voc d sada a um relatrio no formato HTML, um nico arquivo .html criado para cada pgina do relatrio. Para obter maiores informaes sobre regras e restries durante sada para arquivos .html, consulte Exportar uma folha de dados para um formato HTML esttico e Exportar um relatrio para um formato HTML esttico. Para obter maiores informaes sobre regras e restries durante sada para arquivos do Microsoft Internet Information Server, consulte Exportar uma folha de dados para um formato HTML dinmico e Exportar um formulrio para um formato HTML dinmico. Para obter maiores informaes sobre regras e restries durante sada para arquivos do Microsoft Active Server Pages, consulte Exportar uma folha de dados para um formato HTML dinmico, Exportar um formulrio para um formato HTML dinmico e Controles de formulrio suportados e no suportados para um formato ASP dinmico. Dica Se voc der sada aos dados de um relatrio para um arquivo de sada, e se as colunas e linhas do arquivo de sada no estiverem alinhadas como no relatrio, as seguintes dicas podero ser teis: Voc pode apontar para Dimensionar no menu Formatar e clicar em Para Caber para dimensionar os controles. Voc deve evitar sobrepor os controles ou colocar os controles muito prximos entre si. Voc pode apontar para Alinhar no menu Formatar e em seguida clicar no comando apropriado para alinhar os controles no relatrio. Os controles que no estiverem alinhados na mesma linha podero ser colocados em linhas diferentes do arquivo de sada, causando espaamento adicional. A ao SadaPara semelhante a clicar em Salvar Como/Exportar no menu Arquivo, selecionando a opo Para um Arquivo ou Banco de Dados Externo e selecionando a caixa de seleo Salvar com Formatao na caixa de dilogo que exibida. Os argumentos da ao correspondem s definies nas caixas de dilogo Salvar Como/Exportar. O comando Salvar Como/Exportar, contudo, aplica-se somente ao objeto selecionado na janela Banco de Dados. Utilizando a ao SadaPara, voc pode especificar o objeto ao qual se deseja dar sada. Observao Voc pode dar sada aos dados selecionados com o comando Salvar Como/Exportar. Entretanto, essa funcionalidade no est disponvel com a ao SadaPara. Voc tambm pode apontar para VnculosDoOffice no menu Ferramentas, depois clicar em Analisar com o MS Excel ou Publicar com o MS Word para dar sada a um objeto do banco de dados, e abrir o arquivo de sada imediatamente no Microsoft Excel ou no Microsoft Word. Voc tambm pode clicar em Salvar Como HTML no menu Arquivo, que executa o Assistente de Criao para a Web, o qual voc pode utilizar para dar sada a um objeto do banco de dados para arquivos .html,.htx/.idc ou .asp.

Sair

Voc pode utilizar a ao Sair para sair do Microsoft Access. A ao Sair pode tambm 1.

Opes -> Especifica o que acontece com objetos no salvos quando voc sai do Microsoft Access. Clique em Aviso (para exibir caixas e

1.

REFERNCIA DE MACROS DO MICROSOFT ACCESS especificar uma dentre vrias opes para salvar objetos de banco de dados antes de sair do Microsoft Access. Esta ao tem o mesmo efeito que clicar em Sair a partir do menu Arquivo. Se voc tiver algum objeto no salvo quando clicar neste comando, as caixas de dilogo que aparecero sero as mesmas exibidas quando voc utiliza Aviso para o argumento Opes da ao Sair. Voc pode utilizar a ao Salvar em uma macro para salvar um objeto especificado sem ter de sair do Microsoft Access ou fechar o objeto. Voc pode utilizar a ao Salvar para salvar um objeto do Microsoft Access especificado ou o objeto ativo se nenhum for especificado. Voc tambm pode salvar o objeto ativo com um novo nome em alguns casos (funciona como o comando Salvar como/Exportar do menu Arquivo). dilogos que perguntam se deve salvar cada objeto), Salvar Tudo (para salvar todos os objetos sem avisos de caixas de dilogo) ou Sair (para sair sem salvar os objetos) da caixa Opes da seo Argumentos da Ao da janela Macro. O padro Salvar Tudo.

Salvar

O Microsoft Access no executa nenhuma ao aps a ao Sair em uma macro. Voc pode utilizar esta ao para sair do Microsoft Access sem avisos de caixas de dilogo Salvar utilizando um comando de menu personalizado ou um boto em um formulrio. Por exemplo, voc pode ter um formulrio mestre utilizado para exibir os objetos do seu espao de trabalho personalizado. Esse formulrio pode ter um boto Sair que execute uma macro contendo a ao Sair com o argumento Opes definido como Salvar Tudo. Tipo de Objeto -> O tipo de objeto que voc deseja salvar. Clique em Tabela, Consulta, Formulrio, Relatrio, Macro ou Mdulo na caixa Tipo de Objeto na seo Argumentos da Ao da janela Macro. Para selecionar o objeto ativo, deixe este argumento em branco. Se voc selecionar um tipo de objeto neste argumento, voc precisar selecionar um nome de um objeto existente no argumento Nome do Objeto. Nome do Objeto -> O nome do objeto a ser salvo. A caixa Nome do Objeto mostra todos os objetos do banco de dados do tipo selecionado Observao: Voc no pode utilizar a ao Salvar para salvar pelo argumento Tipo de Objeto. Se voc deixar qualquer um dos seguintes itens o argumento Tipo de Objeto vazio, voc poder deixar este argumento em branco para salvar o com um novo nome: objeto ativo ou, em alguns casos, para salvar o objeto ativo, digitar um novo nome neste Um formulrio no modo Formulrio ou modo Folha de argumento. Se voc digitar um novo nome, este dever seguir as convenes de denominao Dados. padres para objetos do Microsoft Access. Um relatrio em Visualizar Impresso. A ao Salvar funciona com todos os objetos do Um mdulo. banco de dados que o usurio possa abrir e A ao Salvar, seja ela realizada salvar explicitamente. O objeto especificado precisa estar aberto para que a ao Salvar tenha em uma macro executada no algum efeito sobre o objeto. Esta ao tem o banco de dados atual ou em um mesmo efeito que selecionar um objeto e ento banco de dados biblioteca, salv-lo clicando em Salvar no menu Arquivo 1.

1.

REFERNCIA DE MACROS DO MICROSOFT ACCESS ou clicando em Salvar na barra de ferramentas. Deixar o argumento Tipo de Objeto em branco e inserir um novo nome no argumento Nome do Objeto tem o mesmo efeito que clicar em Salvar Como/Exportar no menu Se voc salvar o objeto ativo com Arquivo e digitar um novo nome para o objeto um novo nome, mas o nome for ativo. A utilizao da ao Salvar permite que voc especifique um objeto a ser salvo e que igual ao de um objeto existente desse tipo, uma caixa de dilogo efetue um comando Salvar como/Exportar a partir de uma macro. perguntar se voc deseja sobrescrever o objeto existente. Se voc definiu o argumento Avisos Ativos da ao DefinirAvisos como No, a caixa de dilogo no ser exibida e o objeto antigo ser automaticamente sobrescrito. sempre grava o objeto especificado ou o objeto ativo no banco de dados no qual o objeto foi criado.

SelecionarObjeto

Voc pode utilizar a ao SelecionarObjeto para selecionar um objeto de banco de dados especificado. Freqentemente, voc pode usar essa ao para selecionar um objeto sobre o qual voc queira efetuar aes adicionais. Por exemplo, voc poderia querer restaurar um objeto que tivesse sido minimizado (utilizando a ao Restaurar) ou maximizar uma janela que contenha um objeto com o qual voc queira trabalhar (utilizando a ao Maximizar). Ao selecionar um formulrio, voc poder utilizar as aes IrParaControle, IrParaRegistro e IrParaPgina para mover at reas especficas do formulrio. A ao IrParaRegistro tambm funciona com folhas de dados.

Tipo de Objeto -> O tipo do objeto de banco de dados a selecionar. Clique em Tabela, Consulta, Formulrio, Relatrio, Macro ou Mdulo na caixa Tipo de Objeto na seo Argumentos da Ao da janela Macro. Este um argumento requerido. Nome do Objeto -> O nome do objeto a selecionar. A caixa Nome do Objeto mostra todos os objetos no banco de dados do tipo selecionado pelo argumento Tipo de objeto. Este um argumento requerido, a no ser que voc defina o argumento Na janela banco de dados como Sim. Se voc definir o argumento na janela Banco de dados como Sim e deixar o argumento Nome do Objeto em branco, o Microsoft Access selecionar a guia na janela Banco de Dados que corresponda ao objeto do banco de dados que voc especificar no argumento Tipo de Objeto. Na Janela Banco de Dados -> Especifica se o Microsoft Access seleciona o objeto na janela Banco de dados. Clique em Sim (para selecionar o objeto na janela Banco de dados) ou em No (para no selecionar o objeto na janela Banco de dados). O padro No. A ao SelecionarObjeto funciona com qualquer objeto do Microsoft Access que possa receber o foco. Esta ao d o foco ao objeto especificado

1.

1.

REFERNCIA DE MACROS DO MICROSOFT ACCESS e mostra o objeto se ele estiver oculto. Se o objeto um formulrio, a ao SelecionarObjeto define a propriedade Visvel do formulrio como Sim e devolve o formulrio ao modo definido por suas propriedades de formulrio (por exemplo, como um formulrio modal ou pop-up). Se o objeto no estiver aberto em uma das outras janelas do Microsoft Access, voc pode selecion-lo na janela Banco de dados definindo o argumento Na Janela Banco de Dados como Sim. Se voc definir o argumento Na Janela Banco de Dados como No, uma mensagem de erro aparecer quando voc tentar selecionar um objeto que no esteja aberto. Tipo de Transferncia -> O tipo de Voc pode utilizar a ao transferncia que voc deseja fazer. Selecione TransferirBancoDeDados para importar ou exportar dados entre Importar, Exportar ou Vincular na caixa Tipo de Transferncia da seo Argumentos da Ao da o banco de dados atual do janela Macro. O padro Importar. Microsoft Access e um outro Tipo de Banco de Dados -> O tipo de banco de banco de dados. Voc tambm dados do qual importar, para o qual exportar ou pode vincular uma tabela ao ao qual vincular. Voc pode selecionar banco de dados atual do Microsoft Access a partir de um Microsoft Access ou um dos outros tipos de outro banco de dados. Com uma banco de dados na caixa Tipo de Banco de tabela vinculada, voc tem acesso Dados. O padro Microsoft Access. Os tipos de bancos de dados mostrados no aos dados da tabela enquanto a argumento Tipo de Banco de Dados dependem prpria tabela permanece no de como voc configurou o Microsoft Access. outro banco de dados. Nem todos os tipos de bancos de dados so instalados por padro. Se o tipo de banco de Voc pode importar e exportar tabelas entre o Microsoft Access dados que voc deseja utilizar para importao, exportao ou vinculao no estiver disponvel, e outros tipos de bancos de execute o Programa de Instalao do Microsoft dados. Voc tambm pode Access, clique na opo Adicionar/Remover, exportar consultas seleo do selecione a opo Acesso a Dados na caixa de Microsoft Access para outros dilogo e clique no boto Alterar Opo e tipos de bancos de dados. O selecione ento o tipo de banco de dados que Microsoft Access exporta o voc deseja instalar a partir da caixa Drivers conjunto de resultados da consulta na forma de uma tabela. para Bancos de Dados e clique novamente no boto Alterar Opo. Alguns drivers para banco Voc pode importar e exportar de dados so includos apenas no Office 97 qualquer objeto de banco de ValuPack (alm disso, o ValuPack inclui todos dados do Microsoft Access se ambos os bancos de dados forem os drivers para bancos de dados disponveis a partir do Programa de Instalao do Microsoft do Microsoft Access. Access). Para obter informaes sobre a No Microsoft Access, se voc 1.

TransferirBancoDe Dados

Continuao da Ao TransferirBancoDe Dados

1.

REFERNCIA DE MACROS DO MICROSOFT ACCESS importar uma tabela de um outro banco de dados do Microsoft Access que seja uma tabela vinculada quele banco de dados, ela ainda estar vinculada depois de voc import-la. Ou seja, o vnculo importado, no a tabela em si. Se o banco de dados que voc estiver acessando exigir uma senha, uma caixa de dilogo exibida quando voc executa a macro. Digite a senha nessa caixa de dilogo. Observao : Voc s pode importar e exportar dados entre bancos de dados do Microsoft Access e do FoxPro verso 3.0. Voc no pode vincular s tabelas nesses bancos de dados do FoxPro. A ao TransferirBancoDeDados semelhante a apontar para Obter Dados Externos ou Salvar Como/Exportar no menu Arquivo da janela Banco de Dados e clicar em Importar ou Vincular Tabelas. Voc pode utilizar esses comandos para selecionar uma fonte de dados, como Microsoft Access ou um tipo de banco de dados, planilha ou arquivo de texto. Se voc selecionar um banco de dados, uma ou mais caixas de dilogo sero exibidas para que nelas voc selecione o tipo de objeto a ser importado ou exportado (para bancos de dados Microsoft Access), o nome do objeto e outras opes, dependendo do banco de dados do qual voc est importando ou ao qual est exportando ou vinculando. Esses argumentos da 1. instalao de drivers para banco de dados a partir do ValuPack, consulte Sobre o Office 97 ValuPack. Nome do Banco de Dados -> O nome do banco de dados do qual importar, para o qual exportar ou ao qual vincular. Inclua o nome completo do caminho. Este um argumento requerido. Para tipos de bancos de dados que utilizam arquivos separados para cada tabela, como o FoxPro, Paradox e dBASE, digite a pasta que contm o arquivo. Digite o nome do arquivo no argumento Origem (para importar ou vincular) ou o argumento Destino (para exportar). Para bancos de dados ODBC, digite a seqncia de conexo Open Database Connectivity (ODBC) completa. Para visualizar um exemplo de seqncia de conexo, vincule uma tabela externa ao Microsoft Access apontando para Obter Dados Externos no menu Arquivo e clicando em Vincular Tabelas. Abra a tabela no modo Estrutura e visualize as propriedades da tabela. O texto na definio da propriedade Descrio a seqncia de conexo para esta tabela. Para obter maiores informaes sobre seqncias de conexo ODBC, consulte o arquivo Ajuda ou alguma outra documentao sobre o driver ODBC deste tipo de banco de dados ODBC. Tipo de Objeto -> O tipo de objeto a importar ou exportar. Se voc selecionar Microsoft Access para o argumento Tipo de Banco de Dados, voc poder selecionar Tabela, Consulta, Formulrio, Relatrio, Macro ou Mdulo na caixa Tipo de Objeto. Se voc selecionar qualquer outro tipo de banco de dados ou se selecionar Vincular na caixa Tipo de Transferncia, este argumento ser ignorado. O padro Tabela. Se voc estiver exportando uma consulta seleo para um banco de dados do Microsoft Access, selecione Tabela neste argumento para exportar o conjunto de resultados da consulta, e selecione Consulta para exportar a prpria consulta. Se voc estiver exportando uma consulta seleo para um outro tipo de banco de dados, este argumento ser ignorado e o

1.

REFERNCIA DE MACROS DO MICROSOFT ACCESS ao TransferirBancoDeDados refletem as opes dessas caixas de dilogo. Se voc deseja fornecer informaes de ndice para uma tabela vinculada FoxPro ou dBASE, primeiro vincule a tabela FoxPro ou dBASE, apontando para Obter Dados Externos no menu Arquivo e clicando em Vincular Tabelas, e especifique ento os ndices nas caixas de dilogos desse comando. O Microsoft Access armazena as informaes de ndice em um arquivo de informaes (.inf) especial, localizado na pasta Office (o caminho C:\Arquivos de Programas\Microsoft Office\Office). Voc pode ento excluir o vnculo tabela. Na prxima vez que utilizar a ao TransferirBancoDeDados para vincular esta tabela FoxPro ou dBASE, o Microsoft Access utilizar as informaes de ndice que voc tiver especificado. Observao : Se voc consultar ou filtrar uma tabela vinculada, a consulta ou o filtro coincidir maisculas e minsculas. conjunto de resultados da consulta ser exportado. Origem -> O nome da tabela, consulta seleo ou objeto do Microsoft Access que voc deseja importar, exportar ou vincular. Para alguns tipos de banco de dados, como o FoxPro, Paradox ou dBASE, um nome de arquivo. Inclua a extenso de nome de arquivo (como .dbf) no nome. Este um argumento requerido. Destino -> O nome da tabela, consulta seleo ou objeto do Microsoft Access importado, exportado ou vinculado, no banco de dados de destino. Para alguns tipos de bancos de dados, como FoxPro, Paradox ou dBASE, um nome de arquivo. Inclua a extenso de nome de arquivo (como .dbf) no nome. Este um argumento requerido. Se voc selecionar Importar no argumento Tipo de Transferncia e Tabela no argumento Tipo de Objeto, o Microsoft Access criar uma nova tabela contendo os dados da tabela importada. Se voc importar uma tabela ou outro objeto, o Microsoft Access adicionar um nmero ao nome se este conflitar com um nome existente. Por exemplo, se voc importar Funcionrios e esse nome j existir, o Microsoft Access renomear a tabela ou outro objeto importado para Funcionrios1. Se voc exportar para um banco de dados do Microsoft Access ou algum outro, o Microsoft Access substituir automaticamente qualquer tabela ou outro objeto existente de mesmo nome. Somente Estrutura -> Especifica se vai importar ou exportar somente a estrutura de uma tabela de banco de dados, sem nenhum dos dados. Selecione Sim ou No. O padro No. Tipo de Transferncia -> O tipo de transferncia que voc deseja fazer. Selecione Importar, Exportar ou Vincular na caixa Tipo de Transferncia da seo Argumentos da Ao da janela Macro. O padro Importar. Tipo de Planilha Eletrnica -> O tipo de planilha do qual importar, para o qual exportar ou ao qual vincular. Voc pode selecionar um dos tipos de planilha da caixa. O padro Microsoft Excel 3.

TransferirPlanilha

Voc pode utilizar a ao TransferirPlanilha para importar ou exportar dados entre o banco de dados atual do Microsoft Access e um arquivo de planilha. Voc tambm pode vincular os dados de uma planilha do Microsoft Excel ao banco de dados atual do Microsoft Access. Com uma planilha vinculada, 1.

1.

REFERNCIA DE MACROS DO MICROSOFT ACCESS voc pode visualizar e editar os dados da planilha com o Microsoft Access ainda permitindo acesso completo aos dados a partir do seu programa de planilha eletrnica Microsoft Excel. Voc tambm pode vincular aos dados em um arquivo de planilha do Lotus 1-23, mas estes dados sero somente para leitura no Microsoft Access. Voc pode exportar os dados nas consultas seleo do Microsoft Access para planilhas. O Microsoft Access exporta o conjunto de resultados da consulta, tratando-o como uma tabela. Os dados de planilha que voc acrescenta a uma tabela existente do Microsoft Access precisam ser compatveis com a estrutura da tabela. Cada campo na planilha precisa ser do mesmo tipo de dados que o campo correspondente na tabela, e os campos precisam estar na mesma ordem (a menos que voc defina o argumento Contm Nomes de Campos como Sim, situao na qual os nomes de campos da planilha precisam coincidir com os nomes de campos da tabela). Esta ao semelhante a apontar para Obter Dados Externos ou Salvar Como/Exportar no menu Arquivo da janela Banco de Dados e clicar em Importar ou Vincular Tabelas. Voc pode utilizar esses comandos para selecionar uma fonte de dados, como o Microsoft Access ou um tipo de banco de dados, planilha ou arquivo de texto. Se voc selecionar uma planilha, 1. Observaes : Caso queira importar, exportar ou vincular dados de planilha eletrnica de ou para arquivos Lotus 1-2-3, voc precisa instalar o driver para o Lotus 1-2-3 a partir do Office 97 ValuPack. Para obter informaes sobre a instalao desse driver a partir do ValuPack, consulte Sobre o Office 97 ValuPack. Voc pode importar dos arquivos .WK4 do Lotus e vincular a eles (somente leitura), mas no pode exportar dados do Microsoft Access a esse formato de planilha. O Microsoft Access no suporta mais importao, exportao ou vinculao de dados de planilhas do Lotus .WKS ou do Microsoft Excel verso 2.0 com esta ao. Se voc desejar importar a partir de ou vincular aos dados de planilha no Microsoft Excel verso 2.0 ou no formato .WKS do Lotus, converta os dados da planilha em uma verso posterior do Microsoft Excel ou Lotus 1-2-3 antes de importar ou vincular os dados ao Microsoft Access. Nome da Tabela -> O nome da tabela do Microsoft Access para a qual importar, da qual exportar ou qual vincular dados de planilha. Voc tambm pode digitar o nome da consulta seleo do Microsoft Access a partir da qual voc deseja exportar os dados. Este um argumento requerido. Se voc selecionar Importar no argumento Tipo de Transferncia, o Microsoft Access acrescentar os dados de planilha a essa tabela, se a tabela j existir. Caso contrrio, o Microsoft Access criar uma nova tabela contendo os dados de planilha. No Microsoft Access, voc no pode utilizar uma instruo SQL para especificar os dados a exportar quando estiver utilizando a ao TransferirPlanilha. Em vez de utilizar uma instruo SQL, preciso antes criar uma consulta e, em seguida, especificar o nome da consulta no argumento Nome da Tabela. Nome do Arquivo ->O nome do arquivo de planilha do qual importar, para o qual exportar ou ao qual vincular. Inclua o caminho completo. Este um argumento requerido.

Continuao da Ao TransferirPlanilha

1.

REFERNCIA DE MACROS DO MICROSOFT ACCESS O Microsoft Access cria uma nova planilha quando voc exporta dados a partir dele. Se o nome do arquivo for igual ao nome de uma planilha existente, o Microsoft Access substituir a planilha existente, a menos que voc esteja exportando para uma planilha do Microsoft Excel verso 5.0, 7.0, ou um workbook do Excel 97. Neste caso, o Microsoft Access copiar os dados exportados no prximo worksheet novo do workbook. Observao : Se voc consultar Se voc estiver importando de ou vinculando a ou filtrar uma planilha vinculada, uma planilha do Microsoft Excel verso 5.0, 7.0 ou do Excel 97, voc poder especificar um a consulta ou o filtro coincidir worksheet utilizando o argumento Intervalo. maisculas e minsculas. Contm Nomes de Campos -> Especifica Se voc vincular a uma planilha se a primeira linha da planilha contm os nomes do Excel aberta no modo Editar, dos campos. Se voc selecionar Sim, o Microsoft Access utilizar os nomes dessa linha o Access aguardar at que a como nomes de campo na tabela do Microsoft planilha saia do modo Editar antes de completar o vnculo; no Access quando voc importar ou vincular os dados de planilha. Se voc selecionar No, o h tempo limite. Microsoft Access tratar a primeira linha como uma linha de dados normal. O padro No. aparecer uma srie de caixas de dilogo ou ser executado um assistente do Microsoft Access, no qual voc selecionar o nome da planilha e outras opes. Os argumentos da ao TransferirPlanilha refletem as opes dessas caixas de dilogos ou dos assistentes. Quando voc exportar uma tabela ou uma consulta seleo do Microsoft Access para uma planilha, os nomes dos campos sero inseridos na primeira linha da planilha, independentemente daquilo que for selecionado neste argumento. Intervalo -> O intervalo de clulas a importar ou vincular. Deixe este argumento em branco para importar ou vincular toda a planilha. Voc pode digitar o nome de um intervalo da planilha ou especificar o intervalo de clulas a importar ou vincular, como A1:E25 (observe que a sintaxe A1..E25 no funciona mais no Microsoft Access). Se voc estiver importando de uma planilha ou vinculando a ela, uma verso Microsoft Excel 5.0, 7.0 ou do Excel 97, voc poder colocar o nome da planilha e um ponto de exclamao antes do intervalo; por exemplo, Poupana!A1:C7. Observao Quando voc exporta para um planilha, preciso deixar este argumento em branco. Se voc inserir um intervalo, a exportao ir falhar. 1.

1. TransferirTexto

REFERNCIA DE MACROS DO MICROSOFT ACCESS Voc pode utilizar a ao TransferirTexto para importar ou exportar texto entre o banco de dados atual do Microsoft Access e um arquivo de texto. Voc pode tambm vincular os dados de um arquivo de texto ao banco de dados atual do Microsoft Access. Com um arquivo de texto vinculado, voc pode visualizar os dados de texto com o Microsoft Access e, ao mesmo tempo, permitir acesso completo aos dados a partir de seu programa de processamento de texto. Voc pode tambm importar de uma tabela ou lista, exportar para elas e vincul-las a um arquivo HTML (*.html). Voc pode exportar os dados de consultas seleo do Microsoft Access para arquivos de texto. O Microsoft Access exporta o conjunto de resultados da consulta, tratando-o como uma tabela. Os dados de texto que voc acrescenta a uma tabela existente do Microsoft Access precisam ser compatveis com a estrutura da tabela. Cada campo do texto precisa ser do mesmo tipo de dados que o do campo correspondente na tabela e os campos precisam estar na mesma ordem (a menos que voc defina o argumento Contm Nomes de Campos como Sim; neste caso, os nomes dos campos no texto precisam coincidir com os nomes dos campos na tabela). Esta ao semelhante a apontar para Obter Dados Externos ou Salvar Como/Exportar no menu Arquivo da janela Banco de 1. Tipo de Transferncia -> O tipo de transferncia que voc deseja fazer. Voc pode importar dados de, exportar dados para, ou vincular dados de arquivos de texto delimitado , de largura fixa ou arquivos HTML. Voc tambm pode exportar dados para um arquivo de dados de mala direta do Microsoft Word, o qual voc pode ento utilizar com o recurso de mala direta do Microsoft Word para criar documentos mesclados, como cartas modelo e etiquetas de endereamento. Selecione Importao Delimitada, Importao com Largura Fixa, Importao HTML, Exportao Delimitada, Exportao com Largura Fixa, Exportao HTML, Exportar Mala Direta do Word para Windows, Vnculo Delimitado, Vnculo com Largura Fixa ou Vincular HTML na caixa Tipo de Transferncia na seo Argumentos da Ao da janela Macro. O padro Importao Delimitada. Nome da Especificao -> O nome da especificao para o conjunto de opes que determinam como um arquivo texto importado, exportado ou vinculado. Este um argumento requerido para arquivos de texto de largura fixa. Voc pode utilizar o subcomando Importar ou Vincular Tabelas do comando Obter Dados Externos ou o comando Salvar Como/Exportar do menu Arquivo para criar uma especificao para um determinado tipo de arquivo de texto, como um arquivo de texto delimitado que utiliza tabulaes para separar campos e tem um formato ms-dia-ano para datas. Quando voc clica em um desses comandos e seleciona um tipo de arquivo de texto para importar, exportar ou vincular, o Assistente de Importao de Texto, o Assistente de Exportao de Texto ou o Assistente de Vinculao de Texto executado. Voc pode clicar no boto Avanado do assistente e, em seguida, definir e salvar uma especificao na caixa de dilogo que exibida. Voc pode ento digitar o nome da especificao nesse argumento sempre que desejar importar ou exportar o mesmo tipo de arquivo de texto. Voc pode importar, exportar ou vincular

1.

REFERNCIA DE MACROS DO MICROSOFT ACCESS arquivos de texto delimitado sem digitar um nome de especificao para esse argumento. Nesse caso, o Microsoft Access utiliza os padres a partir da caixa de dilogo do assistente. O Microsoft Access utiliza um formato predeterminado para arquivos de dados de mala direta, portanto voc nem precisa digitar um nome de especificao para esse argumento quando exporta esses tipos de arquivos. Voc pode utilizar especificaes de importao/exportao com arquivos HTML, mas a nica parte da especificao que se aplica aquela para a formatao do tipo de dados. Nome da Tabela -> O nome da tabela do Microsoft Access para a qual importar, da qual exportar ou qual vincular dados de texto. Voc pode tambm digitar o nome de uma consulta Dica: Uma especificao de importao/exportao armazena seleo do Microsoft Access da qual voc deseja exportar os dados. Este um argumento as informaes que o Microsoft requerido. Access precisa para importar, exportar ou vincular um arquivo Se voc clicar em Importao Delimitada, Importao com Largura Fixa ou Importao de texto. Voc pode utilizar especificaes armazenadas para HTML na caixa Tipo de Transferncia, o Microsoft Access acrescentar os dados de texto importar, exportar ou vincular dados de texto a partir de ou para a essa tabela, se a tabela j existir. Caso contrrio, o Microsoft Access criar uma nova arquivos de texto similares. Por tabela contendo os dados de texto. exemplo, possvel receber No Microsoft Access, voc no pode utilizar valores de vendas semanais em uma instruo SQL para especificar dados para um arquivo de texto de um exportar quando estiver utilizando a ao computador mainframe. Voc TransferirTexto. Em lugar de utilizar uma pode criar e salvar uma instruo SQL, voc precisa antes criar uma especificao para esse tipo de consulta e ento especificar o nome da consulta dados e ento utilizar a no argumento Nome da Tabela. especificao sempre que Nome do Arquivo -> O nome do arquivo de adicionar esses valores ao seu texto do qual importar, para o qual exportar ou banco de dados do Microsoft ao qual vincular. Inclua o nome completo do Access. caminho. Este um argumento requerido. Observao : Se voc consultar O Microsoft Access cria um novo arquivo de texto quando voc exporta dados a partir dele. ou filtrar um arquivo de texto vinculado, a consulta ou o filtro Se o nome de arquivo for igual ao de um outro existente, o Microsoft Access substituir o coincidir maisculas e arquivo de texto existente. minsculas. Se quiser importar ou vincular uma determinada tabela ou lista de um arquivo HTML, voc pode utilizar o argumento Nome da Tabela HTML. Contm Nomes de Campos -> Especifica se a Dados e clicar em Importar ou Vincular Tabelas. Voc pode utilizar esses comandos para selecionar uma fonte de dados, como o Microsoft Access ou um tipo de banco de dados, planilha ou arquivo de texto. Se voc selecionar um arquivo de texto delimitado, um de largura fixa, ou um arquivo HTML, um assistente solicitar que voc selecione o nome do arquivo e outras opes. Os argumentos da ao TransferirTexto refletem as opes desses assistentes. 1.

Continuao da Ao TransferirTexto

1.

REFERNCIA DE MACROS DO MICROSOFT ACCESS primeira linha do arquivo de texto contm os nomes dos campos. Se voc selecionar Sim, o Microsoft Access utilizar os nomes dessa linha como nomes dos campos na tabela do Microsoft Access quando voc importar ou vincular os dados de texto. Se voc selecionar No, o Microsoft Access tratar a primeira linha como uma linha de dados normal. O padro No. O Microsoft Access ignora esse argumento para arquivos de dados de mala direta do Word para Windows porque a primeira linha precisa conter os nomes dos campos.. Ao exportar-se uma tabela ou uma consulta seleo do Microsoft Access para um arquivo texto delimitado ou de largura fixa, o Microsoft Access digitar os nomes dos campos da sua tabela ou consulta seleo na primeira linha do arquivo de texto se voc tiver selecionado Sim para este argumento. Se voc estiver importando ou vinculando um arquivo de texto de largura fixa e selecionar Sim nesta caixa, a primeira linha contendo os nomes dos campos dever utilizar o delimitador de campo definido na especificao de importao/exportao para separar os nomes dos campos. Se voc estiver exportando para um arquivo de texto de largura fixa e selecionar Sim para este argumento, o Microsoft Access digitar os nomes dos campos na primeira linha do arquivo de texto com este delimitador. Nome da Tabela HTML -> O nome da tabela ou lista do arquivo HTML que voc deseja importar ou vincular. Este argumento ser ignorado, a menos que o argumento Tipo de Transferncia esteja definido como Importao HTML ou Vnculo HTML. Se deixar este argumento em branco, a primeira tabela ou lista do arquivo HTML ser importada ou vinculada. O nome da tabela ou lista do arquivo HTML determinado pelo texto especificado pela marca <CAPTION>, se houver uma. Se no houver; o nome ser determinado pelo texto especificado pela marca <TITLE>. Se mais de uma tabela ou lista tiver o mesmo nome, o Microsoft Access as diferenciar adicionando um nmero ao final de cada nome; por exemplo, Funcionrios1 e Funcionrios2. 1.

1.

REFERNCIA DE MACROS DO MICROSOFT ACCESS

Nesta tabela foram apresentadas todas as aes de Macro disponveis no Microsoft Access, a sua utilizao e os parmetros de cada uma. Voc pode utilizar este material como uma referncia quando estiver criando macros para os seus Bancos de Dados. No Prximo item veremos algumas aplicaes prticas de macros, para salientarmos a aplicao de algumas das aes apresentadas. Tambm estaremos associando Macros com Eventos em formulrios e relatrios, o que uma prtica bastante comum.

1.

1.