Описание
Определение
| Visual Basic |
|---|
Public Event ObjectPropertiesDlgShow( _ ByVal pObject As TDMSObject, _ ByRef bCancel As Boolean, _ ByVal pForms As TDMSInputForms _ ) |
Параметры
- pObject
- Объект, окно свойств которого должно быть показано.
- bCancel
- TRUE отменяет вывод на экран окна свойств объекта.
- pForms
- Коллекция форм (за исключением формы "Все атрибуты"), которые будут показаны в Окне свойств.
Заметки
Использование обработки события может быть полезным, когда необходимо добавить/удалить формы в Окне свойств или отменить вывод окна на экран по какому-либо условию.
1. Событие является отменяемым: присвоением параметру bCancel значения TRUE можно отменить вывод на экран диалога свойств объекта.
2. Обработчик может быть размещен в скриптах объекта, профиля и/или общесистемном (см. рисунок). Если обработчики определены на всех уровнях, то последовательность их вызова такова:
- скрипт объекта;
- скрипт профиля пользователя;
- общесистемный скрипт.
Если на каком-либо уровне событие было отменено (параметру bCancel присвоено значение TRUE), то обработчики события, размещенные на последующих уровнях, вызваны не будут.
3. Схему последовательности генерации событий при редактировании атрибутов объекта в окне свойств см. на рисунке.
4. Событие генерируется перед выводом диалога свойств объекта на экран. Событие не наступает при показе свойств объекта на Панели свойств главного окна приложения. Для того, чтобы событие генерировалось при работе через API (например, при вызове метода EditObjectDlg.Show), должен быть включен вызов объектных событий в Окне свойств базы данных (см. рисунок).
