xButton.GetProperties

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

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

КЛЮЧ KEY	ТИП TYPE	ОПИСАНИЕ DESCRIPTION
ObjectName	строка	Имя объекта хКнопка (xButton).
Text	строка	Текст, отображаемый на объекте хКнопка (xButton).
ButtonImage	строка	Полный путь к графическому файлу, отображаемому на объекте хКнопка (xButton).
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_DONTCARE 0 Плотность шрифта не указана. FW_THIN 100 Плотность шрифта 'тонкий - thin'. FW_EXTRALIGHT 200 Плотность шрифта 'экстрасветлый - extra-light'. FW_LIGHT 300 Плотность шрифта 'светлый - light'. FW_NORMAL 400 Плотность шрифта 'стандартный - normal'. FW_MEDIUM 500 Плотность шрифта 'средний - medium'. FW_SEMIBOLD 600 Плотность шрифта 'полужирный - semi-bold'. FW_BOLD 700 Плотность шрифта 'жирный - bold'. FW_EXTRABOLD 800 Плотность шрифта 'экстражирный - extra bold'. FW_HEAVY 900 Плотность шрифта 'тяжелый - heavy'.
FontScript	число	Набор символов, используемый в объекте хКнопка (xButton): КОНСТАНТА CONSTANT ЗНАЧЕНИЕ VALUE ОПИСАНИЕ DESCRIPTION ANSI_CHARSET 0 Набор символов ANSI. BALTIC_CHARSET 186 Балтийский набор символов. CHINESEBIG5_CHARSET 136 Китайский набор символов. DEFAULT_CHARSET 1 Набор символов по умолчанию. EASTEUROPE_CHARSET 238 Восточно европейский набор символов. GB2312_CHARSET 134 Набор символов GB2312. GREEK_CHARSET 161 Греческий набор символов. HANGUL_CHARSET 129 Корейский (хангул) набор символов. MAC_CHARSET 77 Набор символов MAC. OEM_CHARSET 255 Набор символов OEM. RUSSIAN_CHARSET 204 Русский набор символов. SHIFTJIS_CHARSET 128 Набор символов Shiftjis. SYMBOL_CHARSET 2 Символьный набор символов. TURKISH_CHARSET 162 Турецкий набор символов.
TextAlignment	число	Выравнивание текста (дается выравнивание по вертикали - по верху, по середине и по низу, а также по горизонтали - по левой стороне, по центру (ширине) и по правой стороне): КОНСТАНТА CONSTANT ЗНАЧЕНИЕ VALUE ОПИСАНИЕ DESCRIPTION XBTN_ALIGN_MIDDLE_LEFT 0 Выравнивание текста по середине и по левой стороне. XBTN_ALIGN_MIDDLE_RIGHT 1 Выравнивание текста по середине и по правой стороне. XBTN_ALIGN_MIDDLE_CENTER 2 Выравнивание текста по середине и по центру. XBTN_ALIGN_TOP_LEFT 3 Выравнивание текста по верху и по левой стороне. XBTN_ALIGN_TOP_RIGHT 4 Выравнивание текста по верху и по правой стороне. XBTN_ALIGN_TOP_CENTER 5 Выравнивание текста по верху и по центру. XBTN_ALIGN_BOTTOM_LEFT 6 Выравнивание текста по низу и по левой стороне. XBTN_ALIGN_BOTTOM_RIGHT 7 Выравнивание текста по низу и по правой стороне. XBTN_ALIGN_BOTTOM_CENTER 8 Выравнивание текста по низу и по центру.
ImageAlignment	число	Выравнивание изображения (дается выравнивание по вертикали - по верху, по середине и по низу, а также по горизонтали - по левой стороне, по центру и по правой стороне): КОНСТАНТА CONSTANT ЗНАЧЕНИЕ VALUE ОПИСАНИЕ DESCRIPTION XBTN_ALIGN_MIDDLE_LEFT 0 Изображение выравнивается по середине и по левой стороне. XBTN_ALIGN_MIDDLE_RIGHT 1 Изображение выравнивается по середине и по правой стороне. XBTN_ALIGN_MIDDLE_CENTER 2 Изображение выравнивается по середине и по центру. XBTN_ALIGN_TOP_LEFT 3 Изображение выравнивается по верху и по левой стороне. XBTN_ALIGN_TOP_RIGHT 4 Изображение выравнивается по верху и по правой стороне. XBTN_ALIGN_TOP_CENTER 5 Изображение выравнивается по верху и по центру. XBTN_ALIGN_BOTTOM_LEFT 6 Изображение выравнивается по низу и по левой стороне. XBTN_ALIGN_BOTTOM_RIGHT 7 Изображение выравнивается по низу и по правой стороне. XBTN_ALIGN_BOTTOM_CENTER 8 Изображение выравнивается по низу и по центру.
ImageTextRelation	число	Соотношение между текстом и изображением: КОНСТАНТА CONSTANT ЗНАЧЕНИЕ VALUE ОПИСАНИЕ DESCRIPTION RELATION_OVERLAY 0 Изображение показано поверх текста. RELATION_IMAGE_ABOVE_TEXT 1 Изображение показано над текстом. RELATION_TEXT_ABOVE_IMAGE 2 Текст показан над изображением. RELATION_IMAGE_BEFORE_TEXT 3 Изображение показано перед (слева) текстом. RELATION_TEXT_BEFORE_IMAGE 4 Текст показан перед (слева) изображением.
Theme	число	Визуальная тема объекта хКнопка (xButton): КОНСТАНТА CONSTANT ЗНАЧЕНИЕ VALUE ОПИСАНИЕ DESCRIPTION THEME_STANDARD 0 Стандартная тема. THEME_FLAT 1 Тема Flat. THEME_ULTRA_FLAT 2 Тема Ultra flat. THEME_OFFICE_2000 3 Тема Office 2000. THEME_OFFICE_XP 4 Тема Office XP. THEME_OFFICE_2003 5 Тема Office 2003. THEME_OFFICE_2007 6 Тема Office 2007.
Style	число	Стиль объекта хКнопка (xButton): КОНСТАНТА CONSTANT ЗНАЧЕНИЕ VALUE ОПИСАНИЕ DESCRIPTION BTNSTYLE_STANDARD 0 хКнопка (xButton) является обычной кнопкой. BTNSTYLE_TOGGLE 1 хКнопка (xButton) является кнопкой-переключателем.
ToggleState	число	Текущее состояние объекта хКнопка (xButton). КОНСТАНТА CONSTANT ЗНАЧЕНИЕ VALUE ОПИСАНИЕ DESCRIPTION BTN_UP 0 хКнопка в верхнем положении (отпущена). BTN_DOWN 1 хКнопка в нижнем положении (нажата).
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_ARROW 0 Стандартная стрелка. CURSOR_HAND 1 Рука. CURSOR_BLACK_ARROW 2 Черная стрелка. CURSOR_CROSSHAIR 3 Перекрестие. CURSOR_EXPLORE 4 Поиск. CURSOR_HELP 5 Помощь. CURSOR_MAGNIFY 6 Лупа. CURSOR_MEDIA 7 Кинолента. CURSOR_MONEY 8 Деньги. CURSOR_NOTEPAD 9 Блокнот. CURSOR_PENCIL 10 Карандаш. CURSOR_PRINTER 11 Принтер. CURSOR_SPEAKER 12 Динамик. CURSOR_UP_ARROW 13 Стрелка вверх.
ResizeLeft	логический	Истина (true) если левая сторона объекта будет сдвигаться при изменении размеров окна приложения, ложь (false) если нет.
ResizeRight	логический	Истина (true) если правая сторона объекта будет сдвигаться при изменении размеров окна приложения, ложь (false) если нет.
ResizeTop	логический	Истина (true) если верхняя сторона объекта будет сдвигаться при изменении размеров окна приложения, ложь (false) если нет.
ResizeBottom	логический	Истина (true) если нижняя сторона объекта будет сдвигаться при изменении размеров окна приложения, ложь (false) если нет.
HighlightSound	число	Тип звука, что будет воспроизведен, при наведении курсора мышки на объект хКнопка (xButton). КОНСТАНТА CONSTANT ЗНАЧЕНИЕ VALUE ОПИСАНИЕ DESCRIPTION SND_NONE 0 Нет звука при наведении. SND_STANDARD 1 Стандартный звук при наведении. SND_CUSTOM 2 Пользовательский звук при наведении.
HighlightSoundFile	строка	Путь к пользовательскому звуковому файлу, что будет воспроизведен при наведении на объект хКнопка (xButton). Если объект хКнопка (xButton) не использует пользовательский звук, это значение будет пустой строкой ("").
ClickSound	число	Тип звука, что будет воспроизведен, при клике мышкой по объекту хКнопка (xButton). КОНСТАНТА CONSTANT ЗНАЧЕНИЕ VALUE ОПИСАНИЕ DESCRIPTION SND_NONE 0 Нет звука клика. SND_STANDARD 1 Стандартный звук клика. SND_CUSTOM 2 Пользовательский звук клика.
ClickSoundFile	строка	Путь к звуковому файлу пользовательского клика объекта хКнопка (xButton). Если объект хКнопка (xButton) не использует пользовательский звук, это значение будет пустой строкой ("").
WindowHandle	число	Целочисленное значение, представляющее окно объекта. (Обычно именуется как hWnd.)

Если объект не найден, будет возвращено значение nil. Можно использовать Application.GetLastError для определения случился ли отказ в работе этого действия и почему.

При добавлении действия из редактора скрипта, можно использовать это поле для определения переменной, которая возвращает значение, сохраняющееся в ней.

ButtonProperties = xButton.GetProperties("xButton1");

if ButtonProperties.Cursor == CURSOR_BLACK_ARROW then
   -- The black arrow cursor is being used
   -- Используется курсор - черная стрелка
end

if xButton.GetProperties("xButton1").FontItalic then
   -- The xButton text is Italic
   -- Текст xКнопки курсивный
end

Извлекаем различные свойства из объекта хКнопка по имени 'xButton1'.