Отправляет данные между клиентом и приложениями-серверами в сеансе динамического обмена данными (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( ) .
Возвращаемое значение
Логическое
Замечания
DDEPoke( ) отправляет данные в виде символьная строка на имя пункта в приложении, указанным номером канала.
Если данные успешно посылают, DDEPoke( ) возвращмет истину (.T).. Если данные послать невозможно, DDEPoke( ) возвращмет ложь (.F).. Если включена асинхронная определяемая пользователем функция cUDFName , DDEPoke( ) возвращает номер транзакции; если происходит ошибка, DDEPoke( ) возвращмет -1.
См. Также
Другие Ресурсы
DDEAbortTrans( ) ФункцияDDEInitiate( ) Функция
DDELastError( ) Функция
DDESetOption( ) Функция
DDETerminate( ) Функция
Функции
Справочник Языка