Window.SetMask

Window.SetMask ( number WndHandle,
string MaskFile,
boolean FitToWindow = true,
number TransparentColor = 0 )
Примеры

Описание

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

Примечание: В операционных системах Windows 9x это действие будет работать только на окнах, созданных AutoPlay во время работы. Это означает что в системах Windows 9x маски не могут применяться к любым окнам принадлежащим другим программам.

Совет: Можно использовать это действие для изменения формы некоторых объектов, что являются фактически окнами внутри приложения AutoPlay. Следующие объекты формально являются окнами внутри приложения: Видео (Video), Флеш (Flash), Выпадающий список (ComboBox), Список (ListBox), Поле ввода (Input), Каталог (Tree), Ход процесса (Progress), Веб (Web), PDF, QuickTime и хКнопка (xButton).
Можно получить дескрипторы окна для любого из этих объектов используя соответствующие им действия GetProperties.

Параметры

WindowHandle

(число) Целочисленное значение, представляющее указанное окно на рабочем столе пользователя. (Обычно именуется как hWnd.)

MaskFile

(строка) Путь к файлу, что будет использован в качестве маски.

Совет: Передача пустой строки ("") в качестве параметра MaskFile убирает маску окна.

FitToWindow

(логический) Значение истина (true) если файл маски будет изменять размер в соответствии с размерами окна, значение ложь (false), если это будет не так. Значение по умолчанию истина (true).

TransparentColor

(число) Десятичное значение цвета, что будет использоваться в качестве прозрачного в маске окна. Значение по умолчанию равно 0 (черный цвет). Кликните по кнопке выбор (select) для вывода палитры выбора цвета.

Примечание: Для простоты использования рекомендуется использовать черный цвет (0) в качестве прозрачного цвета маски окна. Кроме того, постоянное использование одного и того же цвета для всех масок гарантирует совместимость.

Совет: Можно вычислить десятичное значение прозрачного цвета из его шестнадцатиричного значения при помощи действия Math.HexColorToNumber.

Возврат

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

Примеры

Пример 1

-- Get the current application's window handle
-- Получаем дескриптор текущего окна приложения
nHandle = Application.GetWndHandle();

-- Specify the path to use
-- Указываем путь к используемому файлу
sMaskFilePath = _SourceFolder .. "\\Masks\\Mask1.jpg";

-- Apply the mask to the window
-- Применяем маску к окну
Window.SetMask(nHandle, sMaskFilePath, true, 0);
Применяем маску окна "Mask1.jpg" к текущему приложению autoplay.

Пример 2

-- Apply the mask.jpg mask to the application window.
-- Применяем маску mask.jpg mask к окну приложения.
Window.SetMask(Application.GetWndHandle(), "Autoplay\\Images\\mask.jpg", true, 0);
Применяем маску окна "mask.jpg" к текущему приложению autoplay.
Смотрите также: Связанные действия