Você pode usar a função DDE para iniciar uma conversa DDE (troca dinâmica de dados) com outro aplicativo, solicitar um item de informações desse aplicativo e exibir essas informações em um controle em um formulário ou relatório.
Por exemplo, você pode usar a função DDE na propriedade ControlSource de uma caixa de texto para exibir dados de uma célula especificada em uma planilha do Excel.
Sintaxe
DDE(aplicativo, tópico, item)
A sintaxe da função DDE tem os seguintes argumentos:
| Um argumento | Descrição |
|---|---|
| do aplicativo | Uma expressão de cadeia de caracteres identificando um aplicativo que pode participar de uma conversa DDE. Normalmente, aplicativo é o nome de um arquivo .exe (sem a extensão .exe) para um aplicativo baseado no Microsoft Windows, como o Excel. Por exemplo, para iniciar uma conversa DDE com o Excel, digite "Excel" para o argumento do aplicativo . |
| tópico | Uma expressão de cadeia de caracteres que é o nome de um tópico reconhecido pelo aplicativo. O argumento do tópico geralmente é um documento ou arquivo de dados. Verifique a documentação do outro aplicativo para obter uma lista de possíveis tópicos. |
| item | Uma expressão de cadeia de caracteres que é o nome de um item de dados reconhecido pelo aplicativo. Verifique a documentação do outro aplicativo para obter uma lista de possíveis itens. |
Comentários
A função DDE tenta iniciar uma conversa DDE com o aplicativo e o tópico especificados e solicita os dados no item. Se for bem-sucedida, a função DDE retornará uma cadeia de caracteres que contém as informações solicitadas.
Se você estiver solicitando dados do Excel, o item pode ser um identificador de linha e coluna, como "R1C1" o nome de um intervalo de células. No exemplo a seguir, a função DDE solicita informações da célula na linha 1, coluna 1 em uma planilha do Excel. Você pode inserir essa expressão para um controle de caixa de texto na caixa de propriedade OrigemDoControle na folha de propriedades do controle:
=DDE("Excel", "Sheet1", "R1C1")
Você pode usar a função DDE somente na propriedade OrigemDoControle de uma caixa de texto, grupo de opções, caixa de marca ou caixa de combinação. Você não pode chamar a função DDE de um módulo VBA (Visual Basic for Applications).
Quando você usa a função DDE , o controle se torna somente leitura no modo Formulário e na Visualização de Impressão. Por exemplo, se você usar a função DDE em uma caixa de texto, o texto na caixa de texto não poderá ser editado. Você deve editar o texto no outro aplicativo. Como a propriedade ControlSource é somente leitura no modo Formulário e Visualização de Impressão, as alterações no controle devem ser feitas no modo Design.
O Microsoft Windows e a memória e os recursos do computador determinam o número máximo de conversas DDE que podem ser abertas simultaneamente. Se a conversa não puder ser iniciada porque o outro aplicativo não está em execução ou não reconhece o tópico especificado, ou se o número máximo de conversas já foi atingido, a função DDE retornará um Nulo.
Observação
O outro aplicativo pode ser configurado para ignorar sua solicitação de uma conversa DDE. Nesse caso, a função DDE retornará um Null. Da mesma forma, você pode definir o Access para ignorar solicitações de outros aplicativos: clique em Opções do Access no menu Arquivo e, em seguida, clique em Avançado na caixa de diálogo Configurações do aplicativo . Em Operações do DDE, selecione Ignorar solicitações do DDE.
Dica
Se você precisar manipular os objetos de outro aplicativo do Access, considere o uso da Automação.
A tabela a seguir ilustra como a função DDE se comporta quando você a usa com cada um dos controles.
| Controle | Comentários |
|---|---|
| Caixa de texto | O argumento do item pode se referir a texto ou números. Se item se referir a mais de uma informação, como um intervalo nomeado em uma planilha do Excel que contém várias células, a função DDE retornará a primeira entrada. Você poderia usar essa função com uma caixa de texto para exibir os dados contidos em uma célula da planilha. |
| Caixa de combinação | A função DDE preenche a caixa de combinação com as informações referidas pelo item. Você não pode inserir dados na parte de texto da caixa. Você pode usar a função DDE com uma caixa de combinação para exibir uma lista de países/regiões mantidos em uma planilha do Excel. |
| Grupo de opções | A propriedade OptionValue de cada botão de opção em um grupo de opções é definida como um número. Normalmente, o valor do primeiro botão é 1, o segundo é 2 e assim por diante. O número retornado pela função DDE determina qual botão de opção será selecionado. Por exemplo, se a função DDE retornar 2, o segundo botão será selecionado. Se essa função retornar um valor que não corresponda a nenhuma das configurações da propriedade OptionValue , nenhum dos botões será selecionado. Se item se referir a mais de uma informação, como um intervalo nomeado em uma planilha do Excel que contém várias células, a função DDE retornará a primeira entrada. |
| Caixa de seleção | Se a função DDE retornar 0, a caixa de marca será desmarcada. Se esta função retornar um número diferente de zero, como 1 ou –1, a caixa será marcada. Se o item se referir a texto ou a mais de uma informação, como um intervalo nomeado em uma planilha do Excel que contém várias células, a caixa de marcação não estará disponível. |