DIALOG OBJECT


Конструкторы

Create Создать пустой невидимый диалог

Свойства

Active Флаг активности
AutoPos Флаг автопозиционирования по центру родительского окна
AutoScale Флаг автомасштабирования по параметрам родительского диалога
BackgroundPicture Фоновая картинка (IPicture)
BackgroundPicturePosition Способ расположения фоновой картинки (из набора констант BackgroundPicturePosition)
CaptionText Текст заголовка окна
ClientRect Прямоугольник клиентской области окна (IRECT)
Controls Коллекция элементов управления (CONTROLS)
ExternalUserInputReceived В очереди ввода присутствует событие, не относящееся к (немодальному) диалогу
FrameAutoHide Флаг автоскрытия заголовка и рамки
HideButtonId Идентификатор кнопки, которой был скрыт диалог
Id Строка, используемая для идентификации диалога при сохранении в SES-файле и загрузки из SES-файла сведений о его позиции
InactiveTimeout Интервал в секундах между фоновыми вызовами процедуры обслуживания
OnClose Обработчик попытки закрытия диалога пользователем
OnSize Обработчик изменения размера окна
OnProcessUserInput Процедура обслуживания немодального диалога
Parent Родительский диалог
ProcessUserInput Флаг разрешения обработки действий пользователя
Prompt Элемент STATIC_TEXT, где отображается вершина стека промптов (APP.PromptLines(0))
Rect Прямоугольник окна (IRECT)
ReplaceMainWindow Флаг замены (скрытия) главного окна приложения
ScaleX Коэффициент масштабирования по оси абсцисс
ScaleY Коэффициент масштабирования по оси ординат
ShowAtTheTop Флаг "показывать немодальный диалог сверху"
ShowMouseCursor Флаг видимости курсора мыши
StandardClientHeight Стандартная высота клиентской области окна в пикселах
StandardClientWidth Стандартная ширина клиентской области окна в пикселах
ToolTipDelayBeforeDisappears Время демонстрации всплывающих подсказкок элементов управления в секундах
ToolTipMaxWidth Максимальная ширина всплывающей подсказки в пикселах
Visible Флаг видимости окна
WindowSizeStatus Статус размера окна (из набора констант WindowSizeStatus)
WindowStyle

Стиль окна (из набора констант WindowStyle)

Методы

Redraw Перерисовать диалог
TextExtent Метод вычисляет ширину и высоту строки текста в пикселях, если ее отобразить на экране
Wait Выполнять обработку событий диалога и его элементов в течение заданного времени

Наборы констант

BackgroundPicturePosition Способ расположения фоновой картинки
ButtonId Идентификаторы кнопок диалога, имеющих специальное назначение
WindowSizeStatus Статус размера окна
WindowStyle Стиль окна

Описание

Класс представляет диалог в графическом пользовательском интерфейсе. Диалог - это окно, которое может содержать элементы управления (CONTROL).

Диалог, также как и элементы управления, имеет свойства, описывающие его графическое представление и некоторые общие параметры графического представления содержащихся в нем элементов управления. Все такие свойства могут быть прочитаны и изменены программно. Если свойство изменено программно, изменение вступает в силу после вызова метода Redraw. Программное изменение свойства элемента управления вступает в силу также после вызова метода CONTROL.Redraw. Некоторые из них могут измениться вследствии действий пользователя. Свойствами, описывающими графическое представление диалога являются: Rect, WindowStyle, WindowSizeStatus, CaptionText, BackgroundPicture, BackgroundPicturePosition, ToolTipMaxWidth, ToolTipDelayBeforeDisappears, ShowAtTheTop, ShowMouseCursor. Наборы констант WindowStyle, WindowSizeStatus, BackgroundPicturePosition содержат возможные значения одноименных свойств.

Метод TextExtent позволяет узнать размер занимаемого текстом пространства на экране.

В наборе констант ButtonId заданы строковые идентификаторы, с помощью которых можно выбрать специальные кнопки (см. PUSH_BUTTON), если присвоить свойству CONTROL.Id значение одной из констант. Установка непустого значения свойства HideButtonId при нажатии на кнопку приводит к скрытию диалога: оно устанавливается ASB при нажатии специальных кнопок, а также может быть изменено программным обработчиком нажатия на кнопку (см. PUSH_BUTTON.OnClick).

Свойство ReplaceMainWindow позволяет сделать окно диалога главным окном приложения.

Свойства StandardClientWidth, StandardClientHeight, ScaleX, ScaleY позволяют применять автоматическое масштабирование элементов управления.

Возможность добавления элементов управления в диалог и доступ к элементам управления, уже содержащимся в диалоге, обеспечивает коллекция Controls.

Также как и элементы управления, диалог может оповещать управляющую программу о действиях пользователя, вызывая процедуры-обработчики событий. Ссылки на обработчики событий помещаются в определенных свойствах объекта. Для диалога такими свойствами являются OnClose и OnSize.

Свойство Visible позволяет управлять видимостью диалога. Невидимый диалог никак не проявляет себя для пользователя, никакие события диалога и его элементов управления не происходят.

Свойства AutoPos и AutoScale позволяют управлять автоматическим центрированием и автоматическим масштабированием окна диалога по его родительскому окну.

Свойство FrameAutoHide позволяет управлять автоскрытием рамки и заголовка.

Метод Wait и свойство ProcessUserInput позволяют управлять обработкой событий. Обработчики событий диалога и его элементов управления могут быть оповещены о событиях только в двух случаях:

В режиме терминального клиента ASB диалоговые окна, представленные классом DIALOG, безусловно создаются на стороне терминального клиента.

Класс добавлен в версии 14.132.090.