Функция DDEPoke( )

Передает данные между приложением-клиентом и сервером в ходе сеанса связи ди амического обмена данными (DDE).

Синтаксис

DDEPoke(nChannelNumber, cItemName, cDataSent
[, cDataFormat [, cUDFName]])

Параметры

nChannelNumber

Задает номер канала приложения, в которое посылаются данные. Если данный номер определяет канал сервера, DDEPoke( ) посылает данные в ответ на запрос или ра ее установленную связь с уведомлением, или автоматическую связь.

cItemName

Задает имя элемента, в который посылаются данные. Это имя зависит от приложе ия и должно быть ему понятно. Например, Microsoft Excel допускает использование имени элемента R1C1 для обозначения первой ячейки электронной таблицы.

cDataSent

Задает данные, посылаемые в элемент cItemName.

cDataFormat

Задает формат, используемый при передаче данных. По умолчанию используется фо мат CF_TEXT. В этом формате поля разделяются табуляторами, а записи возвратом каретки и переводом строки.

cUDFName

Допускает асинхронную передачу данных. Если имя функции cUDFName опущено, клиент переходит в ожидание на период времени, установленный фу кцией DDESetOption( ). Если вы задали в аргументе cUDFName имя функции, определенной пользователем, выполнение программы клиента будет п одолжено сразу после выдачи запроса.

Когда данные берутся из приложения-сервера, выполняется пользовательская фу кция cUDFName. Ей передаются шесть параметров в следующем порядке:

Параметр	Содержимое
Channel Number (номер канала)	Номер канала приложения-сервера
Action (действие)	XACTCOMPLETE (успешная транзакция) XACTFAIL (ошибка в транзакции)
Item (элемент)	Имя элемента, например R1C1 в качестве имени ячейки электронной таблицы Microsoft Excel
Data (данные)	Новые данные (REQUEST) или передаваемые данные (POKE или EXECUTED)
Format (формат)	Формат данных, например CF_TEXT
Transaction Number (номер транзакции)	Номер транзакции, возвращаемый функцией DDEPoke( )

Используйте функцию DDEAbortTrans( ) для отмены незавершенной транзакции. Если транзакция завершается неудачно, с помощью функции DDELastError( ) можно опре елить причину ошибки.

Если задан аргумент cUDFName, функция DDEPoke( ) возвращает номер транзакции в случае успешного выполнения или 1 в случае ошибки.

Результат

Логический

Комментарии

Допустима только в Visual FoxPro и FoxPro для Windows.

Функция DDEPoke( ) посылает символьную строку данных в элемент приложения, за анного номером канала.

Если данные переданы успешно, DDEPoke( ) возвращает значение "истина" (.T.). Если данные передать нельзя, DDEPoke( ) возвращает "ложь" (.F.). Если аргумент cUDFName задает асинхронную функцию, определенную пользователем, DDEPoke( ) возвращает номер транзакции; если произошла ошибка, DDEPoke( ) возвращает 1.