«О!Пиум» представляет собой многодокументное приложение. Это
означает, что внутри одного сеанса программы могут быть открыты несколько окон,
в каждом из которых будут загружены разные документы. Под документами программа
понимает планшет, созданный на базе одного из доступных шаблонов с загруженными
в него данными по одной из доступных скважин. Одновременно может быть активным
только один документ. А именно тот, который открыт в окне, являющемся активным
в данный момент. Напомним, что активным является окно имеющее «фокус ввода»,
т.е. с подсвеченной «планкой заголовка». Таким образом получение связи с
«сервером» предполагает получение указателя на экземпляр «О!Пиума», а затем
получение указателя на активный документ. Это и будет та скважина, с которой в
последствии будет работать «клиент». После получения указателя на активный
документ уже не имеет значения — будет ли этот документ активен к моменту вызова
функций «клиентом». Установленная связь является однозначной и нерушимой до
момента отключения «клиента» от «сервера». С момента получения связи с
«сервером» (здесь и дальше под связью с сервером понимается получение указателя
на активный документ) для «клиента» становятся доступными функции и сообщения о
событиях, связанные с тем документом, на который ссылается указатель полученный
«клиентом».
Для нормального функционирования технологии «автоматизации»
операционной системе необходимо знать, какие именно «серверы автоматизации»
доступны в ней, какие функции и уведомления о событиях поддерживает каждый
«сервер», и в каком выполняемом файле находится код, реализующий каждую
функцию. В процессе инсталляции «О!Пиума» процедура инсталляции вносит в
системный реестр необходимые записи о «сервере» и о файле в котором находятся
описания предоставляемых «сервером» функций (двоичный файл библиотеки типов Opium.tlb). При успешной регистрации
библиотека типов становится доступной в системе и может использоваться «клиентами
автоматизации». Убедится в том, что библиотека типов действительно корректно
зарегистрирована в системе можно следующим образом:
·
Запустите Excel;
·
Запустите встроенный редактор Visual Basic (Alt+F11);
·
Выберите из меню команду Tools/References…
В появившемся
окне появится список всех доступных «серверов автоматизации». В первых
строках списка помечены «сервера» уже подключенные к Visual Basic, а далее в алфавитном
порядке перечислены все остальные. Если среди остальных есть строка «Opium 1.0 Type Library» — значит все в порядке,
регистрация прошла успешно, и вы можете использовать уже созданные «клиенты»
или приступать к разработке своих.
Отметим, что при каждом запуске головного модуля «О!Пиум» в программе выполняется код выполняющий повторную регистрацию приложения и библиотеки типов на тот случай если информация в реестре была повреждена. Это означает, что если в списке доступных «серверов» не появилась строка «Opium 1.0 Type Library», то вам нужно просто запустить «О!Пиум» и выйти из него. Это действие инициирует процедуру повторной регистрации. дальше>>