Тип QML Текст
Определяет способ добавления форматированного текста в сцену. Подробнее...
| Заявление об импорте: | import QtQuick 2.1 |
| Наследует: |
Свойства
- advance : size
- antialiasing : bool
- baseUrl : url
- bottomPadding : real
- clip : bool
- цвет : цвет
- высота_содержимого : real
- ширина_содержимого : real
- эффективное_горизонтальное_выравнивание : перечисление
- elide : перечисление
- шрифт.жирный : bool
- шрифт.регистр : перечисление
- шрифт.семейство : строка
- шрифт.предпочтение_подсказки : перечисление
- шрифт.курсив : bool
- шрифт.кернинг : bool
- шрифт.пробел_между_буквами : real
- шрифт.размер_в_пикселях : int
- шрифт.размер_в_пунктах : real
- шрифт.предпочитать_оформлениe : bool
- шрифт.зачеркнутый : bool
- шрифт.стиль_названия : строка
- шрифт.подчеркнутый : bool
- шрифт.вес : int
- шрифт.пробел_между_словами : real
- fontInfo.жирный : bool
- fontInfo.семейство : строка
- fontInfo.курсив : bool
- fontInfo.размер_в_пикселях : строка
- fontInfo.размер_в_пунктах : real
- fontInfo.стиль_названия : строка
- fontInfo.вес : int
- fontSizeMode : перечисление
- горизонтальное_выравнивание : перечисление
- подсвеченная_ссылка : строка
- левый_отступ : real
- количество_строк : int
- высота_строки : real
- lineHeightMode : перечисление
- цвет_ссылки : цвет
- максимальное_количество_строк : int
- минимальный_размер_в_пикселях : int
- минимальный_размер_в_пунктах : int
- отступ : real
- тип_рендеринга : перечисление
- качество_рендеринга : int
- правый_отступ : real
- стиль : перечисление
- цвет_стиля : цвет
- текст : строка
- формат_текста : перечисление
- верхний_отступ : real
- обрезанный : bool
- вертикальное_выравнивание : перечисление
- режим_переноса : перечисление
Сигналы
- lineLaidOut(объект линия)
- ссылка_активирована(строка ссылка)
- ссылка_подсвечена(строка ссылка)
Методы
- forceLayout()
- ссылка_в_точке(вещественное 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.
См. также пример шрифтов.
Документация по свойствам
[since 5.6] bottomPadding : real
Эти свойства содержат отступы вокруг содержимого. Это пространство зарезервировано в дополнение к contentWidth и contentHeight.
Это свойство QML было введено в 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.
[since 5.10] advance : size
Расстояние в пикселях от начала базовой линии первого символа элемента текста до начала базовой линии первого символа в элементе текста, непосредственно следующего за этим в текстовом потоке.
Обратите внимание, что advance может быть отрицательным, если текст идёт справа налево.
Это свойство было введено в Qt 5.10.
antialiasing : 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 : цвет
Цвет текста.
Пример зеленого текста, определенного с использованием шестнадцатеричной нотации:
Text {
color: "#00FF00"
text: "green text"
} Пример стального синего текста, определенного с использованием имени цвета SVG:
Text {
color: "steelblue"
text: "blue text"
} contentHeight : вещественное
Возвращает высоту текста, включая высоту, превышающую высоту, покрытую из-за того, что текста больше, чем помещается в заданную высоту.
contentWidth : вещественное
Возвращает ширину текста, включая ширину, превышающую ширину, покрытую из-за недостаточного обтекания, если WrapMode установлен.
elide : перечисление
Установите этот параметр для обрезания частей текста, соответствующих ширине элемента Text. Текст будет обрезан только в случае, если была явно задана ширина.
Этот параметр нельзя использовать с форматированным текстом.
Обрезка может быть:
- Text.ElideNone — значение по умолчанию
- Text.ElideLeft
- Text.ElideMiddle
- Text.ElideRight
Если этот параметр установлен в Text.ElideRight, он может использоваться с обтеканием текста. Текст будет обрезан только в случае, если maximumLineCount, или height установлено. Если оба maximumLineCount и height установлены, maximumLineCount будет применено, если строки не помещаются в разрешенную высоту.
Если текст является строкой многократной длины, а режим не Text.ElideNone, будет использована первая строка, которая помещается, в противном случае будет обрезана последняя.
Строки многократной длины упорядочены от самой длинной до самой короткой, разделенные символом Unicode «Терминатор строки» U009C (напишите это в QML с помощью "\u009C" или "\x9C").
font.bold : bool
Устанавливает, является ли начертание шрифта полужирным.
font.capitalization : перечисление
Устанавливает регистр текста.
- Font.MixedCase — это обычный вариант отображения текста, где изменение регистра не применяется.
- Font.AllUppercase — изменяет текст, отображая его в верхнем регистре.
- Font.AllLowercase — изменяет текст, отображая его в нижнем регистре.
- Font.SmallCaps — изменяет текст, отображая его в малых прописных буквах.
- Font.Capitalize — изменяет текст, отображая первую букву каждого слова как прописную.
Text { text: "Hello"; font.capitalization: Font.AllLowercase } font.family : строка
Устанавливает семейство шрифта.
Имя семейства не учитывает регистр и может необязательно включать имя производителя, например, «Helvetica [Cronyx]». Если семейство доступно от нескольких производителей, а производитель не указан, произвольно выбирается производитель. Если семейство недоступно, будет установлено семейство с помощью алгоритма подбора шрифтов.
[since 5.8] font.hintingPreference : перечисление
Устанавливает предпочтительный стиль выравнивания текста. Это подсказка для подсистемы отображения текста, чтобы использовать определенный уровень выравнивания, и поддержка различается в разных платформах. Более подробную информацию см. в таблице в документации для 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
Устанавливает, имеет ли шрифт курсивный стиль.
[since 5.10] font.kerning : bool
Включает или отключает функцию кернинга OpenType при форматировании текста. Отключение может улучшить производительность при создании или изменении текста за счёт некоторых косметических функций. Значение по умолчанию — true.
Text { text: "OATS FLAVOUR WAY"; font.kerning: false } Этот параметр был введен в Qt 5.10.
font.letterSpacing : вещественное
Устанавливает интерлиньяж для шрифта.
Изменение интерлиньяжа изменяет стандартное расстояние между отдельными буквами в шрифте. Положительное значение увеличивает интерлиньяж на соответствующее количество пикселей; отрицательное значение уменьшает интерлиньяж.
font.pixelSize : целое
Устанавливает размер шрифта в пикселях.
Использование этого метода делает шрифт зависимым от устройства. Используйте pointSize для установки размера шрифта независимо от устройства.
font.pointSize : вещественное
Устанавливает размер шрифта в пунктах. Размер в пунктах должен быть больше нуля.
[since 5.10] font.preferShaping : bool
Иногда шрифт применяет сложные правила к набору символов для их правильного отображения. В некоторых системах письма, таких как брахмические, это необходимо для читабельности текста, но в, например, латинском письме это просто косметическая функция. Установка параметра preferShaping в значение false отключит все такие функции, когда они не требуются, что в большинстве случаев улучшит производительность.
Значение по умолчанию — true.
Text { text: "Some text"; font.preferShaping: false } Этот параметр был введен в Qt 5.10.
font.strikeout : bool
Устанавливает, имеет ли шрифт стиль зачёркивания.
[since 5.6] font.styleName : строка
Устанавливает имя стиля шрифта.
Имя стиля не учитывает регистр. Если задано, шрифт будет сопоставляться с именем стиля вместо свойств шрифта font.weight, font.bold и font.italic.
Этот параметр был введен в Qt 5.6.
font.underline : bool
Устанавливает, подчеркнут ли текст.
font.weight : целое
Запрашиваемая толщина шрифта. Запрашиваемая толщина должна быть целым числом от 1 до 1000 или одним из предопределённых значений:
- 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 : вещественное
Устанавливает интерлиньяж для шрифта.
Интерлиньяж изменяет стандартное расстояние между отдельными словами. Положительное значение увеличивает расстояние между словами на соответствующую величину в пикселях, а отрицательное значение уменьшает это расстояние.
[since 5.9] fontInfo.bold : bool
Жирное состояние шрифта, которое было решено для текущего шрифта и fontSizeMode. Это истинно, если вес решенного шрифта является жирным или выше.
Это свойство было введено в Qt 5.9.
[since 5.9] fontInfo.family : строка
Имя семейства шрифта, которое было решено для текущего шрифта и fontSizeMode.
Это свойство было введено в Qt 5.9.
[since 5.9] fontInfo.italic : логическое
Состояние наклона шрифта в информации о шрифте, которая была решена для текущего шрифта и fontSizeMode.
Это свойство было введено в Qt 5.9.
[since 5.9] fontInfo.pixelSize : строка
Размер пикселей в информации о шрифте, которая была решена для текущего шрифта и fontSizeMode.
Это свойство было введено в Qt 5.9.
[since 5.9] fontInfo.pointSize : вещественный
pointSize информации о шрифте, которая была решена для текущего шрифта и fontSizeMode.
Это свойство было введено в Qt 5.9.
[since 5.9] fontInfo.styleName : строка
Имя стиля в информации о шрифте, которое было решено для текущего шрифта и fontSizeMode.
Это свойство было введено в Qt 5.9.
[since 5.9] fontInfo.weight : целое
Вес информации о шрифте, которая была решена для текущего шрифта и fontSizeMode.
Это свойство было введено в Qt 5.9.
fontSizeMode : перечисление
Это свойство определяет, как определяется размер шрифта отображаемого текста. Возможные значения:
- Text.FixedSize (по умолчанию) - Используется размер, заданный font.pixelSize или font.pointSize.
- Text.HorizontalFit - Используется наибольший размер до указанного, который помещается в ширину элемента без перевода на следующую строку.
- Text.VerticalFit - Используется наибольший размер до указанного, который помещается по высоте элемента.
- Text.Fit - Используется наибольший размер до указанного, который помещается по ширине и высоте элемента.
Размер шрифта для текста с подгонкой имеет минимальное значение, заданное свойством minimumPointSize или minimumPixelSize, и максимальное значение, заданное либо свойством font.pointSize, либо font.pixelSize.
Text { text: "Hello"; fontSizeMode: Text.Fit; minimumPixelSize: 10; font.pixelSize: 72 } Если текст не помещается в границы элемента с минимальным размером шрифта, текст будет усечен в соответствии со свойством elide.
Если свойство textFormat установлено в Text.RichText, это не повлияет, так как свойство будет полностью проигнорировано. Если textFormat установлено в Text.StyledText, тогда свойство будет учтено, при условии, что в тексте нет тегов размера шрифта. Если теги размера шрифта присутствуют, свойство всё ещё будет учитывать их. Это может привести к тому, что свойство fontSizeMode не будет полностью соблюдаться.
[since 5.2] hoveredLink : строка
Это свойство содержит строку ссылки, когда пользователь наводит указатель мыши на ссылку, встроенную в текст. Ссылка должна быть в формате форматированного или HTML-текста, и строка hoveredLink предоставляет доступ к конкретной ссылке.
Это свойство было введено в Qt 5.2.
См. также linkHovered и linkAt().
lineCount : целое
Возвращает количество видимых строк в элементе текста.
Это свойство не поддерживается для форматированного текста.
См. также maximumLineCount.
lineHeight : вещественный
Устанавливает высоту строки для текста. Значение может быть в пикселях или множителем в зависимости от lineHeightMode.
Значение по умолчанию равно множителю 1,0. Высота строки должна быть положительной.
lineHeightMode : перечисление
Это свойство определяет, как задаётся высота строки. Возможные значения:
- Text.ProportionalHeight (по умолчанию) - это устанавливает интервал пропорционально строке (в виде множителя). Например, установите в 2 для двойного интервала.
- Text.FixedHeight - это устанавливает высоту строки в фиксированное значение (в пикселях).
linkColor : цвет
Цвет ссылок в тексте.
Это свойство работает с форматированным текстом StyledText textFormat, но не с RichText. Цвет ссылки в RichText может быть задан путём включения тегов стилей CSS в текст.
maximumLineCount : целое
Установите это свойство, чтобы ограничить количество строк, которое будет отображать элемент текста. Если elide установлено в Text.ElideRight, текст будет усечен соответствующим образом. По умолчанию это значение наибольшего возможного целого числа.
Это свойство не поддерживается для форматированного текста.
minimumPixelSize : целое
Это свойство задаёт минимальный размер шрифта в пикселях текста, масштабированного свойством fontSizeMode.
Если fontSizeMode равен Text.FixedSize или font.pixelSize равен -1, это свойство игнорируется.
minimumPointSize : целое
Это свойство задаёт минимальный размер шрифта в пунктах текста, масштабированного свойством fontSizeMode.
Если fontSizeMode равен Text.FixedSize или font.pointSize равен -1, это свойство игнорируется.
renderType : перечисление
Переопределяет тип рендеринга по умолчанию для этого компонента.
Поддерживаемые типы рендеринга:
- Text.QtRendering
- Text.NativeRendering
Выберите Text.NativeRendering, если вы предпочитаете, чтобы текст выглядел как нативной платформе и не требуете расширенных функций, таких как преобразование текста. Использование таких функций в сочетании с типом рендеринга NativeRendering даст плохие и иногда пикселизованные результаты.
Тип рендеринга по умолчанию определяется QQuickWindow::textRenderType().
renderTypeQuality : целое
Переопределяет качество типа рендеринга по умолчанию для этого компонента. Это низкоуровневая настройка, которую можно игнорировать в большинстве случаев. В настоящее время она влияет только тогда, когда renderType равно Text.QtRendering.
Алгоритм растризации, используемый Text.QtRendering, может давать артефакты при больших размерах текста, такие как резкие углы, выглядящие более закруглёнными, чем они должны быть. Если это проблема для конкретных элементов текста, увеличьте renderTypeQuality для улучшения качества рендеринга, за счёт увеличения потребления памяти.
renderTypeQuality может быть любым целым числом больше 0 или одним из следующих предопределённых значений
- Text.DefaultRenderTypeQuality (по умолчанию) = -1
- Text.LowRenderTypeQuality = 26
- Text.NormalRenderTypeQuality = 52
- Text.HighRenderTypeQuality = 104
- Text.VeryHighRenderTypeQuality = 208
style : перечисление
Установите дополнительный стиль текста.
Поддерживаемые стили текста:
- Text.Normal - значение по умолчанию
- Text.Outline
- Text.Raised
- Text.Sunken
Row {
Text { font.pointSize: 24; text: "Normal" }
Text { font.pointSize: 24; text: "Raised"; style: Text.Raised; styleColor: "#AAAAAA" }
Text { font.pointSize: 24; text: "Outline";style: Text.Outline; styleColor: "red" }
Text { font.pointSize: 24; text: "Sunken"; style: Text.Sunken; styleColor: "#AAAAAA" }
} styleColor : цвет
Определяет вторичный цвет, используемый стилями текста.
styleColor используется как цвет контура для контурного текста, и как цвет тени для поднятого или вдавленного текста. Если стиль не задан, он не используется вообще.
Text { font.pointSize: 18; text: "hello"; style: Text.Raised; styleColor: "gray" } См. также style.
text : строка
Текст для отображения. Текст поддерживает как обычные, так и форматированные строки текста.
Элемент попытается автоматически определить, должен ли текст обрабатываться как форматированный текст. Это определение выполняется с помощью Qt::mightBeRichText(). Однако, распознавание Markdown не является автоматическим.
См. также textFormat.
textFormat : перечисление
Способ отображения свойства text.
Поддерживаемые форматы текста:
| Константа | Описание |
|---|---|
Text.AutoText |
(по умолчанию) определено с помощью эвристики Qt::mightBeRichText() |
Text.PlainText |
все теги стилей обрабатываются как обычный текст |
Text.StyledText |
оптимизированный базовый форматированный текст, как в HTML 3.2 |
Text.RichText |
подмножество HTML 4 |
Text.MarkdownText |
CommonMark плюс расширения GitHub для таблиц и задач (с версии 5.14) |
Если формат текста Text.AutoText, элемент Text автоматически определит, следует ли обрабатывать текст как форматированный текст. Это определение выполняется с помощью Qt::mightBeRichText(), который может обнаружить присутствие тега HTML в первой строке текста, но не может отличить Markdown от простого текста.
Text.StyledText — это оптимизированный формат, поддерживающий некоторые базовые теги форматирования текста в стиле HTML 3.2:
<b></b> - bold <del></del> - strike out (removed content) <s></s> - strike out (no longer accurate or no longer relevant content) <strong></strong> - bold <i></i> - italic <br> - new line <p> - paragraph <u> - underlined text <font color="color_name" size="1-7"></font> <h1> to <h6> - headers <a href=""> - anchor <img src="" align="top,middle,bottom" width="" height=""> - inline images <ol type="">, <ul type=""> and <li> - ordered and unordered lists <pre></pre> - preformatted > < &
Text.StyledText парсер является строгим, требуя правильного вложенности тегов.
Column {
Text {
font.pointSize: 24
text: "<b>Hello</b> <i>World!</i>"
}
Text {
font.pointSize: 24
textFormat: Text.RichText
text: "<b>Hello</b> <i>World!</i>"
}
Text {
font.pointSize: 24
textFormat: Text.PlainText
text: "<b>Hello</b> <i>World!</i>"
}
Text {
font.pointSize: 24
textFormat: Text.MarkdownText
text: "**Hello** *World!*"
}
} |
Text.RichText поддерживает большее подмножество HTML 4, как описано на странице Поддерживаемое подмножество HTML. Рекомендуется использовать Text.PlainText, Text.StyledText или Text.MarkdownText вместо него, так как они обеспечивают лучшую производительность.
Примечание: При использовании Text.MarkdownText и поддерживаемого подмножества HTML некоторые декоративные элементы не будут отображаться так же, как в веб-браузере:
- блоки кода используют шрифт по умолчанию с фиксированным интервалом, но без обрамляющей выделенной рамки
- блоки цитирования отступлены, но без вертикальной линии рядом с цитатой
- горизонтальные линии не отображаются
truncated : bool
Возвращает true, если текст был усечён из-за maximumLineCount или elide.
Это свойство не поддерживается для форматированного текста.
См. также maximumLineCount и elide.
wrapMode : перечисление
Установите это свойство для переноса текста по ширине элемента Text. Текст будет переноситься только при явном задании ширины. wrapMode может принимать следующие значения:
- Text.NoWrap (по умолчанию) - перенос не будет выполнен. Если текст содержит недостаточно символов новой строки, contentWidth превысит заданную ширину.
- Text.WordWrap - перенос осуществляется только по границам слов. Если слово слишком длинное, contentWidth превысит заданную ширину.
- Text.WrapAnywhere - перенос осуществляется в любой точке строки, даже если он происходит посреди слова.
- Text.Wrap - если возможно, перенос происходит по границам слов; в противном случае он произойдёт в соответствующей точке строки, даже посреди слова.
Документация по сигналам
lineLaidOut(объект строка)
Этот сигнал излучается для каждой строки текста, которая размещается во время процесса компоновки в режиме обычного или форматированного текста. Он не излучается в режиме форматированного текста. Указанный объект строка предоставляет больше подробностей о текущей строке, которая размещается.
Это предоставляет возможность позиционирования и изменения размера строки во время её размещения. Например, это можно использовать для создания столбцов или размещения текста вокруг объектов.
Свойства указанного объекта строка:
| Имя свойства | Описание |
|---|---|
| номер (только для чтения) | Номер строки, начинается с нуля. |
| x | Указывает положение x строки внутри элемента Text. |
| y | Указывает положение y строки внутри элемента Text. |
| width | Указывает ширину строки. |
| height | Указывает высоту строки. |
| implicitWidth (только для чтения) | Ширина, которую строка естественным образом занимает на основе своего содержимого, не учитывая какие-либо изменения, внесённые в свойство width. |
| isLast (только для чтения) | Является ли строка последней. Это свойство может измениться, если вы измените свойство width на другое значение. |
Например, это сместит первые 5 строк элемента Text на 100 пикселей вправо:
onLineLaidOut: (line)=> {
if (line.number < 5) {
line.x = line.x + 100
line.width = line.width - 100
}
} Следующий пример позволит вам разместить элемент в конце последней строки:
onLineLaidOut: (line)=> {
if (line.isLast) {
lastLineMarker.x = line.x + line.implicitWidth
lastLineMarker.y = line.y + (line.height - lastLineMarker.height) / 2
}
} Примечание: Соответствующий обработчик — onLineLaidOut.
linkActivated(строка ссылка)
Этот сигнал излучается, когда пользователь нажимает на ссылку, встроенную в текст. Ссылка должна быть в формате форматированного текста или HTML, и строка ссылка предоставляет доступ к конкретной ссылке.
Text {
textFormat: Text.RichText
text: "See the <a href=\"http://qt-project.org\">Qt Project website</a>."
onLinkActivated: (link)=> console.log(link + " link activated")
} Пример кода отобразит текст «Посетите сайт Qt Project».
Нажатие на выделенную ссылку выведет http://qt-project.org link activated в консоль.
Примечание: Соответствующий обработчик — onLinkActivated.
linkHovered(строка ссылка)
Этот сигнал излучается, когда пользователь наводит указатель мыши на ссылку, встроенную в текст. Ссылка должна быть в формате форматированного текста или HTML, и строка ссылка предоставляет доступ к конкретной ссылке.
Примечание: Соответствующий обработчик — onLinkHovered.
Этот сигнал был представлен в Qt 5.2.
См. также hoveredLink и linkAt().
Документация по методам
forceLayout()
Вызывает повторную компоновку отображаемого текста.
Этот метод был представлен в Qt 5.9.
linkAt(вещественное x, вещественное y)
Возвращает строку ссылки в точке x, y в координатах содержимого, или пустую строку, если в этой точке нет ссылки.
Этот метод был представлен в Qt 5.3.
См. также hoveredLink.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.1/qml-qtquick-text.html