Application.SetDialogProperties

Application.SetDialogProperties (

string DialogName,
table Properties )

Описание

Устанавливает свойства диалогового окна.

Параметры

DialogName

(строка) Имя диалогового окна, чьи свойства нужно изменить.

Properties

(таблица) Индексированная по имени, таблица, содержащая свойства, которые нужно изменить.

КЛЮЧ KEY	ТИП TYPE	ОПИСАНИЕ DESCRIPTION
DialogTitle	строка	Заголовок диалогового окна.
Movable	логический	Истина (true), если диалоговое окно подвижно или ложь (false), если не передвигается. Примечание: Это значение можно устанавливать только если в настоящий момент диалоговое окно не видимо. Если диалоговое окно уже видно, этот параметр будет отражен при следующем показе диалогового окна.
AlwaysOnTop	логический	Истина (true), если диалоговое окно будет показываться всегда поверх остальных окон, или ложь (false), если это не так.
Width	число	Ширина поверхности диалогового окна в пикселах. Нельзя установить ширину меньше, чем определено значением MinWidth.
Height	число	Высота поверхности диалогового окна в пикселах. Нельзя установить высоту меньше, чем определено значением MinHeight.
DialogStyle	число	Стиль окна, установленный для диалогового окна: DIALOG_STYLE_STANDARD (0), DIALOG_STYLE_BORDERED (1), DIALOG_STYLE_FLAT (2), DIALOG_STYLE_CUSTOM_MASK (3).
Resizable	логический	Истина (true), если диалоговое окно может изменять размер или ложь (false), если это не так.
MinWidth	число	Минимальная ширина диалогового окна установленная, если значение Resizable установлено как истина (true). Если Width меньше этого значения, то будет установлено оно.
MinHeight	число	Минимальная высота установленная, если значение Resizable установлено как истина (true). Если Height меньше этого значения, то будет установлено оно.
UseCustomIcon	логический	Истина (true), если пользовательская иконка будет показана в верхнем левом углу диалогового окна или ложь (false), если это не так.
CustomIcon	строка	Путь к пользовательской иконке для отображения, если UseCustomIcon истинна, и DialogStyle установлена в DIALOG_STYLE_STANDARD.
UseCustomSettings	логический	Истина (true), если фон диалогового окна будет использовать специальные цвета или ложь (false), если для окон приложения будет использоваться цвет фона по умолчанию. Примечание: Если у приложения своя тема, цвет по умолчанию будет взят из файла темы.
BackgroundType	число	Тип фона: BG_SOLID (0), BG_GRADIENT (1), BG_IMAGE (2)
BackgroundColor	число	Числовое значение фонового цвета.
GradientColorTop	число	Числовое значение верхнего цвета градиента. Применяется только если BackgroundType = BG_GRADIENT.
ImageFilename	строка	Путь к графическому файлу, используемому как фоновое изображение, если BackgroundType = BG_IMAGE.
ImageStretchMode	число	Тип выполняемого заполнения фона изображением, если BackgroundType = BG_IMAGE. Выбор из BG_IMAGE_FITPAGE (0), BG_IMAGE_TILE (1), BG_IMAGE_ACTUALSIZE (2).
CustomMask	строка	Путь к файлу, что будет использован как маска окна, когда DialogStyle установлен в DIALOG_STYLE_CUSTOM_MASK. Этот параметр можно оставить пустой строкой ("") для очистки маски окна.
FitCustomMaskToWindow	логический	Истина (true), если файл маски установлен с изменяемыми размерами в соответствии с размерами диалогового окна, ложь (false) если это не так.

Возврат

Ничего. Можно использовать Application.GetLastError для определения случился ли отказ в работе этого действия и почему.

Смотрите также: Связанные действия

Примеры

Пример 1

-- Create a table containing the properties to set for the dialog.
-- Создать таблицу свойств, установленных для диалогового окна.
tbDialogProperties = {};
nNewColor = Math.HexColorToNumber("FF0000");
tbDialogProperties.BackgroundColor = nNewColor;
-- Set the dialog's properties.
-- Установить свойства диалогового окна.
Application.SetDialogProperties("Dialog1", tbDialogProperties);

Устанавливает фоновый цвет диалогового окна по имени "Dialog1".

Примечание: В этом примере предполагается что в данном окне по имени "Dialog1" в настоящее время имеется градиентный фоновый цвет.

Смотрите также: Связанные действия