Image.SetProperties

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

Описание

Устанавливает свойства объекта графика (image).

Параметры

ObjectName

(строка) Имя объекта графика (image).

Properties

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

КЛЮЧ
KEY
ТИП
TYPE
ОПИСАНИЕ
DESCRIPTION
ImageFileстрокаЗагружаемый графический файл.
UseTransColorлогическийБудет ли использоваться прозрачный цвет в объекте графика (image).
TransparentColorчислоЦвет, используемый в качестве прозрачного в объекте графика (image).
ToleranceчислоДопустимое отклонение используемое для прозрачного цвета, в диапазоне от 0 до 100. Значение 0 точно соответствует цвету, указанному в параметре TransparentColor. Увеличение этого значения делает оттенки цвета TrasnparentColor более прозрачными.
OpacityчислоЧисло от 0 до 100 соответствующее проценту непрозрачности с которым отображается объект графика (image). Значение 0 делает объект графика (image) невидимым, в то время как значение 100 делает объект графика (image) видимым на 100%.
HitTestчислоРазрешит ли AutoPlay взаимодействовать мышке с объектом графика (image) в любом месте в границах объекта или только на непрозрачных его участках:

КОНСТАНТА
CONSTANT
ЗНАЧЕНИЕ
VALUE
ОПИСАНИЕ
DESCRIPTION
HITTEST_STANDARD0Мышка будет взаимодействовать с объектом графика (image) везде в границах объекта.
HITTEST_ALPHA1Мышка будет взаимодействовать с объектом графика (image) на всех непрозрачных участках изображения.
EnabledлогическийИстина (true) если объект графика (image) будет включен, ложь (false) если не будет.
VisibleлогическийИстина (true) если объект графика (image) будет видимым, ложь (false) если не будет.
Xчисло Горизонтальная позиция (в пикселах) верхнего левого угла объекта, относительно текущей страницы или диалогового окна.

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

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

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

КОНСТАНТА
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числоТип звука, что будет воспроизведен, при наведении курсора мышки на объект графика (image).

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

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

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

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

Возврат

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

Примеры

Пример 1

Image.SetProperties("Image1", {Opacity = 50});
Устанавливаем непрозрачность объекта графика "Image1" в 50%.
Смотрите также: Связанные действия