Text

Text - элемент управления, предназначенный для отображения текста.

Свойства

id

Идентификатор контрола.

Отнаследовано от Control.

hint

Всплывающая подсказка, которая появляется при наведении на контрол.

Отнаследовано от Control.

hintLength

тип	значение по умолчанию	допустимые значения
int	-

Максимальное количество символов для всплывающей подсказки

tags

Позволяет объединять контролы в группы, возвращает массив имен.

Отнаследовано от Control.

captionWidth

Ширина заголовка в колонках (для Bootstrap-верстки).

отнаследовано от Control

editorWidth

Ширина контрола в колонках (для Bootstrap-верстки).

отнаследовано от Control

captionTextAlign

тип	значение по умолчанию	допустимые значения
string	left	left/right

Выравнивание текста заголовка контрола

denyRoles

Список ролей без прав на данный элемент.

Отнаследовано от Control.

readRoles

Список ролей на чтение данных.

Отнаследовано от Control.

writeRoles

Список ролей на изменение данных.

Отнаследовано от Control.

visible

Видимость контрола.

Отнаследовано от Control.

caption

тип	значение по умолчанию	допустимые значения
string	-

Заголовок контрола

bind

тип	значение по умолчанию	допустимые значения
string	-

Свойство, к которому биндится контрол

value

тип	значение по умолчанию	допустимые значения
string	-

Значение контрола без биндинга

captionFontStyle

тип	значение по умолчанию	допустимые значения
string	normal	normal, italic, oblique

Стиль начертания шрифта заголовка контрола

captionFontWeight

тип	значение по умолчанию	допустимые значения
string	normal	normal, bold, bolder, lighter, number

Стиль начертания шрифта заголовка контрола

captionColor

тип	значение по умолчанию	допустимые значения
string	-

Цвет текста заголовка

captionFontSize

тип	значение по умолчанию	допустимые значения
string	-

Размер текста заголовка. Строка в формате Npx, где N - число

fontStyle

тип	значение по умолчанию	допустимые значения
string	normal	normal, italic, oblique

Стиль начертания шрифта текста контрола

fontWeight

тип	значение по умолчанию	допустимые значения
string	normal

Насыщенность шрифта текста контрола

fontColor

тип	значение по умолчанию	допустимые значения
string	-

Цвет текста контрола

textAlign

тип	знач. по умолч.	допустимые значения
string	left	left, right, center

Выравнивание текста контрола

fontSize

тип	значение по умолчанию	допустимые значения
string	-

Размер текста контрола. Строка в формате Npx, где N - число

multiline

тип	значение по умолчанию	допустимые значения
bool	false	true/false

Флаг, отвечающий за работу в многострочном режиме.

Свойство работает только внутри WidgetForm

События

valueChanged

Возникает при смене значения

Callbacks

linkRenderer

Колбэк, возвращающий объект со свойством url, для составления ссылки в области значения. Принимает два парамметра - ссылка на контрол и значение value контрола.

Пример

myForm.js

linkRenderer1 (s, e) {
    return {
        url: Link.createUrl({
            route: 'view',
            params: { name: 'validationReg' }
        })
    }
}

Пример

myForm.xmlmyForm.js

<Group caption="Text">
    <Text caption="Простой текст" value="СООБЩЕНИЕ" id="simpleText" 
        editorWidth="2" captionWidth="3" />
    <Text caption="Оформление заголовка" value="СООБЩЕНИЕ" id="captionOptions" 
        captionTextAlign="right" captionFontStyle="oblique" captionFontWeight="bolder"
        captionColor="teal" captionFontSize="15px"
        editorWidth="2" captionWidth="3" />
    <Text caption="Оформление значения" value="СООБЩЕНИЕ" id="valueOptions" 
        fontStyle="italic" fontWeight="lighter" fontColor="purple" textAlign="left" fontSize="25px"
        editorWidth="2" captionWidth="3" />
    <Text caption="Ссылка в значении" value="СООБЩЕНИЕ" id="linkText" 
        linkRenderer="textLink"
        editorWidth="2" captionWidth="3" />
</Group>

textLink () {
    return {
        url: Link.createUrl({
            route: 'view',
            params: { name: 'analyticalForm' }
        })
    }
}

Контрол Text позволяет выводить в приложении текстовую информацию с поддержкой форматирования и настройки внешнего вида текста. В примере представлены четыре варианта настройки контрола:

• без дополнительного форматирования;
• с форматированием заголовка;
• с форматированием значения;
• режим гиперссылки.

Генерация гиперссылок осуществляется с помощью системных методов, например, можно использовать контрол Link: метод textLink.

---