Função DDE

Aplica-se A
Access para Microsoft 365 Access 2024 Access 2021 Access 2019 Access 2016

Pode utilizar a função DDE para iniciar uma conversação DDE (dynamic data exchange) com outra aplicação, pedir uma informação a essa aplicação e apresentar essa informação num controlo num formulário ou relatório.

Por exemplo, pode utilizar a função DDE na propriedade ControlSource de uma caixa de texto para apresentar dados de uma célula especificada numa folha de cálculo do Excel.

Sintaxe

DDE(aplicação, tópico, item)

A sintaxe da função DDE tem os seguintes argumentos:

Um rgument Descrição
Aplicação Uma expressão de cadeia que identifica uma aplicação que pode participar numa conversação 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ção DDE com o Excel, escreva "Excel" para o argumento de aplicação .
tópico Uma expressão de cadeia de caracteres que é o nome de um tópico reconhecido pelo aplicativo. O argumento de tópico é geralmente um documento ou ficheiro de dados. Consulte a documentação da outra aplicação 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. Consulte a documentação da outra aplicação para obter uma lista de possíveis itens.

Comentários

A função DDE tenta iniciar uma conversação DDE com o aplicativo e 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 estiver a pedir dados a partir do Excel, o item pode ser um identificador de linha e coluna, como "R1C1" ou o nome de um intervalo de células. No exemplo seguinte, a função DDE pede informações a partir da célula na linha 1, coluna 1 numa folha de cálculo do Excel. Você pode inserir esta expressão para um controle de caixa de texto na caixa de propriedade ControlSource na folha de propriedades do controle:

=DDE("Excel", "Sheet1", "R1C1")

Só pode utilizar a função DDE na propriedade ControlSource de uma caixa de texto, grupo de opções, caixa de verificação ou caixa de combinação. Não pode chamar a função DDE a partir de um módulo VBA (Visual Basic for Applications).

Quando utiliza a função DDE , o controlo torna-se só de leitura na vista Formulário e Pré-visualização. Por exemplo, se utilizar a função DDE numa caixa de texto, o texto na caixa de texto não pode ser editado. Tem de editar o texto na outra aplicação. Como a propriedade ControlSource é somente leitura no modo Formulário e na Visualização de Impressão, as alterações no controle devem ser feitas no modo Design.

O Microsoft Windows e a memória e recursos do computador determinam o número máximo de conversações DDE que podem ser abertas em simultâneo. Se a conversação não puder ser iniciada porque a outra aplicação não está em execução ou não reconhece o tópico especificado, ou se o número máximo de conversações já tiver sido alcançado, a função DDE devolve um resultado Nulo.

Nota

A outra aplicação pode ser configurada para ignorar o seu pedido para uma conversação DDE. Se for o caso, a função DDE devolve um resultado Nulo. Da mesma forma, pode definir o Access para ignorar pedidos de outras aplicações: clique em Opções do Access no menu Ficheiro e, em seguida, clique em Avançadas na caixa de diálogo Definições da Aplicação . Em Operações DDE, selecione Ignorar solicitações DDE.

Sugestão

Se precisar de manipular objetos de outra aplicação a partir do Access, recomendamos que utilize a Automatização.

A tabela seguinte ilustra o comportamento da função DDE quando a utiliza com cada um dos controlos.

Controlo Observações
Caixa de texto O argumento de item pode referir-se a texto ou números. Se item se referir a mais do que uma informação, tal como um intervalo com nome numa folha de cálculo do Excel que contém múltiplas células, a função DDE devolve a primeira entrada. Pode utilizar esta função com uma caixa de texto para apresentar os dados contidos numa célula na folha de cálculo.
Caixa de combinação A função DDE preenche a caixa de combinação com as informações referidas por item. Não pode introduzir dados na porção de texto da caixa. Pode utilizar a função DDE com uma caixa de combinação para apresentar uma lista de países/regiões que mantém numa folha de cálculo do Excel.
Grupo de opções A propriedade ValorDaOpção de cada botão de opção num grupo de opções está definida como um número. Normalmente, o primeiro valor do botão é 1, o segundo é 2 e assim sucessivamente. O número retornado pela função DDE determina qual botão de opção será selecionado.
Por exemplo, se a função DDE devolver 2, o segundo botão será selecionado. Se esta função devolver um valor que não corresponda a nenhuma das definições da propriedade ValorDaOpção , nenhum dos botões será selecionado. Se item se referir a mais do que uma informação, tal como um intervalo com nome numa folha de cálculo do Excel que contém múltiplas células, a função DDE devolve a primeira entrada.
Caixa de verificação Se a função DDE devolver 0, a caixa de verificação será desmarcada. Se esta função devolver um número diferente de zero, tal como 1 ou –1, a caixa estará selecionada. Se o item fizer referência a texto ou a mais do que uma informação, tal como um intervalo com nome numa folha de cálculo do Excel que contenha múltiplas células, a caixa de verificação não estará disponível.