7602-1 (Программирование в LE-технология Microsoft Windows), страница 2

DDEML отвечает на вызов этой функции посылкой соответствующей транзакции XTYP_CONNECT в функцию обратного вызова каждого доступного в данный момент времени сервера, зарегистрированное имя которого совпадает с именем, переданным при помощи функции DdeConnect при условии, что сервер не отключал фильтр service имени вызовом функции DdeServiceName.

Сервер может также установить фильтр на XTYP_CONNECT транзакцию заданием соответствующего флага CBF_FAIL_CONNECTIONS при вызове функции DdeInitialize.

В процессе обработки транзакции типа XTYP_CONNECT DDEML передает полученные от клиента service и topic имена серверу. Сервер должен проверить эти имена и возвратить TRUE, если он в состоянии работать с такими именами, и FALSE в противном случае. Если ни один из существующих серверов не отвечает на CONNECT-запрос клиента, функция DDeConnect возвращает ему NULL с информацией о том, что в данный момент времени НЕ возможно установить диалог.

Однако, если сервер возвратил TRUE, то диалог был успешно установлен и клиент получает идентификатор диалога - двойное слово, посредством которого и ведется обмен данными с сервером.

Затем сервер получает транзакцию вида XTYP_CONNECT_CONFIRM (в случае, если он НЕ описывал флаг фильтра CBF_FAIL_CONFIRMS при вызове соответствующей функции).

Если сервер возвращает TRUE в ответ на транзакцию XTYP_CONNECT, DDEML посылает транзакцию вида XTYP_CONNECT_CONFIRM в функцию обратного вызова данного сервера. Обработав эту транзакцию, сервер может получить идендификатор диалога.

Вместо конкретного имени сервера клиент может установить шаблон диалога путем установки идентификаторов service и topic имен в NULL при вызове функции DdeConnect.

Если хотя бы один из вышеперечисленных идентификаторов равен NULL, DDEML посылает транзакцию типа XTYP_WILDCONNECT в функцию обратного вызова всех активных в данный момент DDE-приложений (исключения составляют лишь те, кто при вызове соответствующей функции указал флаг фильтрации XTYP_WILDCONNECT).

Любое сервер-приложение должно ответить на данную транзакцию и возвратить указатель на массив структур типа HSZPAIR, оканчивающийся нулем.

Если сервер-приложение НЕ вызывает функцию DDeNameService для регистрации собственного service имени в системе и фильтр обработки транзакций включен, то сервер НЕ получит транзакцию вида XTYP_WILDCONNECT.

Вышеописанный массив должен содержать одну структуру для каждого service и topic имен. DDEML выбирает одну пару из массива для установления диалога и возвращает его идентификатор клиенту. Затем DDEML посылает серверу транзакцию вида XTYP_CONNECT_CONFIRM (исключения составляют лишь те серверы, которые при инициализации установили фильтр обработки транзакций).

Любой сервер или клиент может оборвать диалог в любое время путем вызова функции DdeDisconnect. Это означает, что партнер по обмену данными получает транзакцию типа XTYP_DISCONNECT в функции обратного вызова (если, конечно, партнер не установил фильтр обработки транзакций вида CBF_SKIP_DISCONNECTIONS).

Обычно приложение реагирует на транзакцию XTYP_DISCONNECT вызовом функции DdeQueryInfo для получения информации о прекращенном диалоге. После того, как функция обратного вызова обработала транзакцию типа XTYP_DISCONNECT, идентификатор диалога больше не существует.

Клиентское приложение, которое получает транзакцию типа XTYP_DISCONNECT в своей функции обратного вызова может попытаться возобновить диалог при помощи вызова функции DdeReconnect. Клиентское приложение может вызывать эту функцию только находясь внутри своей собственной функции обратного вызова.

Сложный диалог

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

Клиент обязательно должен описывать service и topic имена, когда он вызывает эту функцию; это означает, что DDEML должна послать транзакцию вида XTYP_CONNECT все функции обратного вызова всех имеющихся в данный момент сервер-приложений, чьи зарегистрированные имена совпадают с именами, указанными клиентом (исключение составляют лишь те серверы, которые фильтруют получаемые транзакции).

В добавление к вышесказанному, можно отметить, что клиент, при вызове функции DdeConnectList, может указать NULL в качестве service или topic имени, либо же сразу для обоих. Все доступные в системе серверы, чьи зарегистрированные имена совпадают с именами, указанными клиентом, отвечают на его запрос. Диалог устанавливается со всеми такими серверами, даже если в системе запущено одно и тоже сервер-приложение несколько раз.

Клиент может использовать функции DdeQueryNextServer и DdeQueryConvInfo для того, чтобы понять, какой сервер находится в списке, полученный при вызове функции DdeConnectList. DdeQueryNextServer возвращает идентификатор диалога для следующего сервера, находящегося в списке; DdeQueryConvInfo заполняет структуру CONVINFO информацией о диалоге.

Клиент может сохранить полученные идентификаторы диалогов и отказаться от просмотра оставшихся серверов в списке.

Приложение может оборвать индивидуальный диалог, находящийся в списке диалогов путем вызова функции DdeDisconnect; приложение может оборвать все диалоги, находящиеся в списке путем вызова функции DdeDisconnectList.

Обе вышеуказанные функции указывают DDEML о необходимости посылки транзакции вида XTYP_DISCONNECT во все функции партнеров по диалогу данного приложения (в случае использования функции DdeDisconnectList будет посылаться транзакция XTYP_DISCONNECT для каждого элемента в списке диалогов).

Обмен данными между приложениями

Так как DDE использует области памяти для передачи данных из одного приложения в другое, DDEML обеспечивает конечного программиста функциями, при помощи которых DDE-приложения могут создавать и обрабатывать DDE-объекты.

Весь спектр транзакций, который вызывает обмен данными, требует от приложения, экспортирующего их, создания некоторого буфера, содержащего эти данные, а затем вызова функции DdeCreateDataHandle.

Эта функция создает DDE-объект, копирует данные из буфера в этот объект и возвращает идентификатор данных для данного приложения.

Идентификатор данных-это двойное слово, которое использует DDEML для обеспечения доступа к данным в DDE-объекте.

Для того, чтобы разделять данные в DDE-объекте, приложение передает идентификатор данных DDEML, а затем DDEML передает его в функцию обратного вызова приложения, получающего данные.

Клиентское приложение получает указатель на DDE-объект путем передачи идентификатора данных функции DdeAccessData. Указатель, возвращаемый этой функцией, обеспечивает доступ к данным в формате 'ТОЛЬКО НА ЧТЕНИЕ'. Клиент должен просмотреть полученные данные при помощи этого указателя и вызвать функцию DdeUnaccessData для его уничтожения. Клиент может скопировать полученные данные в заранее приготовленный буфер посредством вызова функции DdeGetData.

Обычно, когда приложение, создающее идентификатор данных, передает его DDEML, этот идентификатор портится внутри вышеуказанного приложения. В этом нет ничего страшного, если сервер должен разделять данные только с одним клиентом. Если же сервер должен разделять данные сразу с несколькими клиентами одновременно, ему придется указывать флаг HDATA_APPOWNED при вызове функции DdeCreateDataHandle.

Это делает возможным получение прав собственности на DDE-объект сервер-приложения и предотвращает порчу идентификатора данных DDEML. Приложение может передавать DDEML идентификатор данных любое количество раз, однако вызывать функцию DdeCreateDataHandle можно лишь однажды.

Если приложение указывает флаг HDATA_APPOWNED в параметре atCmd при вызове функции DdeCreateDataHandle, оно обязательно должно вызывать функцию DdeFreeDataHandle для очистки памяти вне зависимости от того, передавался ли идентификатор данных DDEML или нет. Перед тем как оборвать диалог, приложение должно вызывать функцию DdeFreeDataHandle для очистки всех созданных идентификаторов, но которые так и не были переданы DDEML.

Если приложение еще не передало идентификатор DDE-объекта DDEML, то оно может добавить данные к уже существующему объекту или полностью заменить их в нем. Все эти сервисные функции обслуживаются функцией DdeAddData.

Обычно приложение использует эту функцию для новой инициализации старых не уничтоженных DDE-объектов. После того, как приложение передает идентификатор данных DDEML, DDE-объект, идентифицирующий этот идентификатор НЕ может быть изменен, однако он может быть уничтожен.

OLE-технология

Как видно из описанного выше протокола DDE, приложения должны обязательно знать типы передаваемых данных, уметь их обрабатывать, а в основном даже могут работать только с символьными строками. Это, конечно, не очень удобно, когда необходимо, например, создать небольшой текст с различными картинками, пиктограммами и другими наглядными или не очень иллюстрациями. В этом случае на помощь программисту приходит OLE - встраивание объектов.

Вместе с данными мы получаем машинный код, который эти данные может обрабатывать.

Способы упорядочивания, источники и целевые документы

При использовании OLE-технологии пользователь всегда имеет дело с одним ведущим приложением (главным) и одним ведомым (подчиненным), а точнее, с одним ведомым.

Приложение, с помощью которого получен объект для встраивания всегда играет роль подчиненного. Это особенно характерно для случаев передачи объектов при встраивании и связывании через буфер промежуточного обмена.

Часто используемые термины Приложение-источник и Целевое приложение касаются не подчинения приложений, а определяют генеалогию объектов.

Некоторые Windows-приложения могут выступать только в роли подчиненных, а некоторые только в роли ведущих. Например, Paintbrush в OLE технологии может играть только роль подчиненного приложения, служащего для создания и модификации отдельных объектов. Другие приложения, например, Write или Cardfile можно считать оправданным с точки зрения, что гораздо чаще приходится вставлять иллюстрации в сложные по структуре текст, чем текст в иллюстрации. Новые приложения, такие как Word, могут выполнять в рамках OLE обе эти функции.

Употребление термина объект считается престижным в кругах программистов, хотя часто он употребляется и не к месту. Всякий разработчик почитает своим долгом применить в своем продукте ООП без особой на то необходимости. В среде Windows в термин объект вкладывается несколько специфический смысл. Пользователя не приглашают постигать азы ООП, или заняться конструированием объектов на С++.

Когда об объектах говорят в рамках Windows, то имеют в виду возможность встраивания в некоторый документ фрагмента, порожденного другим приложением. Вот это "инородное тело" и называется объектом.

В таком подходе нет ничего нового. Когда в текст, подготавливаемый Write, вставляется рисунок из Paintbrush посредством Clipboard или таблиц Exсel, в документ, подготавливаемый в Word, то результатом действия будет как раз появления объекта.

Традиционные объекты всегда представляют собой копии. Работа с ними основывается на том, что все Windows приложения поддерживают не только свой собственный формат, но и некоторый обобщенный, стандартный, играющий роль общеизвестного международного языка. Если, например, в текстовый документ вставляется таблица из табличного процессора, то буфер промежуточного обмена преобразует ее в формат к стандартному, и тем самым обеспечивает вставку. Такая копия в текстовом редакторе по виду не отличается от оригиналу, но она недоступна для внесения изменений. Невозможно, вставив таким способом копию из Paintbrush в Write документ, изменить цвет, толщину линий или масштаб.

Новые объекты, доступные в рамках Windows 3.1 очень похожи на традиционные, но они не являются копиями - это оригиналы. Они имеются в единственном экземпляре и находятся непостредственно в целевых документах. Там они существуют одновременно в двух форматах - в стандартном и в формате приложения-источника.

Благодаря стандартному формату объект может индицироваться и сохранять в рамках целевого документа. Имеется возможность обработки объекта также, как и любого файла оригинала. Ситуация выглядит так, словно внутри объекта встроен другой. Это обеспечивает доступ к средствам обработки нового объекта (приложению-источнику) посредством простого двойного щелчка на объекте.