QML-тип Label

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

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

Свойства

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

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

Текст для метки устанавливается с помощью свойства 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 в примере выше) также доступны для объектов Label. Полный список доступных свойств, сигналов и методов приведен в документации Text.

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

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

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

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

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

highlighted : bool

Specifies whether an label should appear highlighted.

By default a label will be highlighted when a control it is a member of is highlighted.

palette : Palette

The label's color palette.

If one or more of a parent control's {SilicaControl::palette}{palette} colors have been overridden those changes will be reflected here. Otherwise the values will follow the equivalent Theme color properties.

truncationMode : enumeration

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

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

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

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