QML-тип Label

Текстовая метка. Подробнее…

Строка импорта:	import Sailfish.Silica 1.0
Наследуется от:	Text
Наследники:	MenuItem и SectionHeader

• Список всех членов класса, включая унаследованные

Свойства

• highlighted : bool
• palette : Palette
• truncationMode : enumeration

Подробное описание

Тип Label реализует оформленную в стиле ОС Аврора текстовую метку. Цвет, семейство шрифтов и его размер по умолчанию устанавливаются в соответствии с текущей атмосферой.

Текст для метки устанавливается с помощью свойства text:

import Sailfish.Silica 1.0

Label {
    text: "Hello, world!"
}

При выборе цвета и шрифта, отличных от используемых по умолчанию, рекомендуется выбирать значения из свойств объекта Theme. Например:

import Sailfish.Silica 1.0

Label {
    text: "Hello, world!"
    color: Theme.highlightColor
    font.family: Theme.fontFamilyHeading
}

Дополнительную информацию о выборе цвета и размера для текста в ОС Аврора можно получить в описании типа Theme.

Label наследуется от типа QtQuick Text. Поэтому свойства, сигналы и методы Text (например color и font.family в примере выше) также доступны для объектов. Полный список доступных свойств, сигналов и методов приведён в документации Text.

В большинстве случаев предпочтение следует отдавать типу Label, а не Text.

Значения свойств по умолчанию из типа Text

Текстовые метки Label используют следующие значения свойств по умолчанию из типа Text:

• color: Theme.primaryColor;
• font.pixelSize: Theme.fontSizeMedium;
• textFormat: Text.PlainText;
• elide: если текст обрезается с помощью эффекта TruncationMode.Elide (т. е. эллипсис — замена пропускаемых слов многоточием), положение эллипсиса (слева, справа, посередине) выбирается в соответствии с текущим значение унаследованного свойства horizontalAlignment. В противном случае значением по умолчанию является Text.ElideNone.

Описание свойств

highlighted : bool

Определяет, должна ли метка подсвечиваться.

По умолчанию метка будет подсвечиваться, когда подсвечен элемент управления, частью которого метка является.

palette : Palette

Цветовая палитра метки.

Если один или несколько цветов родительского элемента управления palette были переопределены, эти изменения будут отражены здесь. В противном случае значения будут соответствовать эквивалентным свойствам цветов Theme.

truncationMode : enumeration

Определяет эффект, который применяется к концу текстовой строки, если она не умещается в заданные границы этого элемента. Данное свойство может принимать одно из значений:

• TruncationMode.None (по умолчанию);
• TruncationMode.Elide;
• TruncationMode.Fade.

В ОС Аврора предпочтительнее использовать TruncationMode.Fade. Примечание: этот эффект будет применяться только для однострочного текста. Для мнострочного текста всегда будет применяться эффект TruncationMode.Elide.

Следует обратить внимание, что установка значения унаследованного свойства Text::elide переопределяет эффекты truncationMode.