Você pode usar a função DDESend para iniciar uma conversa de DDE (troca de dados dinâmica) com outro aplicativo e enviar um item de informações para esse aplicativo a partir de um controle em um formulário ou relatório.
Por exemplo, você pode usar a função DDESend na propriedade ControlSource de uma caixa de texto para enviar os dados exibidos nessa caixa de texto para uma célula especificada em uma planilha Microsoft Office Excel 2007.
Sintaxe
DDESend ( aplicativo, tópico, item, dados )
A sintaxe da função DDESend tem esses argumentos:
|
Argumento |
Descrição |
|
do aplicativo |
Um expressão de cadeia de caracteres identificar um aplicativo que pode participar de uma conversa DDE. Normalmente, o 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 uma item de dados reconhecida pelo aplicativo. Verifique a documentação do outro aplicativo para obter uma lista de itens possíveis. |
|
confidenciais |
Uma cadeia de caracteres ou expressão que contém os dados a serem enviados para o aplicativo. |
Comentários
A função DDESend inicia uma conversa DDE com o aplicativo e o tópico e identifica o item como o item de dados que receberá dados. Por exemplo, se o aplicativo for Excel, o tópico poderá ser "Sheet1"e o item poderá ser um identificador de linha e coluna, como "R1C1", ou o nome de um intervalo de células.
O argumento de dados especifica as informações que você deseja enviar. Pode ser uma cadeia de caracteres literal, como "Report prepared by John", ou pode ser uma expressão que inclui o resultado de uma função que cria uma cadeia de caracteres, como "Prepared on " & Date(). Se o 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 DDESend enviará dados para a primeira entrada.
No exemplo a seguir, a função DDESend envia a cadeia de caracteres "Some text" para a 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 ControlSource na folha de propriedades do controle:
=DDESend("Excel", "Sheet1", "R1C1", "Some text")
Suponha que você queira enviar dados de um controle associado em um formulário de Microsoft Office Access 2007 para uma célula em uma planilha do Excel. A propriedade ControlSource do controle vinculado já contém um nome de campo ou expressão. Você pode criar outra caixa de texto ou caixa de combinação e definir sua propriedade ControlSource como uma expressão, incluindo a função DDESend , em que os dados são o nome do controle vinculado. Por exemplo, se você tiver uma caixa de texto vinculada chamada LastName, poderá criar outra caixa de texto e definir sua propriedade ControlSource para o seguinte:
=DDESend("Excel", "Sheet1", "R1C1", [LastName])
Esse controle intermediário deve ser uma caixa de texto ou uma caixa de combinação. Você não pode usar o nome de um controle vinculado como o argumento de dados para uma caixa de marcar ou grupo de opções.
Você pode usar a função DDESend somente na configuração de propriedade ControlSource de uma caixa de texto, grupo de opções, caixa de marcar ou caixa de combinação em um formulário. Você não pode chamar a função DDESend de um módulo VBA (Visual Basic for Applications).
Quando você usa a função DDESend , o controle se torna somente leitura em modo Formulário e Visualização de Impressão. Como a propriedade ControlSource também é somente leitura no modo de exibição Formulário e Visualização de Impressão, as alterações no controle devem ser feitas no modo Design.
A memória e os recursos do Microsoft Windows e 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 aplicativo não está em execução ou não reconhece o tópico ou se o número máximo de conversas já foi atingido, a função DDESend retornará um Null.
Observação: O outro aplicativo pode estar configurado para ignorar sua solicitação de uma conversa DDE. Em caso afirmativo, a função DDESend retornará um Null. Da mesma forma, você pode definir o Access para ignorar solicitações de outros aplicativos: clique em Opções de Acesso no menu Arquivo e clique em Avançado na caixa de diálogo Configurações do Aplicativo . Em operações DDE, selecione Ignorar solicitações DDE.
Dica Se você precisar manipular objetos de outro aplicativo do Access, talvez deseje considerar o uso da Automação.
A tabela a seguir ilustra como a função DDESend se comporta quando você a usa com cada um dos controles.
|
Controle |
Comentários |
|
Caixa de texto ou caixa de combinação |
Como a caixa de texto ou a caixa de combinação aparece em branco na exibição Formulário e visualização de impressão, talvez você queira definir sua propriedade Visible como False. O argumento de dados pode se referir a outro controle. O exemplo a seguir mostra como você pode enviar o conteúdo de um controle chamado LastName para uma planilha do Excel: =DDESend("Excel", "Sheet1", "R1C1", [LastName]) |
|
Grupo de opções |
Nenhum dos botões de opção no grupo de opções está selecionado no modo de exibição Formulário e Visualização de Impressão. Talvez você queira tornar o grupo de opções (e seus botões) invisível definindo sua propriedade Visible como False. O argumento de dados deve conter dados numéricos, como "2". Se o argumento de dados não for numérico, a função DDESend não enviará as informações e o item não será alterado. |
|
Caixa de seleção |
A caixa marcar é sombreada no modo de exibição Formulário e Visualização de Impressão. Talvez você queira torná-la invisível definindo sua propriedade Visible como False. O argumento de dados deve conter dados numéricos, como "2". Se o argumento de dados não for numérico, a função DDESend não enviará as informações e o item não será alterado. |
