DialogEx.Show

number DialogEx.Show ( string DialogName,
boolean ParentCoordinates = true,
number X = nil,
number Y = nil )
Примеры

Описание

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

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

Примечание: Нельзя показать диалоговое окно, пока видно диалоговое окно состояния.

Совет: Можно использовать действие DialogEx.Close для закрытия текущего диалогового окна.

Параметры

DialogName

(строка) Имя показываемого диалогового окна.

ParentCoordinates

(логический) Устанавливать ли положение диалогового окна относительно родительского окна (окна приложения или другого диалогового окна) или экрана монитора. Если в качестве координат X и Y установлено значение nil, этот параметр игнорируется и диалоговое окно будет показано в центре экрана.

ЗНАЧЕНИЕ
VALUE		ОПИСАНИЕ
DESCRIPTION
trueПоложение диалогового окна указано относительно родительского окна (приложения или диалогового окна). (По умолчанию)
falseПоложение диалогового окна указано относительно экрана монитора.

X

(число) Дополнительная X координата в пикселах (горизонтальное положение) для установки диалогового окна. Эта X координата отсчитывается от верхнего левого угла диалогового окна относительно экрана или родительского окна, исходя из значения указанного в параметре ParentCoordinates. Установка параметра как nil центрирует диалоговое окно.

Y

(число) Дополнительная Y координата в пикселах (вертикальное положение) для установки диалогового окна. Эта Y координата отсчитывается от верхнего левого угла диалогового окна относительно экрана или родительского окна, исходя из значения указанного в параметре ParentCoordinates. Установка параметра как nil центрирует диалоговое окно.

Возврат

ResultVariable

(число) Результат диалогового окна, который переходит к действию DialogEx.Close, или IDCANCEL (2), если пользователь выбрал закрытие диалогового окна с помощью кнопки закрыть на окне (X на заголовке окна). Если происходит ошибка, возвращается -1. Можно использовать Application.GetLastError для определения случился ли отказ в работе этого действия и почему.

При добавлении действия из редактора скрипта, можно использовать это поле для определения переменной, которая возвращает значение, сохраняющееся в ней.
Смотрите также: Связанные действия

Примеры

Пример 1

nRet = DialogEx.Show("Dialog1");
Показываем диалоговое окно, названное "Dialog1" и сохраняем результат в переменной "nRet".

Пример 2

if (DialogEx.Show("Dialog2") == IDCANCEL) then
    Dialog.Message("Cancelled", "The dialog was closed.");
end
Показываем диалоговое окно по имени "Dialog2" и, если пользователь закрывает окно, показываем уведомительное сообщение.

Пример 3

nRet = DialogEx.Show("Dialog1", true, 100, 100);
Показываем диалоговое окно по имени "Dialog1" в положении (100,100) относительно окна приложения и сохраняем результат в переменной nRet.
Смотрите также: Связанные действия