События и базовые процедуры

Top  Previous  Next

PLMNavigator32        Работа пользователя в среде многооконного интерфейса системы Visual Loodsman базируется на генерировании различных событий и выполнения предустановленных администратором VL-проекта соответствующих списков процедур. Большинство компонентов системы может генерировать различные события. В системе зарегистрирован следующий список базовых событий:

OnChange - событие возникает при изменении атрибутов в поле (в полях) компонента;
OnClick - событие возникает при щелчке левой кнопкой мыши на компоненте;
OnEnter - событие возникает при передаче фокуса компоненту (при входе в него);
OnExit - событие возникает при потере фокуса компонентом (при выходе из него);
OnDblClick - событие возникает при двойном щелчке левой кнопкой мыши на компоненте;
OnGetInfo - получение информации из файла документа (импорт информации);
OnInsert - создание файла документа;
OnOpen - открытие файла документа;
OnShow - загрузка компонента на экран.

       Каждое событие может состоять из набора базовых процедур, установленных в состав события администратором VL-проекта. В системе Visual Loodsman разработан целый ряд базовых процедур представленных ниже в таблице. У большинства процедур имеются источники исходной информации и потребители результатов выполнения процедур. В качестве источников и потребителей информации в системе выступают различные компоненты.

       В первую очередь необходимо обратить внимание на процедуру LoadVLMDIForm, которая позволяет загрузить на экран новую MDI форму. Обычно перед указанной процедурой вызывается процедура GetId, позволяющая скопировать уникальный числовой идентификатор необходимого объекта в системный буфер (например из компонента VLRegVariable).

       Особое место в ряду процедур занимает процедура UserAction - пользовательская процедура. Указанная процедура содержит EXE-файл, зарегистрированный в файловом архиве базы данных VL-проекта. EXE-модуль пишется пользователем системы - локальным программистом. При выполнении данной процедуры EXE-модуль копируется из базы данных в каталог, где расположена система (если его там нет). Если данный файл уже находится в каталоге расположения системы Visual Loodsman, то проверяется последняя дата изменения файла. В случае если файл устарел, он заменяется на новый. Таким образом администратор VL-проекта имеет возможность обновлять интерфейсную разработку в online режиме.

       Кроме вышеуказанной процедуры следует обратить внимание на процедуры ExportXML и ImportXML. Данные процедуры позволяют экспортировать информацию из базы данных ЛОЦМАН:PLM в файл формата XML и, наоборот, импортировать информацию из сформированного во внешнем модуле файла формата XML в базу данных ЛОЦМАН:PLM. Указанные процедуры особенно полезны в сочетании с процедурой UserAction, например для передачи информации в файл документа. Таким образом в системе Visual Loodsman настраивается интеграция между базой данных ЛОЦМАН:PLM и внешними документами или отчетами.

       Изначально система Visual Loodsman была задумана для локализации чисто программистских задач и предоставления системным аналитикам инструмента визуального моделирования информационного пространства. В такой конфигурации система Visual Loodsman имеет неограниченные возможности развития.

       Для регистрации и редактирования событий и процедур в компонентах используется Универсальный конфигуратор событий и процедур. Ниже представлена таблица с кратким описанием базовых процедур системы Visual Loodsman.

 

Процедура

Описание

Источник

Потребитель

ActionGroup ActionsGroup

Групповая процедура, представляет собой простой набор (контейнер) других процедур.

 

 

AdminObj AdminObj

Процедура просмотра и установки уровней доступа к выбранному объекту.

VLTableView VLTableView

VLFindTableView VLFindTableView

 

Exit ApplicationExit

Процедура простого закрытия приложения.

 

 

AttrSumm AttrSumm

Процедура строкового сложения атрибутов объекта пользовательской базы данных ЛОЦМАН:PLM, уникальный идентификатор которого помещен в системный буфер (например процедурой GetId)

 

VLEdit VLEdit

VLComboBox VLComboBox

AuthorObj AuthorObj

Процедура просмотра информации об авторе-создателе объекта.

VLTableView VLTableView

VLFindTableView VLFindTableView

 

ChangeState ChangeState

Процедура изменения состояния объекта пользовательской базы данных ЛОЦМАН:PLM.

VLTableView VLTableView

VLFindTableView VLFindTableView

 

VLCheckBox CheckBox

Процедура проверки содержимого компонента VLCheckBox и выполнения группы процедур в зависимости от результата проверки.

VLCheckBox VLCheckBox

 

CloseWindow CloseWindow

Процедура закрытия MDI или Modal окна приложения (компоненты VLMDIForm или VLModalForm).

 

VLMDIForm VLMDIForm

VLModalForm VLModalForm

CopyObjToClipBrd CopyObjToClipBrd

Процедура копирования указателя выбранного объекта базы данных ЛОЦМАН:PLM в буфер обмена Windows.

VLTableView VLTableView

VLFindTableView VLFindTableView

VLTreeView VLTreeView

 

TypeCase DataCase

Процедура проверки данных в компоненте и запуска подчиненной процедуры ActionsGroup в зависимости от содержимого компонента.

VLEdit VLEdit

VLComboBox VLComboBox

 

DeleteLink DeleteLink

Процедура удаления выделенного в составе компонента-потребителя и подчиненного по указанной связи объекта пользовательской базы данных системы ЛОЦМАН:PLM. При этом удаляется только связь, сам объект остается в базе данных.

 

VLTableView VLTableView

DeleteObject DeleteObject

Процедура удаления выделенного в компоненте - потребителе объекта пользовательской базы данных системы ЛОЦМАН:PLM.

 

VLTableView VLTableView

DisableControls DisableControls

Процедура блокирования указанных компонентов.

 

VLEdit VLEdit

VLComboBox VLComboBox

VLCheckBox VLCheckBox

VLRadioGroup VLRadioGroup

VLBitBtn VLBitBtn

VLSpeedBtn VLSpeedBtn

EnableControls EnableControls

Процедура включения доступа к указанным компонентам.

 

VLEdit VLEdit

VLComboBox VLComboBox

VLCheckBox VLCheckBox

VLRadioGroup VLRadioGroup

VLBitBtn VLBitBtn

VLSpeedBtn VLSpeedBtn

ExportXML ExportXML

Процедура экспорта информации в файл формата XML.

 

 

GetData GetData

Процедура копирования строковой переменной из компонента в системный буфер

VLRegVariable VLRegVariable

VLEdit VLEdit

 

GetId GetId

Процедура копирования уникального числового идентификатора объекта базы данных системы ЛОЦМАН:PLM из компонента в системный буфер.

VLRegVariable VLRegVariable

VLEdit VLEdit

VLMDIForm VLMDIForm

VLModalForm VLModalForm

VLTableView VLTableView

VLFindTableView VLFindTableView

VLTreeView VLTreeView

VLDocFilePanel VLDocFilePanel

 

GoDown GoDown

Процедура перемещения выбранного объекта в таблице компонента VLTableView вниз на одну позицию относительно указанного атрибута.

 

VLTableView VLTableView

GoUp GoUp

Процедура перемещения выбранного объекта в таблице компонента VLTableView вверх на одну позицию относительно указанного атрибута.

 

VLTableView VLTableView

HelpContext HelpContext

Процедура загрузки окна справки по номеру из файла с расширением *.CHM.

 

 

IfmrOk IfModalResultOk

Простой набор (контейнер) других процедур, выполняемых, если системной переменной ModalResult присвоено значение Ok (специальной процедурой ModalResultOk)

 

 

ImportXML ImportXML

Процедура импорта информации из файла формата XML в базу данных ЛОЦМАН:PLM.

 

 

InsertObject InsertObject

Процедура создания нового объекта базы данных ЛОЦМАН:PLM в таблице компонента VLTableView.

 

VLTableView VLTableView

LoadPictureDialog LoadPictureDialog

Процедура загрузки стандартного диалога системы Windows для поиска графического файла и, в случае успешного завершения операции поиска, установки его изображения в компонент - потребитель информации типа VLImage

 

VLImage VLImage

LoadMDIForm LoadVLMDIForm

Процедура загрузки новой MDI формы на экран (см. компонент VLMDIForm)

 

VLMDIForm VLMDIForm

LoadModalForm LoadVLModalForm

Процедуру загрузки новой модальной формы на экран (см. компонент VLModalForm).

 

LoadModalForm VLModalForm

LocateTable LocateTable

Процедура поиска строки в таблице объектов пользовательской базы данных компонента VLTableView по значению атрибута.

 

VLTableView VLTableView

MathProduct MathProduct

Процедура математического произведения данных, взятых из различных компонентов формы, и помещения результата вычисления в указанный компонент

VLEdit VLEdit

VLComboBox VLComboBox

VLEdit VLEdit

MathSumm MathSumm

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

VLEdit VLEdit

VLComboBox VLComboBox

VLEdit VLEdit

mrOk ModalResultOk

Процедура предназначена для помещения в системный буфер значения OK.

 

 

NewVersion NewVersion

Процедура создания новой версии объекта пользовательской базы данных системы ЛОЦМАН:PLM выбранного в составе компонента - источника информации для данной процедуры.

VLTableView VLTableView

VLFindTableView VLFindTableView

 

PasteObjFromClipBrd PasteObjFromClipBrd

Процедура установки объекта пользовательской базы данных из буфера обмена Windows в таблицу компонента VLTableView по установленной в нем связи с возможностью установки заранее заданных атрибутов связи.

 

VLTableView VLTableView

VLRadioGroup RadioGroup

Процедура проверки компонента VLRadioGroup и выполнения процедуры ActionsGroup (группа процедур) в зависимости от того, какой переключатель активен в компоненте (номер кнопки, начиная с 0).

VLRadioGroup VLRadioGroup

 

RefreshControl RefreshControl

Процедура обновления (перестраивания) компонента - потребителя.

 

VLTableView VLTableView

VLFindTableView VLFindTableView

VLTreeView VLTreeView

VLDocFilePanel VLDocFilePanel

VLPanel VLPanel

VLWorkTableView VLWorkTableView

ResetPosition ResetPosition

Процедура перерасчета позиций в таблице компонента VLTableView.

 

VLTableView VLTableView

SaveAttributes SaveAttributes

Процедура сохранения атрибутов, измененных в визуальных компонентах формы (VLMDIForm или VLModalForm).

 

VLMDIForm VLMDIForm

LoadModalForm VLModalForm

SetAttr SetAttr

Процедура установки шаблона поиска по атрибутам в компонент VLFindTableView для организации поиска объектов пользовательской базы данных.

 

VLFindTableView VLFindTableView

SetData SetData

Процедура установки в компонент - потребитель информации строки текста заранее предустановленную в процедуре, либо взятую из системного буфера Visual Loodsman.

 

VLEdit VLEdit

SetFilter SetFilter

Процедура установки строки фильтра в компонент VLTableView.

 

VLTableView VLTableView

SetId SetId

Процедура установки уникального числового идентификатора объекта базы данных системы ЛОЦМАН:PLM из системного буфера Visual Loodsman в выбранные компоненты - потребители информации данной процедуры.

 

VLRegVariable VLRegVariable

VLEdit VLEdit

VLTableView VLTableView

VLTreeView VLTreeView

VLDocFilePanel VLDocFilePanel

VLPanel VLPanel

SetProduct SetProduct

Процедура установки шаблона поиска по ключу в компонент VLFindTableView для организации поиска объектов пользовательской базы данных.

 

VLFindTableView VLFindTableView

SetState SetState

Процедура установки списка состояний в компонент VLFindTableView для организации поиска объектов пользовательской базы данных.

 

VLFindTableView VLFindTableView

SetType SetType

Процедура установки списка типов в компонент VLFindTableView для организации поиска объектов пользовательской базы данных.

 

VLFindTableView VLFindTableView

StrSumm StrSumm

Процедура строкового суммирования содержимого указанных компонентов формы.

VLEdit VLEdit

VLComboBox VLComboBox

VLDateTimePicker VLDateTimePicker

VLEdit VLEdit

TypeCase TypeCase

Процедура проверки типа объекта пользовательской базы данных, выбранного в компоненте - источнике информации для данной процедуры, и запуска подчиненной процедуры ActionsGroup в зависимости от типа.

VLTableView VLTableView

VLTreeView VLTreeView

VLDocFilePanel VLDocFilePanel

 

UnVisibleControls UnVisibleControls

Процедура выключения видимости указанных компонентов.

 

VLEdit VLEdit

VLComboBox VLComboBox

VLCheckBox VLCheckBox

VLRadioGroup VLRadioGroup

VLBitBtn VLBitBtn

VLSpeedBtn VLSpeedBtn

UserAction UserAction

Процедура загрузки внешнего пользовательского приложения, зарегистрированного в базе данных в качестве документа типа UserApplication с прикрепленным файлом формата EXE и сохраненном в файловом архиве VL-проекта.

 

 

VersionList VersionList

Процедура просмотра списка версий объекта пользовательской базы данных системы ЛОЦМАН:PLM выбранного в составе компонента - источника информации для данной процедуры.

VLTableView VLTableView

VLFindTableView VLFindTableView

 

VisibleControls VisibleControls

Процедура включения видимости указанных компонентов.

 

VLEdit VLEdit

VLComboBox VLComboBox

VLCheckBox VLCheckBox

VLRadioGroup VLRadioGroup

VLBitBtn VLBitBtn

VLSpeedBtn VLSpeedBtn