Тип QML Text

Определяет, как добавить форматированный текст в сцену. Подробнее...

Заявление об импорте:	import QtQuick 2.13
Наследует:	Элемент

Свойства

advance : размер
antialiasing : bool
baseUrl : url
bottomPadding : вещественное
clip : bool
цвет : цвет
высота содержимого : вещественное
ширина содержимого : вещественное
эффективное горизонтальное выравнивание : перечисление
elide : перечисление
font.bold : bool
font.capitalization : перечисление
font.family : строка
font.hintingPreference : перечисление
font.italic : bool
font.kerning : bool
font.letterSpacing : вещественное
font.pixelSize : целое
font.pointSize : вещественное
font.preferShaping : bool
font.strikeout : bool
font.styleName : строка
font.underline : bool
font.weight : перечисление
font.wordSpacing : вещественное
fontInfo.bold : bool
fontInfo.family : строка
fontInfo.italic : bool
fontInfo.pixelSize : строка
fontInfo.pointSize : вещественное
fontInfo.styleName : строка
fontInfo.weight : целое
fontSizeMode : перечисление
горизонтальное выравнивание : перечисление
hoveredLink : строка
leftPadding : вещественное
количество строк : целое
высота строки : вещественное
lineHeightMode : перечисление
цвет ссылки : цвет
максимальное количество строк : целое
минимальный размер пикселей : целое
минимальный размер точки : целое
отступ : вещественное
тип рендеринга : перечисление
правый отступ : вещественное
стиль : перечисление
цвет стиля : цвет
текст : строка
формат текста : перечисление
верхний отступ : вещественное
обрезанный : bool
вертикальное выравнивание : перечисление
режим обрезки : перечисление

Сигналы

lineLaidOut(строка)
linkActivated(ссылка)
linkHovered(ссылка)

Методы

forceLayout()
linkAt(x, вещественное y)

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

Элементы Text могут отображать как обычный, так и форматированный текст. Например, красный текст с определённым шрифтом и размером можно определить так:

Text {
    text: "Hello World!"
    font.family: "Helvetica"
    font.pointSize: 24
    color: "red"
}

Форматированный текст определяется с помощью разметки в стиле HTML:

Text {
    text: "<b>Hello</b> <i>World!</i>"
}

Если высота и ширина не заданы явно, Text попытается определить необходимое пространство и установить его соответствующим образом. Если wrapMode не установлен, всегда отдаётся предпочтение ширине по сравнению с высотой (весь текст будет размещён на одной строке).

Свойство elide альтернативно может использоваться для размещения одной строки обычного текста по заданной ширине.

Обратите внимание, что поддерживаемый подмножество HTML ограничено. Также, если текст содержит теги HTML img, загружающие удалённые изображения, текст перегружается.

Text предоставляет только для чтения текст. Для редактируемого текста см. TextEdit.

См. также Пример шрифтов.

Документация по свойствам

отступ : вещественное

Эти свойства содержат отступы вокруг содержимого. Это пространство зарезервировано дополнительно к contentWidth и contentHeight.

Эта документация была введена в Qt 5.6.

горизонтальное выравнивание : перечисление

Устанавливает горизонтальное и вертикальное выравнивание текста в пределах ширины и высоты элементов Text. По умолчанию текст выравнивается по вертикали сверху. Горизонтальное выравнивание следует естественному выравниванию текста, например, текст, который читается слева направо, будет выровнен слева.

Допустимые значения для horizontalAlignment являются Text.AlignLeft, Text.AlignRight, Text.AlignHCenter и Text.AlignJustify. Допустимые значения для verticalAlignment являются Text.AlignTop, Text.AlignBottom и Text.AlignVCenter.

Обратите внимание, что для одной строки текста размер текста — это область текста. В этом общем случае все выравнивания эквивалентны. Если вы хотите выровнять текст по центру родительского элемента, вам нужно либо изменить Item::anchors, либо установить horizontalAlignment на Text.AlignHCenter и связать ширину с шириной родительского элемента.

При использовании присоединённого свойства LayoutMirroring::enabled для отражения макетов приложения, горизонтальное выравнивание текста также будет отражено. Однако свойство horizontalAlignment останется без изменений. Для запроса эффективного горизонтального выравнивания Text используйте свойство только для чтения effectiveHorizontalAlignment.

advance : размер

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

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

Это свойство было введено в Qt 5.10.

сглаживание : bool

Используется для определения, нужно ли использовать сглаживание для Text. Только Text с renderType Text.NativeRendering может отключить сглаживание.

По умолчанию значение true.

baseUrl : url

Это свойство определяет базовый URL, используемый для разрешения относительных URL-адресов в тексте.

URL-адреса разрешаются для размещения в той же директории, что и цель базового URL-адреса, означая, что любая часть пути после последнего '/' будет проигнорирована.

Базовый URL	Относительный URL	Разрешённый URL
http://qt-project.org/	images/logo.png	http://qt-project.org/images/logo.png
http://qt-project.org/index.html	images/logo.png	http://qt-project.org/images/logo.png
http://qt-project.org/content	images/logo.png	http://qt-project.org/content/images/logo.png
http://qt-project.org/content/	images/logo.png	http://qt-project.org/content/images/logo.png
http://qt-project.org/content/index.html	images/logo.png	http://qt-project.org/content/images/logo.png
http://qt-project.org/content/index.html	../images/logo.png	http://qt-project.org/images/logo.png
http://qt-project.org/content/index.html	/images/logo.png	http://qt-project.org/images/logo.png

Значение по умолчанию — URL файла QML, создающего элемент Text.

clip : bool

Данное свойство определяет, обрезается ли текст.

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

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

color : color

Цвет текста.

Пример зеленого текста, определенного в шестнадцатеричном формате:

Text {
    color: "#00FF00"
    text: "green text"
}

Пример стального синего текста, определенного с помощью имени цвета SVG:

Text {
    color: "steelblue"
    text: "blue text"
}

contentHeight : real

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

contentWidth : real

Возвращает ширину текста, включая ширину, превышающую ширину, ограниченную недостаточным обтеканием, если WrapMode установлен.

elide : enumeration

Установите это свойство для обрезки частей текста, подходящих к ширине элемента Text. Текст будет обрезаться только в том случае, если явно задана ширина.

Это свойство нельзя использовать с форматированным текстом.

Обрезка может быть:

Text.ElideNone — значение по умолчанию
Text.ElideLeft
Text.ElideMiddle
Text.ElideRight

Если это свойство установлено в Text.ElideRight, оно может использоваться с обтеканием текста. Текст будет обрезаться только в том случае, если maximumLineCount, или height установлено. Если оба maximumLineCount и height установлены, maximumLineCount применится, если строки не помещаются в разрешенную высоту.

Если текст является строкой с несколькими длинами, а режим не Text.ElideNone, будет использоваться первая строка, которая помещается, в противном случае будет обрезана последняя.

Строки с несколькими длинами упорядочены от длинных к коротким, разделенные символом Unicode "String Terminator" U009C (записывается в QML как "\u009C" или "\x9C").

font.bold : bool

Устанавливает, является ли вес шрифта жирным.

font.capitalization : enumeration

Устанавливает регистр текста.

Font.MixedCase — обычный вариант отображения текста, без изменений регистра.
Font.AllUppercase — меняет текст на прописные буквы.
Font.AllLowercase — меняет текст на строчные буквы.
Font.SmallCaps — меняет текст на полужирный шрифт.
Font.Capitalize — изменяет текст, делая первую букву каждого слова заглавной.

Text { text: "Hello"; font.capitalization: Font.AllLowercase }

font.family : string

Устанавливает имя семейства шрифта.

Имя семейства не чувствительно к регистру и может необязательно включать имя литейного завода, например, «Helvetica [Cronyx]». Если семейство доступно от нескольких литейных заводов, и литейный завод не указан, выбирается произвольный литейный завод. Если семейство недоступно, будет установлено семейство, используя алгоритм подбора шрифтов.

font.hintingPreference : enumeration

Устанавливает предпочтительный уровень начертания текста. Это подсказка для системы рендеринга текста использовать определенный уровень начертания, и поддержка варьируется в зависимости от платформы. Подробнее см. таблицу в документации для QFont::HintingPreference.

Примечание: Это свойство действует только при использовании вместе с типом рендеринга Text.NativeRendering.

Font.PreferDefaultHinting — использовать уровень начертания по умолчанию для целевой платформы.

Font.PreferNoHinting — по возможности отображать текст без начертания контуров глифов. Разметка текста будет типографически точной, используя те же метрики, что и, например, при печати.

Font.PreferVerticalHinting — по возможности отображать текст без начертания по горизонтали, но выравнивать глифы по пиксельной сетке по вертикали. Текст будет выглядеть резче на дисплеях, где плотность слишком низкая, чтобы обеспечить точное отображение глифов. Но поскольку горизонтальные метрики глифов не начерчены, разметка текста будет масштабируемой на устройствах с большей плотностью (таких как принтеры) без изменения деталей, таких как переводы строк.

Font.PreferFullHinting — по возможности отображать текст с начертанием по горизонтали и вертикали. Текст будет изменен для повышения читаемости на целевом устройстве, но поскольку метрики будут зависеть от целевого размера текста, позиции глифов, переводы строк и другие типографические детали не будут масштабироваться, что означает, что разметка текста может выглядеть по-разному на устройствах с разной плотностью пикселей.

Text { text: "Hello"; renderType: Text.NativeRendering; font.hintingPreference: Font.PreferVerticalHinting }

Это свойство было добавлено в Qt 5.8.

font.italic : bool

Устанавливает, имеет ли шрифт курсивный стиль.

font.kerning : bool

Включает или выключает функцию кернинга OpenType при форматировании текста. Выключение может улучшить производительность при создании или изменении текста за счет некоторых косметических функций. Значение по умолчанию — true.

Text { text: "OATS FLAVOUR WAY"; font.kerning: false }

Это свойство было добавлено в Qt 5.10.

font.letterSpacing : real

Устанавливает интерлиньяж для шрифта.

Изменение интерлиньяжа изменяет стандартное расстояние между отдельными буквами в шрифте. Положительное значение увеличивает интерлиньяж на соответствующее количество пикселей; отрицательное значение уменьшает интерлиньяж.

font.pixelSize : int

Устанавливает размер шрифта в пикселях.

Использование этой функции делает шрифт зависимым от устройства. Используйте pointSize для установки размера шрифта независимо от устройства.

font.pointSize : real

Устанавливает размер шрифта в пунктах. Размер шрифта должен быть больше нуля.

font.preferShaping : bool

Иногда шрифт применяет сложные правила к набору символов, чтобы отобразить их правильно. В некоторых письменных системах, таких как брахмические письмена, это необходимо для читаемости текста, но, например, в латинском письме это просто косметическая функция. Установка свойства preferShaping в значение false отключит все такие функции, когда они не требуются, что в большинстве случаев повысит производительность.

Значение по умолчанию — true.

Text { text: "Some text"; font.preferShaping: false }

Это свойство было добавлено в Qt 5.10.

font.strikeout : bool

Устанавливает, имеет ли шрифт стиль зачеркивания.

font.styleName : string

Устанавливает имя стиля шрифта.

Имя стиля не чувствительно к регистру. При установке шрифт будет сопоставляться с именем стиля вместо свойств шрифта font.weight, font.bold и font.italic.

Это свойство было добавлено в Qt 5.6.

font.underline : bool

Устанавливает, подчеркнут ли текст.

font.weight : enumeration

Устанавливает вес шрифта.

Вес может быть одним из следующих:

Font.Thin
Font.Light
Font.ExtraLight
Font.Normal — значение по умолчанию
Font.Medium
Font.DemiBold
Font.Bold
Font.ExtraBold
Font.Black

Text { text: "Hello"; font.weight: Font.DemiBold }

font.wordSpacing : real

Устанавливает межсловный интервал для шрифта.

Изменение межсловного интервала изменяет стандартное расстояние между отдельными словами. Положительное значение увеличивает межсловный интервал на соответствующее количество пикселей, а отрицательное значение уменьшает расстояние между словами.

fontInfo.bold : bool

Состояние жирности информации о шрифте, которая была решена для текущего шрифта и fontSizeMode. Это значение true, если вес решенного шрифта — полужирный или выше.