Как работать с ActiveXeme

Компонент ActivesXeme может применяться разработчиками программного обеспечения для энергетики везде, где есть потребность в отображении и работе со схемной информацией внутри пользовательского приложения. Компонент предназначен для встраивания графического модуля в ПО, созданное с помощью современных средств разработки ( Borland Delphi, Borland C++ Builder, Microsoft Visual Studio и др.) широко используемых в России.

Предлагаемая система отображения графической информации основана на объектно-ориентированном графическом движке компании Модус, оптимизированном для использования в приложения для электроэнергетики. Документы в этой графической системе представляются в форматах SDE и XSDE - специализированных форматах, разработанных компанией Модус.

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

Так как ActivesXeme реализует технологию ActiveX фирмы Microsoft, он может быть легко интегрирован в Web-страницы для просмотра схем через Internet/Intranet с использованием браузера Internet Explorer.

Компонент имеет самостоятельный пользовательский интерфейс для выполнения таких операций со схемами, как:

• управление видом отображения схемы (масштабирование, скроллинг, детализация),
• навигация по схемам (переход по гиперссылкам).

Возможно хранение схем не только в виде файлов, но и в виде произвольного структурированного хранилища (Storage), или в базе данных.

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

От графического модуля к прикладной программе передается следующая информация:

• Наименование текущего выбранного объекта (над которым была нажата кнопка мыши);
• Свойства текущего объекта, доступные для чтения и модификации;
• Уведомление о наступлении событий (нажатие кнопок мыши, переходы по ссылкам);

Информация и управление, передаваемые от прикладной программы к графическому модулю:

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

Описание и использование компонента

HTSDEForm

Установка

Использование компонента в прикладных программах

Объектные модели

1. Как было уже упомянуто выше, обмен данными между графическим модулем и приложением осуществляется посредством интерфейсов, объединены в группы (объектные модели). Объектная модель1 представляет собой следующий набор интерфейсов:
   IenumObjects, ISDEObjects, ISDEObject
   Интерфейсы, входящие в Объектную модель2:
   ISDEDocument, ISDEPages, ISDEPage, ISDEObjects2, ISDEObject2
   
   Первичная версия графического модуля включала в себя только интерфейсы Объектной модели1. По мере развития продуктов входящих в комплекс Модус, развивался и графический модуль ActivesXeme. Поэтому, учитывая спецификацию COM, рекомендации Microsoft по организации коллекций, интерфейсов application, document и др. была введена Объектная модель2. Разумеется, вторая модель более совершенная и удобная для решения задач, поэтому считаем ее использование более предпочтительное. В будущем планируется прекратить поддержку Объектной модели 1.
   
   Для работы со схемой в зависимости от задач можно придерживаться следующей схемы:
   
   Первоначально, Вы имеете доступ к форме графического модуля (HTSDEForm) через интерфейс IHTSDEForm. С помощью него Вы можете управлять не только состоянием формы, но и работать со свойствами текущего объекта. Для расширения сферы деятельности Вам необходимо получить доступ к объекту SDEDocument, используя метод GetDocument (свойство Document).
2. Получив доступ к объекту SDEDocument, Вы получаете возможность работать с текущей страницей, получить коллекцию всех страниц схемы и коллекцию всех объектов схемы. Для последовательной работы со схемой необходимо получить доступ к объекту SDEPages, используя метод GetPages (свойство Pages).
3. Объект SDEPages позволяет получить доступ к конкретной странице схемы используя метод GetItem (свойство Item). Страницы предстанут в виде объектов SDEPage .
4. Объект SDEPage позволяет работать со свойствами страницы и получить коллекцию всех объектов, располагающихся на данной странице. Метод GetSDEObjects (свойство SDEObjects) возвращает объект SDEObjects2.
5. Объект SDEObjects2 - коллекция (список) объектов - обеспечивает доступ к определенному объекту из данной коллекции. Метод GetItem (свойство Item) - возвращает объект SDEObject2.

Объект SDEObject2 позволяет работать со всем свойствами и характеристиками объекта схемы, к которому получен доступ.

Кроме методов, перечисленных выше, достаточно быстрый поиск элемента по SNIdent можно осуществить следующим образом:
MyObject := HTSDEForm.Document.Flat.Item [MySNIdent]
где SNIdent - уникальный идентификатор объекта.

Если необходимо выполнить поиск не по SNIdent, а по другому полю (например ключ_привязки + назначение_привязки), то необходимо выполнить следующие операции:
HTSDEForm.Document.FlatIndex := 'ключ_привязки+назначение_привязки'
(в этот момент строится нужный индекс в памяти, после этого можно искать)
MyObject := HTRootForm1.Document.Flat.Item ['IDПСТ210+ЛПЧ']

Примеры для ActiveXeme2

19.12.08

размер 12.5Мб
Версия ActiveX 5.10.7.212
Возможно при установке дистрибутив потребует следующие файлы isscript.msi, instmsia.exe, instmsiw.exe. В этом случае скачайте их и положите рядом с дистрибутивом

07.07.04

Скачать документацию для ActivesXeme