Label.SetProperties

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

Описание

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

Parameters

ObjectName

(строка) Имя объекта надпись (label).

Properties

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

КЛЮЧ
KEY		ТИП
TYPE		ОПИСАНИЕ
DESCRIPTION
TextстрокаТекст, что будет показан в объекте надпись (label).
FontNameстрокаНазвание шрифта.

Примечание: Если это значение указано, любые значения передаваемые для параметров Height или Width будут игнорированы.
FontSizeчислоРазмер шрифта (в пунктах).

Примечание: Если это значение указано, любые значения передаваемые для параметров Height или Width будут игнорированы.
FontStrikeoutлогическийИстина (true) если шрифт зачеркнутый, ложь (false) если нет.

Примечание: Если это значение указано, любые значения передаваемые для параметров Height или Width будут игнорированы.
FontUnderlineлогическийИстина (true) если шрифт подчеркнутый, ложь (false) если нет.

Примечание: Если это значение указано, любые значения передаваемые для параметров Height или Width будут игнорированы.
FontAntiAliasлогическийИстина (true) если шрифт сглаженный (anti alias), ложь (false) если нет.

Примечание: Если это значение указано, любые значения передаваемые для параметров Height или Width будут игнорированы.
FontItalicлогическийИстина (true) если шрифт курсивный, ложь (false) если нет.

Примечание: Если это значение указано, любые значения передаваемые для параметров Height или Width будут игнорированы.
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'.

Примечание: Если это значение указано, любые значения передаваемые для параметров Height или Width будут игнорированы.
FontScriptчислоНабор символов, используемый в объекте надпись (label):

КОНСТАНТА
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Турецкий набор символов.

Примечание: Если это значение указано, любые значения передаваемые для параметров Height или Width будут игнорированы.
AlignmentчислоВыравнивание текста в объекте надпись (label). Выбор из:

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

ЗНАЧЕНИЕ
VALUE		ОПИСАНИЕ
DESCRIPTION
0"Обычная" ориентация объекта надпись (label).
90Объект повернут на 90 градусов против часовой стрелки.
180Объект повернут на 180 градусов против часовой стрелки.
270Объект повернут на 270 градусов против часовой стрелки.
ColorNormalчисло"Обычный" цвет текста объекта надпись (label).
ColorHighlightчислоЦвет текста объекта надпись (label) при "наведении".
ColorDisabledчислоЦвет текста "отключенного" объекта надпись (label).
ColorDownчислоЦвет текста объекта надпись (label) при "нажатии".
EnabledлогическийИстина (true) если объект надпись (label) будет включен, ложь (false) если не будет.
VisibleлогическийИстина (true) если объект надпись (label) будет видимый, ложь (false) если не будет.
XчислоГоризонтальная позиция (в пикселах) верхнего левого угла объекта надпись (label), относительно текущей страницы или диалогового окна.

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

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

Примечание: Размер объекта надпись (label) будет изменен так чтобы его ширина стала наиболее близкой к этому значению при сохранении целочисленного значения размера шрифта. Если это значение указано (задано), любое значение передаваемое для параметра Width будет игнорировано.

Совет: Для настройки обоих свойств, связанных со шрифтом, а также ширины объекта надпись (label), используйте два разных действия.
HeightчислоВысота (в пикселах) объекта надпись (label).

Примечание: Размер объекта надпись (label) будет изменен так чтобы его высота стала наиболее близкой к этому значению при сохранении целочисленного значения размера шрифта. Если значение указано для параметра Width, значение параметра Height будет игнорировано.

Совет: Для настройки обоих свойств, связанных со шрифтом, а также высоты объекта надпись (label), используйте два разных действия.
TooltipTextстрокаТекст всплывающей подсказки при наведении курсора мышки на объект надпись (label).

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

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

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

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

Возврат

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

Примеры

Пример 1

-- Populate table from item properties
-- Получаем таблицу свойств объекта
tProperties = Label.GetProperties("Slogan");

-- Change the desired items
-- Изменяем нужные пункты
tProperties.Enabled = true;
tProperties.Visible = false;
tProperties.Text = "I am new text!!!";

-- Set the properties of a label object
-- Устанавливаем свойства объекта надпись
Label.SetProperties("Slogan", tProperties);
Изменяем свойства объекта надпись (label) "Slogan" на свойства содержащие в таблице "tProperties".
Смотрите также: Связанные действия