Button.SetProperties

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

Описание

Устанавливает свойства объекта кнопка (button).

Параметры

ObjectName

(строка) Имя объекта кнопка (button).

Properties

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

КЛЮЧ
KEY		ТИП
TYPE		ОПИСАНИЕ
DESCRIPTION
ButtonFileстрокаФайл кнопки для загрузки.
TextстрокаТекст, для отображения на объекте кнопка (button).
FontNameстрокаИмя шрифта.
FontSizeчислоРазмер шрифта (в пунктах).
FontStrikeoutлогическийИстина (true) если шрифт зачеркнутый, ложь (false) если нет.
FontUnderlineлогическийИстина (true) если шрифт подчеркнутый, ложь (false) если нет.
FontAntiAliasлогическийИстина (true) если шрифт сглаженный (anti alias), ложь (false) если нет.
FontItalicлогическийИстина (true) если шрифт курсивный, ложь (false) если нет.
FontWeightчислоПлотность шрифта (какой степени "черноты" будет показан текст):

КОНСТАНТА
CONSTANT		ЗНАЧЕНИЕ
VALUE		ОПИСАНИЕ
DESCRIPTION
FW_DONTCARE0Плотность шрифта не указана.
FW_THIN100Плотность шрифта 'тонкий - thin'.
FW_EXTRALIGHT200Плотность шрифта 'экстрасветлый - extra-light'.
FW_LIGHT300Плотность шрифта 'светлый - light'.
FW_NORMAL400Плотность шрифта 'стандартный - normal'.
FW_MEDIUM500Плотность шрифта 'средний - medium'.
FW_SEMIBOLD600Плотность шрифта 'полужирный - semi-bold'.
FW_BOLD700Плотность шрифта 'жирный - bold'.
FW_EXTRABOLD800Плотность шрифта 'экстражирный - extra bold'.
FW_HEAVY900Плотность шрифта 'тяжелый - heavy'.
FontScriptчислоНабор символов, используемый в объекте кнопка (button):

КОНСТАНТА
CONSTANT		ЗНАЧЕНИЕ
VALUE		ОПИСАНИЕ
DESCRIPTION
ANSI_CHARSET0Набор символов ANSI.
BALTIC_CHARSET186Балтийский набор символов.
CHINESEBIG5_CHARSET136Китайский набор символов.
DEFAULT_CHARSET1Набор символов по умолчанию.
EASTEUROPE_CHARSET238Восточно европейский набор символов.
GB2312_CHARSET134Набор символов GB2312.
GREEK_CHARSET161Греческий набор символов.
HANGUL_CHARSET129Корейский (хангул) набор символов.
MAC_CHARSET77Набор символов MAC.
OEM_CHARSET255Набор символов OEM.
RUSSIAN_CHARSET204Русский набор символов.
SHIFTJIS_CHARSET128Набор символов Shiftjis.
SYMBOL_CHARSET2Символьный набор символов.
TURKISH_CHARSET162Турецкий набор символов.
XOffsetчислоГоризонтальное смещение текста относительно объекта кнопка (button).
YOffsetчислоВертикальное смещение текста относительно объекта кнопка (button).
LeftMarginчислоРазмер левого поля (в пикселах), оставляемый вокруг текста.
RightMarginчислоРазмер правого поля (в пикселах), оставляемый вокруг текста.
AlignmentчислоВыравнивание текста:

КОНСТАНТА
CONSTANT		ЗНАЧЕНИЕ
VALUE		ОПИСАНИЕ
DESCRIPTION
ALIGN_LEFT0Текст выровнен по левому краю.
ALIGN_CENTER1Текст выровнен по центру.
ALIGN_RIGHT2Текст выровнен по правому краю.
StyleчислоСтиль объекта кнопка (button):

КОНСТАНТА
CONSTANT		ЗНАЧЕНИЕ
VALUE		ОПИСАНИЕ
DESCRIPTION
BTNSTYLE_STANDARD0Стандартная кнопка.
BTNSTYLE_TOGGLE1Кнопка-переключатель.
ToggleStateчислоТекущее состояние объекта кнопка (button):

КОНСТАНТА
CONSTANT		ЗНАЧЕНИЕ
VALUE		ОПИСАНИЕ
DESCRIPTION
BTN_UP0Кнопка в верхнем положении (отпущена).
BTN_DOWN1Кнопка в нижнем положении (нажата).
ColorNormalчисло'Обычный' цвет текста объекта кнопка (button).
ColorHighlightчислоЦвет текста объекта кнопка (button) при 'наведении'.
ColorDisabledчислоЦвет текста 'незадействованного' объекта кнопка (button).
ColorDownчислоЦвет текста объекта кнопка (button) при 'нажатии'.
EnabledлогическийИстина (true) если объект кнопка (button) будет задействован, ложь (false) если не будет.
VisibleлогическийИстина (true) если объект кнопка (button) будет видимый, ложь (false) если не будет.
XчислоГоризонтальная позиция (в пикселах) верхнего левого угла объекта кнопка, относительно текущей страницы или диалогового окна.

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

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

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

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

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

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

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

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

Возврат

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

Примеры

Пример 1

-- Changes the font size of Button1 to 99 pt
-- Изменяем размер шрифта Button1 на 99 pt
Button.SetProperties("Button1", {FontSize = 99});

-- Change the text to "Hello World" and Width to 100
-- Изменяем текст на "Hello World" и ширину на 100
tblProperties = {Text = "Hello World", Width = 100};
Button.SetProperties("Button1", tblProperties);
Изменяем размер шрифта, текст и ширину объекта кнопка, названного 'Button1'.
Смотрите также: Связанные действия