xButton.SetProperties

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

Описание

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

Параметры

ObjectName

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

Properties

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

КЛЮЧ
KEY		ТИП
TYPE		ОПИСАНИЕ
DESCRIPTION
TextстрокаТекст, что будет показан на объекте хКнопка (xButton).
ButtonImageстрокаПуть к графическому файлу, что будет отображен на объекте хКнопка (xButton). Объект хКнопка поддерживает следующие графические форматы: .bmp, .jpg, .png, .wmf, .gif и .ico (иконки).
TextColorчислоЦвет текста.
EnableMarkupлогическийИстина (true) если разметка текста будет включена, ложь (false) если этого не будет.
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числоНабор символов, что будет использован в объекте хКнопка (xButton):

КОНСТАНТА
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Турецкий набор символов.
TextAlignmentчислоВыравнивание текста (дается выравнивание по вертикали - по верху, по середине и по низу, а также по горизонтали - по левой стороне, по центру (ширине) и по правой стороне):

КОНСТАНТА
CONSTANT		ЗНАЧЕНИЕ
VALUE		ОПИСАНИЕ
DESCRIPTION
XBTN_ALIGN_MIDDLE_LEFT0Выравнивание текста по середине и по левой стороне.
XBTN_ALIGN_MIDDLE_RIGHT1Выравнивание текста по середине и по правой стороне.
XBTN_ALIGN_MIDDLE_CENTER2Выравнивание текста по середине и по центру.
XBTN_ALIGN_TOP_LEFT3Выравнивание текста по верху и по левой стороне.
XBTN_ALIGN_TOP_RIGHT4Выравнивание текста по верху и по правой стороне.
XBTN_ALIGN_TOP_CENTER5Выравнивание текста по верху и по центру.
XBTN_ALIGN_BOTTOM_LEFT6Выравнивание текста по низу и по левой стороне.
XBTN_ALIGN_BOTTOM_RIGHT7Выравнивание текста по низу и по правой стороне.
XBTN_ALIGN_BOTTOM_CENTER8Выравнивание текста по низу и по центру.
ImageAlignmentчислоВыравнивание изображения (дается выравнивание по вертикали - по верху, по середине и по низу, а также по горизонтали - по левой стороне, по центру и по правой стороне):

КОНСТАНТА
CONSTANT		ЗНАЧЕНИЕ
VALUE		ОПИСАНИЕ
DESCRIPTION
XBTN_ALIGN_MIDDLE_LEFT0Изображение выравнивается по середине и по левой стороне.
XBTN_ALIGN_MIDDLE_RIGHT1Изображение выравнивается по середине и по правой стороне.
XBTN_ALIGN_MIDDLE_CENTER2Изображение выравнивается по середине и по центру.
XBTN_ALIGN_TOP_LEFT3Изображение выравнивается по верху и по левой стороне.
XBTN_ALIGN_TOP_RIGHT4Изображение выравнивается по верху и по правой стороне.
XBTN_ALIGN_TOP_CENTER5Изображение выравнивается по верху и по центру.
XBTN_ALIGN_BOTTOM_LEFT6Изображение выравнивается по низу и по левой стороне.
XBTN_ALIGN_BOTTOM_RIGHT7Изображение выравнивается по низу и по правой стороне.
XBTN_ALIGN_BOTTOM_CENTER8Изображение выравнивается по низу и по центру.
ImageTextRelationчислоСоотношение между текстом и изображением:

КОНСТАНТА
CONSTANT		ЗНАЧЕНИЕ
VALUE		ОПИСАНИЕ
DESCRIPTION
RELATION_OVERLAY0Изображение показано поверх текста.
RELATION_IMAGE_ABOVE_TEXT1Изображение показано над текстом.
RELATION_TEXT_ABOVE_IMAGE2Текст показан над изображением.
RELATION_IMAGE_BEFORE_TEXT3Изображение показано перед (слева) текстом.
RELATION_TEXT_BEFORE_IMAGE4Текст показан перед (слева) изображением.
ThemeчислоВизуальная тема объекта хКнопка (xButton):

КОНСТАНТА
CONSTANT		ЗНАЧЕНИЕ
VALUE		ОПИСАНИЕ
DESCRIPTION
THEME_STANDARD0Стандартная тема.
THEME_FLAT1Тема Flat.
THEME_ULTRA_FLAT2Тема Ultra flat.
THEME_OFFICE_20003Тема Office 2000.
THEME_OFFICE_XP4Тема Office XP.
THEME_OFFICE_20035Тема Office 2003.
THEME_OFFICE_20076Тема Office 2007.
Style числоСтиль объекта хКнопка (xButton):

КОНСТАНТА
CONSTANT		ЗНАЧЕНИЕ
VALUE		ОПИСАНИЕ
DESCRIPTION
BTNSTYLE_STANDARD0хКнопка (xButton) является обычной кнопкой.
BTNSTYLE_TOGGLE1хКнопка (xButton) является кнопкой-переключателем.
ToggleStateчислоТекущее состояние переключения объекта хКнопка (xButton).

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

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

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

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

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

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

Возврат

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

Примеры

Пример 1

-- Changes the font size of xButton1 to 99 pt
-- Изменяем размер шрифта на объекте хКнопка xButton1 на 99 pt
xButton.SetProperties("xButton1", {FontSize = 99});

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