Справочная система SDK КОМПАС-3D

API интерфейсов. Версия 5 > Интерфейсы событий API5

События в КОМПАС Общие сведения

Генерация событий в КОМПАС осуществляется при помощи компактных интерфейсов событий, в которых события группируются по тематике. Подписка на события проводится во время подключения библиотеки при помощи предопределенной функции LibInterfaceNotifyEntry().

Для Automation реализация основана на стандартном механизме ConnectionPoint. Основные объекты, такие как KompasObject, ksDocument2D и т.п., которые являются источниками событий, наследуют интерфейс IConnectionPointContainer, позволяют подписаться на один основной интерфейс и предоставляют дополнительные объекты-источники событий. Подписаться на события или отменить подписку можно стандартным способом при помощи методов интерфейса IConnectionPoint: IConnectionPoint::Advise и IConnectionPoint::Unadvise.

Для COM реализация основана на интерфейсах IUnknown, которые предоставляет библиотека. Подписаться на события или отменить подписку можно при помощи экспортных функций: ksConnectionAdvise и ksConnectionUnadvise.

Библиотека сама должна позаботиться о своевременной отписке от неактуальных событий. Например, в момент закрытия документа нужно обработать соответствующее событие и отписаться от всех событий, связанных с данным документом (см. таблицу связей). При закрытии приложения следует отписаться от всех событий.

Интерфейс событий приложения...

Интерфейс событий документа, работа с файлом...

Интерфейс событий документа-модели...

Интерфейс событий графического документа...

Интерфейс событий менеджера выделенных объектов...

Интерфейс событий объектов графического документа...

Интерфейс событий объектов документа-модели...

Интерфейс событий основной надписи графического документа...

Интерфейс событий объекта спецификации...

Интерфейс событий спецификации...

Интерфейс событий документа-спецификации...

Связь объектов системы с интерфейсами событий...