Hotspot.SetProperties

Hotspot.SetProperties ( string ObjectName,
table Properties )
Примеры

Свойства

Устанавливает свойства объекта активная зона (hotspot).

Параметры

ObjectName

(строка) Имя объекта активная зона (hotspot).

Properties

(таблица) Таблица, содержащая свойства объекта активная зона (hotspot), индексированная следующими ключами:

КЛЮЧ
KEY
ТИП
TYPE
ОПИСАНИЕ
DESCRIPTION
EnabledлогическийИстина (true), если объект активная зона (hotspot) должен быть включен, ложь (false), если отключен.
XчислоГоризонтальная позиция (в пикселах) верхнего левого угла объекта активная зона (hotspot), относительно текущей страницы или диалогового окна.

Примечание: Верхний левый угол текущей страницы или диалогового окна имеет значение координаты X равное 0.
YчислоВертикальная позиция (в пикселах) верхнего левого угла объекта активная зона (hotspot), относительно текущей страницы или диалогового окна.

Примечание: Верхний левый угол текущей страницы или диалогового окна имеет значение координаты X равное 0.
WidthчислоШирина (в пикселах) объекта активная зона (hotspot).
HeightчислоВысота (в пикселах) объекта активная зона (hotspot).
TooltipTextстрокаТекст всплывающей подсказки при наведении курсора мышки на объект активная зона (hotspot).

Совет: Если в тексте понадобился символ "&", следует ввести "&&&".
CursorчислоВид курсора мышки, что будет показан, при наведении на объект активная зона (hotspot):

КОНСТАНТА
CONSTANT
ЗНАЧЕНИЕ
VALUE
ОПИСАНИЕ
DESCRIPTION
CURSOR_ARROW0Стандартная стрелка.
CURSOR_HAND1Рука.
CURSOR_BLACK_ARROW2Черная стрелка.
CURSOR_CROSSHAIR3Перекрестие.
CURSOR_EXPLORE4Поиск.
CURSOR_HELP5Помощь.
CURSOR_MAGNIFY6Лупа.
CURSOR_MEDIA7Кинолента.
CURSOR_MONEY8Деньги.
CURSOR_NOTEPAD9Блокнот.
CURSOR_PENCIL10Карандаш.
CURSOR_PRINTER11Принтер.
CURSOR_SPEAKER12Динамик.
CURSOR_UP_ARROW13Стрелка вверх.
ResizeLeftлогическийИстина (true) если левая сторона объекта должна сдвигаться при изменении размеров окна приложения, ложь (false) если не должна.
ResizeRightлогическийИстина (true) если правая сторона объекта должна сдвигаться при изменении размеров окна приложения, ложь (false) если не должна.
ResizeTopлогическийИстина (true) если верхняя сторона объекта должна сдвигаться при изменении размеров окна приложения, ложь (false) если не должна.
ResizeBottomлогическийИстина (true) если нижняя сторона объекта должна сдвигаться при изменении размеров окна приложения, ложь (false) если не должна.
HighlightSoundчислоТип звука, что будет воспроизведен, при наведении курсора мышки на объект активная зона (hotspot).

КОНСТАНТА
CONSTANT
ЗНАЧЕНИЕ
VALUE
ОПИСАНИЕ
DESCRIPTION
SND_NONE0Нет звука при наведении.
SND_STANDARD1Стандартный звук при наведении.
SND_CUSTOM2Пользовательский звук при наведении.
HighlightSoundFileстрокаПуть к пользовательскому звуковому файлу, что будет воспроизведен при наведении на объект активная зона (hotspot). Если объект активная зона (hotspot) не использует пользовательский звук, это значение будет пустой строкой ("").

Примечание: Чтобы это вступило в силу, параметр HighlightSound должен быть установлен как SND_CUSTOM.
ClickSoundчислоТип звука, что будет воспроизведен, при клике мышкой по объекту активная зона (hotspot).

КОНСТАНТА
CONSTANT
ЗНАЧЕНИЕ
VALUE
ОПИСАНИЕ
DESCRIPTION
SND_NONE0Нет звука клика.
SND_STANDARD1Стандартный звук клика.
SND_CUSTOM2Пользовательский звук клика.
ClickSoundFileстрокаПуть к звуковому файлу пользовательского клика объекта активная зона (hotspot). Если объект активная зона (hotspot) не использует пользовательский звук, это значение будет пустой строкой ("").

Примечание: Чтобы это вступило в силу, параметр ClickSound должен быть установлен как SND_CUSTOM.

Возврат

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

Примеры

Пример 1

-- Change the tooltip text in use by a hotspot object
-- Изменяем текст всплывающей подсказки используемой в объекте активная зона
Hotspot.SetProperties("Hotspot1", {TooltipText = "I am a tooltip!!"});
Изменяем текст всплывающей подсказки объекта активная зона "Hotspot1".
Смотрите также: Связанные действия