Функция DDEAdvise( )

Создает связь с уведомлением или автоматическую связь, используемые средством инамического обмена данными (DDE).

Синтаксис

DDEAdvise(nChannelNumber, cItemName, cUDFName, nLinkType)

Параметры

nChannelNumber

Задает номер канала.

cItemName

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

cUDFName

Задает пользовательскую функцию, которая выполняется в том случае, когда уста авливается связь с уведомлением или автоматическая связь и изменяется элемент cItemName. Когда пользовательская функция выполняется, ей передаются следующие шесть па аметров в указанном порядке:

Параметр	Содержимое
Channel Number (номер канала)	Номер канала приложения-сервера
Action (действие)	ADVISE или TERMINATE
Item (элемент)	Имя элемента; например, R1C1 в случае ячейки электронной таблицы Microsoft Excel
Data (данные)	Новые данные (автоматическая связь) или пустая строка (связь с уведомлением)
Format (формат)	Формат данных, например CF_TEXT
Advise Status (статус уведомления)	Тип связи (0 = ручная, 1 = с уведомлением, 2 = автоматическая)

В операторе LPARAMETER или PARAMETER пользовательской функции должны быть пре усмотрены шесть параметров, чтобы функция могла принять значения, переданные из приложения-сервера. Если устанавливается связь с уведомлением, выполняется фу кция, определенная пользователем, и в параметре Data передается пустая строка. Позже можно выдать функцию DDERequest( ) для получения данных. Если устанав ивается автоматическая связь, выполняется функция, определенная пользователем, и анные передаются в параметре Data.

Параметр Action содержит значение ADVISE, если связь обновляется сервером. Выз вается функция, определенная пользователем, и когда связь закрывается клиентом или сервером, параметр Action содержит TERMINATE.

Любые значения, возвращаемые пользовательской функцией, игнорируются.

nLinkType

Задает тип связи следующим образом:

nLinkType	Тип связи
0	Ручная
1	С уведомлением
2	Автоматическая

Можно отменить выдачу уведомлений из приложения-сервера, задав 0 в качестве nLinkType. При изменении элемента функция, определенная пользователем, выполняться не удет.

Результат

Логический

Комментарии

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

Функция DDEAdvise( ) используется для создания связи с уведомлением или автоматической связи с данным элементом в приложении-сервере. Когда DDEAdvise( ) соз ает связь с уведомлением, приложение-сервер будет уведомлять Visual FoxPro об изменении элемента с данным именем. Если создается автоматическая связь, приложе ие-сервер уведомляет Visual FoxPro об изменении элемента и передает в Visual FoxPro новые данные.

Чтобы создать связь, предварительно необходимо с помощью функции DDEInitiate( ) установить канал с приложением-сервером.

Функцию DDEAdvise( ) можно также использовать для отмены выдачи уведомлений из сервера.

DDEAdvise( ) возвращает значение "истина" (.T.) в случае успешного выполнения; в противном случае возвращается "ложь" (.F.).