Тип QML TextEdit
Отображает несколько строк редактируемого форматированного текста. Подробнее...
| Заявление об импорте: | import QtQuick 2.15 |
| Наследует: |
Свойства
- activeFocusOnPress : bool
- baseUrl : url
- bottomPadding : real
- canPaste : bool
- canRedo : bool
- canUndo : bool
- цвет : color
- высота_содержимого : real
- ширина_содержимого : real
- cursorDelegate : Компонент
- позиция_курсора : int
- прямоугольник_курсора : прямоугольник
- видимость_курсора : bool
- эффективное_горизонтальное_выравнивание : перечисление
- шрифт.жирный : bool
- шрифт.заглавные_буквы : перечисление
- шрифт.семейство : строка
- шрифт.предпочтение_распознавания : перечисление
- шрифт.курсив : bool
- шрифт.кернинг : bool
- шрифт.пробелы_между_буквами : real
- шрифт.размер_пикселей : int
- шрифт.размер_пунктов : real
- шрифт.предпочитать_формирование : bool
- шрифт.зачеркнутый : bool
- шрифт.имя_стиля : строка
- шрифт.подчеркнутый : bool
- шрифт.жирность : перечисление
- шрифт.пробелы_между_словами : real
- горизонтальное_выравнивание : перечисление
- подсвеченный_ссылка : строка
- ввод_метод_составление : bool
- подсказки_метода_ввода : перечисление
- отступ_слева : real
- длина : int
- количество_строк : int
- режим_выбора_мышью : перечисление
- режим_перезаписи : bool
- отступ : real
- постоянный_выбор : bool
- предварительный_текст : строка
- только_чтение : bool
- тип_рендеринга : перечисление
- отступ_справа : real
- выбор_клавиатурой : bool
- выбор_мышью : bool
- выделенный_текст : строка
- цвет_выделенного_текста : цвет
- цвет_выделения : цвет
- конец_выделения : int
- начало_выделения : int
- расстояние_табуляции : real
- текст : строка
- документ_текста : Текстовый_документ
- формат_текста : перечисление
- отступ_текста : real
- отступ_сверху : real
- вертикальное_выравнивание : перечисление
- режим_обрезки : перечисление
Сигналы
- editingFinished()
- linkActivated(строка ссылка)
- linkHovered(строка ссылка)
Методы
- void добавить(строка текст)
- очистить()
- скопировать()
- вырезать()
- отменить_выбор()
- строка получить_форматированный_текст(int начало, int конец)
- строка получить_текст(int начало, int конец)
- вставить(int позиция, строка текст)
- является_справа_налево(int начало, int конец)
- ссылка_в_позиции(real x, real y)
- переместить_выбор_курсора(int позиция, SelectionMode режим)
- вставить_из_буфера_обмена()
- int позиция_в_точке(int x, int y)
- прямоугольник преобразовать_позицию_в_прямоугольник(позиция)
- повторить()
- строка удалить(int начало, int конец)
- выбрать(int начало, int конец)
- выделить_все()
- выделить_слово()
- отменить()
Подробное описание
Элемент TextEdit отображает блок редактируемого форматированного текста.
Он может отображать как обычный, так и форматированный текст. Например:
TextEdit {
width: 240
text: "<b>Hello</b> <i>World!</i>"
font.family: "Helvetica"
font.pointSize: 20
color: "blue"
focus: true
}
Установка focus на true позволяет элементу TextEdit получать фокус клавиатуры.
Обратите внимание, что TextEdit не реализует прокрутку, слежение за курсором или другие поведения, специфичные для внешнего вида. Например, для добавления прокрутки с flickable, которая следует за курсором:
Flickable {
id: flick
width: 300; height: 200;
contentWidth: edit.paintedWidth
contentHeight: edit.paintedHeight
clip: true
function ensureVisible(r)
{
if (contentX >= r.x)
contentX = r.x;
else if (contentX+width <= r.x+r.width)
contentX = r.x+r.width-width;
if (contentY >= r.y)
contentY = r.y;
else if (contentY+height <= r.y+r.height)
contentY = r.y+r.height-height;
}
TextEdit {
id: edit
width: flick.width
focus: true
wrapMode: TextEdit.Wrap
onCursorRectangleChanged: flick.ensureVisible(cursorRectangle)
}
} Конкретный внешний вид может использовать плавную прокрутку (например, с помощью SmoothedAnimation), может иметь видимую полосу прокрутки или полосу прокрутки, которая появляется и исчезает, чтобы показать местоположение и т. д.
Поддержка буфера обмена обеспечивается функциями cut(), copy() и paste(), а выбор можно обрабатывать по традиционной схеме "мышью", задав selectByMouse, или полностью из QML, манипулируя selectionStart и selectionEnd, или используя selectAll() или selectWord().
Вы можете переводить координаты курсора (символы с начала документа) в пиксельные точки, используя positionAt() и positionToRectangle().
Документация по свойствам
bottomPadding : вещественное
Эти свойства задают отступы вокруг содержимого. Это пространство резервируется в дополнение к contentWidth и contentHeight.
Это свойство QML было добавлено в Qt 5.6.
effectiveHorizontalAlignment : перечисление
Устанавливает горизонтальное и вертикальное выравнивание текста в пределах ширины и высоты элемента TextEdit. По умолчанию выравнивание текста соответствует естественному выравниванию, например, текст, который читается слева направо, выравнивается слева.
Допустимые значения для horizontalAlignment:
Допустимые значения для verticalAlignment:
При использовании присоединённого свойства LayoutMirroring::enabled для отражения макетов приложения, горизонтальное выравнивание текста также будет отражаться. Однако свойство horizontalAlignment останется без изменений. Для запроса эффективного горизонтального выравнивания TextEdit используйте только для чтения свойство effectiveHorizontalAlignment.
activeFocusOnPress : логический
Определяет, должен ли TextEdit получить активный фокус при нажатии мыши. По умолчанию это значение равно true.
baseUrl : url
Это свойство задаёт базовый URL-адрес, используемый для разрешения относительных URL-адресов в тексте.
Значение по умолчанию — URL-адрес файла QML, который инициализирует элемент TextEdit.
canPaste : логический
Возвращает true, если TextEdit доступен для записи и содержимое буфера обмена подходит для вставки в TextEdit.
canRedo : логический
Возвращает true, если TextEdit доступен для записи и имеются отменённые операции, которые можно повторить.
canUndo : логический
Возвращает true, если TextEdit доступен для записи и имеются предыдущие операции, которые можно отменить.
color : цвет
Цвет текста.
// green text using hexadecimal notation
TextEdit { color: "#00FF00" } // steelblue text using SVG color name
TextEdit { color: "steelblue" } contentHeight : вещественное
Возвращает высоту текста, включая высоту, выходящую за пределы заданной высоты, если текст не помещается в заданную высоту.
contentWidth : вещественное
Возвращает ширину текста, включая ширину, выходящую за пределы заданной ширины из-за недостаточного обрезания, если свойство wrapMode установлено.
cursorDelegate : Компонент
Делегат курсора в TextEdit.
Если вы задаёте cursorDelegate для TextEdit, этот делегат будет использоваться для рисования курсора вместо стандартного курсора. Экземпляр делегата будет создан и управляется текстовым полем при необходимости отображения курсора, а свойства x и y экземпляра делегата будут установлены так, чтобы находиться на один пиксель перед левым верхним углом текущего символа.
Обратите внимание, что корневой элемент компонента делегата должен быть QQuickItem или производным от QQuickItem элементом.
cursorPosition : целое
Положение курсора в TextEdit.
cursorRectangle : прямоугольник
Прямоугольник, в котором отображается стандартный текстовый курсор в пределах текстового поля. Только для чтения.
Положение и высота настраиваемого cursorDelegate обновляются автоматически, чтобы следовать за cursorRectangle при его изменении. Ширина делегата не изменяется при изменении прямоугольника курсора.
cursorVisible : логический
Если true, текстовое поле отображает курсор.
Это свойство устанавливается и сбрасывается при получении текстовым полем активного фокуса, но его также можно установить непосредственно (полезно, например, если KeyProxy может пересылать в него клавиши).
font.bold : логический
Устанавливает, является ли начертание шрифта полужирным.
font.capitalization : перечисление
Устанавливает регистр текста.
- Font.MixedCase - это обычный вариант отображения текста, при котором изменение регистра не применяется.
- Font.AllUppercase - это изменяет текст на все заглавные буквы.
- Font.AllLowercase - это изменяет текст на все строчные буквы.
- Font.SmallCaps - это изменяет текст на полужирный шрифт.
- Font.Capitalize - это изменяет текст, при этом первая буква каждого слова отображается как заглавная.
TextEdit { text: "Hello"; font.capitalization: Font.AllLowercase } font.family : строка
Устанавливает имя семейства шрифта.
Имя семейства не зависит от регистра и может необязательно включать имя типографии, например, "Helvetica [Cronyx]". Если семейство доступно от более чем одной типографии, и типография не указана, выбирается произвольная типография. Если семейство недоступно, семейство будет установлено с помощью алгоритма подбора шрифтов.
font.hintingPreference : перечисление
Устанавливает предпочтительное начертание текста. Это подсказка для базовой системы отображения текста, использующая определенный уровень начертания, и поддержка её варьируется в зависимости от платформ. Дополнительные сведения см. в таблице в документации для QFont::HintingPreference.
Примечание: Это свойство имеет эффект только при использовании вместе с типом рендеринга TextEdit.NativeRendering.
Font.PreferDefaultHinting - Используйте уровень начертания по умолчанию для целевой платформы.
Font.PreferNoHinting - Если возможно, отображайте текст без начертания контуров глифов. Макет текста будет типографически точным, используя те же метрики, которые используются, например, при печати.
Font.PreferVerticalHinting - Если возможно, отображайте текст без горизонтального начертания, но выравнивайте глифы к пиксельной сетке в вертикальном направлении. Текст будет казаться чётче на дисплеях, где плотность слишком низка для точного отображения глифов. Но поскольку горизонтальные метрики глифов не начертаны, макет текста будет масштабироваться до устройств с более высокой плотностью (например, принтеров) без влияния на такие детали, как перенос строк.
Font.PreferFullHinting - Если возможно, отображайте текст с начертанием как в горизонтальном, так и в вертикальном направлениях. Текст будет изменён для повышения удобочитаемости на целевом устройстве, но поскольку метрики будут зависеть от целевого размера текста, позиции глифов, переноса строк и других типографических деталей не будут масштабироваться, что означает, что макет текста может выглядеть по-разному на устройствах с различной плотностью пикселей.
TextEdit { text: "Hello"; renderType: TextEdit.NativeRendering; font.hintingPreference: Font.PreferVerticalHinting } Это свойство было добавлено в Qt 5.8.
font.italic : логический
Устанавливает, имеет ли шрифт курсивный стиль.
font.kerning : логический
Включает или выключает функцию кернинга OpenType при формировании текста. Отключение этого может улучшить производительность при создании или изменении текста, за счет некоторых косметических функций. Значение по умолчанию равно true.
TextEdit { text: "OATS FLAVOUR WAY"; kerning: font.false } Это свойство было добавлено в Qt 5.10.
font.letterSpacing : вещественное
Устанавливает интерлиньяж для шрифта.
Интерлиньяж изменяет стандартное расстояние между отдельными буквами в шрифте. Положительное значение увеличивает расстояние между буквами на соответствующие пиксели; отрицательное значение уменьшает расстояние.
font.pixelSize : целое
Устанавливает размер шрифта в пикселях.
Использование этой функции делает шрифт зависимым от устройства. Используйте TextEdit::font.pointSize для установки размера шрифта независимо от устройства.
font.pointSize : вещественное
Устанавливает размер шрифта в пунктах. Размер пункта должен быть больше нуля.
font.preferShaping : логический
Иногда шрифт применяет сложные правила к набору символов для правильного отображения. В некоторых системах письма, таких как брахмические скрипты, это необходимо для читаемости текста, но в, например, латинском шрифте это просто косметическая функция. Установка свойства preferShaping в значение false отключит все такие функции, когда они не нужны, что в большинстве случаев улучшит производительность.
Значение по умолчанию — true.
TextEdit { 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 : перечисление
Устанавливает вес шрифта.
Вес может быть одним из следующих:
- Font.Thin
- Font.Light
- Font.ExtraLight
- Font.Normal — значение по умолчанию
- Font.Medium
- Font.DemiBold
- Font.Bold
- Font.ExtraBold
- Font.Black
TextEdit { text: "Hello"; font.weight: Font.DemiBold } font.wordSpacing : real
Устанавливает интервалы между словами для шрифта.
Интервалы между словами изменяют стандартный интервал между отдельными словами. Положительное значение увеличивает интервал между словами на соответствующее количество пикселей, а отрицательное значение уменьшает интервал.
hoveredLink : string
Это свойство содержит строку ссылки, когда пользователь наводит указатель мыши на ссылку, встроенную в текст. Ссылка должна быть в формате rich text или HTML, а строка ссылки обеспечивает доступ к конкретной ссылке.
Это свойство было введено в Qt 5.2.
См. также linkHovered и linkAt().
inputMethodComposing : bool
Это свойство содержит значение, указывающее, имеет ли TextEdit частичный ввод текста от метода ввода.
В процессе составления метода ввода может полагаться на события мыши или клавиатуры от TextEdit для редактирования или подтверждения частичного текста. Это свойство можно использовать для определения момента отключения обработчиков событий, которые могут мешать корректной работе метода ввода.
inputMethodHints : перечисление
Предоставляет подсказки методу ввода о предполагаемом содержимом текстового поля и о том, как он должен работать.
Значение является битовым сочетанием флагов или Qt.ImhNone, если подсказки не установлены.
Флаги, изменяющие поведение:
- Qt.ImhHiddenText — Символы должны быть скрыты, как обычно используется при вводе паролей.
- Qt.ImhSensitiveData — Вводимый текст не должен храниться активным методом ввода в любом постоянном хранилище, таком как предсказательный словарь пользователей.
- Qt.ImhNoAutoUppercase — Метод ввода не должен пытаться автоматически переключаться на заглавные буквы при окончании предложения.
- Qt.ImhPreferNumbers — Предпочтительны числа (но не обязательно).
- Qt.ImhPreferUppercase — Предпочтительны заглавные буквы (но не обязательно).
- Qt.ImhPreferLowercase — Предпочтительны строчные буквы (но не обязательно).
- Qt.ImhNoPredictiveText — Не использовать предсказательный текст (т.е. поиск в словаре) во время ввода.
- Qt.ImhDate — Текстовый редактор работает как поле даты.
- Qt.ImhTime — Текстовый редактор работает как поле времени.
Флаги, ограничивающие ввод (исключительные флаги):
- Qt.ImhDigitsOnly — Разрешены только цифры.
- Qt.ImhFormattedNumbersOnly — Разрешен только ввод чисел. Это включает десятичную точку и знак минус.
- Qt.ImhUppercaseOnly — Разрешен только ввод заглавных букв.
- Qt.ImhLowercaseOnly — Разрешен только ввод строчных букв.
- Qt.ImhDialableCharactersOnly — Разрешены только символы, пригодные для набора номера телефона.
- Qt.ImhEmailCharactersOnly — Разрешены только символы, пригодные для адресов электронной почты.
- Qt.ImhUrlCharactersOnly — Разрешены только символы, пригодные для URL-адресов.
Маски:
- Qt.ImhExclusiveInputMask — Эта маска имеет ненулевое значение, если используются какие-либо исключительные флаги.
length : int
Возвращает общее количество символов обычного текста в элементе TextEdit.
Поскольку это число не включает разметку форматирования, оно может отличаться от длины строки, возвращаемой свойством text.
Это свойство может быть быстрее, чем запрос длины свойства text, так как оно не требует копирования или преобразования внутренних данных строки TextEdit.
lineCount : int
Возвращает общее количество строк в элементе TextEdit.
mouseSelectionMode : перечисление
Определяет, как текст должен выбираться с помощью мыши.
- TextEdit.SelectCharacters — Выбор обновляется отдельными символами. (По умолчанию)
- TextEdit.SelectWords — Выбор обновляется целыми словами.
Это свойство применяется только когда selectByMouse равно true.
overwriteMode : bool
Указывает, будет ли вводимый пользователем текст перезаписывать существующий.
Как и во многих текстовых редакторах, текстовое поле можно настроить на вставку или перезапись существующего текста новым введённым пользователем текстом.
Если это свойство равно true, существующий текст перезаписывается посимвольно новым текстом; в противном случае текст вставляется в позицию курсора, смещая существующий текст.
По умолчанию это свойство равно false (новый текст не перезаписывает существующий).
Это свойство было введено в Qt 5.8.
persistentSelection : bool
Указывает, должен ли TextEdit сохранять видимость выделения при потере активного фокуса на другой элемент сцены. По умолчанию это значение равно false.
[только для чтения] preeditText : string
Это свойство содержит частичный ввод текста от метода ввода.
Это свойство было введено в Qt 5.7.
readOnly : bool
Указывает, может ли пользователь взаимодействовать с элементом TextEdit. Если это свойство установлено в true, текст нельзя редактировать с помощью пользовательского взаимодействия.
По умолчанию это свойство равно false.
renderType : перечисление
Переопределить тип рендеринга по умолчанию для этого компонента.
Поддерживаемые типы рендеринга:
- Text.QtRendering
- Text.NativeRendering
Выберите Text.NativeRendering, если вы предпочитаете, чтобы текст выглядел родным для целевой платформы и не требуете расширенных функций, таких как преобразование текста. Использование таких функций в сочетании с типом рендеринга NativeRendering даст плохие, а иногда и размытые результаты.
Тип рендеринга по умолчанию определяется QQuickWindow::textRenderType().
selectByKeyboard : bool
По умолчанию равно true, если редактор разрешен для редактирования, и false, если только для чтения.
Если true, пользователь может использовать клавиатуру для выделения текста, даже если редактор только для чтения. Если false, пользователь не может использовать клавиатуру для выделения текста, даже если редактор разрешен для редактирования.
Это свойство было введено в Qt 5.1.
См. также readOnly.
selectByMouse : bool
По умолчанию равно false.
Если true, пользователь может использовать мышь для выделения текста специфическим для платформы способом. Обратите внимание, что на некоторых платформах это может быть неподходящее взаимодействие; это может конфликтовать с тем, как текст должен вести себя внутри Flickable, например.
selectedText : string
Это свойство только для чтения предоставляет текст, который в данный момент выделен в текстовом редакторе.
Это эквивалентно следующему фрагменту, но быстрее и проще в использовании.
//myTextEdit is the id of the TextEdit
myTextEdit.text.toString().substring(myTextEdit.selectionStart,
myTextEdit.selectionEnd); selectedTextColor : цвет
Цвет выделенного текста, используемый в выделениях.
selectionColor : цвет
Цвет выделения текста, используемый за выделениями.
selectionEnd : int
Позиция курсора после последнего символа в текущем выделении.
Это свойство только для чтения. Чтобы изменить выделение, используйте select(start,end), selectAll() или selectWord().
См. также selectionStart, cursorPosition и selectedText.
selectionStart : int
Положение курсора перед первой буквой текущего выделения.
Это свойство является только для чтения. Для изменения выделения используйте select(start,end), selectAll() или selectWord().
См. также selectionEnd, cursorPosition и selectedText.
tabStopDistance : real
Расстояние по умолчанию, в единицах устройства, между отступами табуляции.
Это свойство было введено в Qt 5.10.
См. также QTextOption::setTabStop().
text : string
Текст для отображения. Если формат текста AutoText, текстовое поле автоматически определит, следует ли обрабатывать текст как форматированный. Это определение выполняется с помощью Qt::mightBeRichText(). Однако обнаружение Markdown не является автоматическим.
Свойство text подходит в основном для установки начального содержимого и обработки изменений относительно небольшого текстового содержимого. Методы append(), insert() и remove() обеспечивают более точный контроль и значительно лучшую производительность при модификации, особенно большого форматированного текста.
См. также clear() и textFormat.
textDocument : TextDocument
Возвращает QQuickTextDocument этого TextEdit. Его можно использовать для реализации подсветки синтаксиса с помощью QSyntaxHighlighter.
Это свойство было введено в Qt 5.1.
См. также QQuickTextDocument.
textFormat : перечисление
Способ отображения свойства text.
Поддерживаемые форматы текста:
| Постоянная | Описание |
|---|---|
TextEdit.PlainText |
(по умолчанию) все теги форматирования обрабатываются как обычный текст |
TextEdit.AutoText |
обнаружено с помощью эвристики Qt::mightBeRichText() |
TextEdit.RichText |
подмножество HTML 4 |
TextEdit.MarkdownText |
CommonMark плюс расширения GitHub для таблиц и задач (с версии 5.14) |
По умолчанию TextEdit.PlainText. Если формат текста установлен в TextEdit.AutoText, текстовое поле автоматически определит, следует ли обрабатывать текст как форматированный. Это определение выполняется с помощью Qt::mightBeRichText(), который может обнаружить наличие тега HTML в первой строке текста, но не может отличить Markdown от простого текста.
Column {
TextEdit {
font.pointSize: 24
textFormat: TextEdit.AutoText
text: "<b>Hello</b> <i>World!</i>"
}
TextEdit {
font.pointSize: 24
textFormat: TextEdit.RichText
text: "<b>Hello</b> <i>World!</i>"
}
TextEdit {
font.pointSize: 24
textFormat: TextEdit.PlainText
text: "<b>Hello</b> <i>World!</i>"
}
TextEdit {
font.pointSize: 24
textFormat: TextEdit.MarkdownText
text: "**Hello** *World!*"
}
} |
С TextEdit.MarkdownText, флажки, полученные при использовании расширения GitHub checkbox extension, можно взаимодействовать.
Примечание: Взаимодействие с форматированием текста или Markdown не поддерживается.
Примечание: При использовании Text.MarkdownText, и с поддержкой подмножества HTML, некоторые декоративные элементы не отображаются так, как в веб-браузере:
- блоки кода используют шрифт по умолчанию с фиксированным интервалом, но без окружающей рамки
- блоки цитат отступают, но нет вертикальной линии рядом с цитатой
- горизонтальные линии не отображаются
textMargin : real
Отступ, в пикселях, вокруг текста в TextEdit.
wrapMode : перечисление
Установите это свойство для переноса текста по ширине элемента TextEdit. Текст будет переноситься только если явным образом задана ширина.
- TextEdit.NoWrap - перенос не будет выполнен. Если текст содержит недостаточно символов новой строки, то implicitWidth превысит заданную ширину.
- TextEdit.WordWrap - перенос выполняется только по границам слов. Если слово слишком длинное, implicitWidth превысит заданную ширину.
- TextEdit.WrapAnywhere - перенос выполняется в любом месте строки, даже если он находится в середине слова.
- TextEdit.Wrap - если это возможно, перенос выполняется по границам слов; в противном случае он будет выполнен в соответствующей точке строки, даже в середине слова.
По умолчанию TextEdit.NoWrap. Если вы задаете ширину, рассмотрите использование TextEdit.Wrap.
Документация по сигналам
editingFinished()
Этот сигнал генерируется, когда текстовое поле теряет фокус.
Примечание: Соответствующий обработчик — onEditingFinished.
Этот сигнал был введен в Qt 5.6.
linkActivated(string link)
Этот сигнал генерируется, когда пользователь нажимает на ссылку, встроенную в текст. Ссылка должна быть в формате форматированного текста или HTML, и строка link предоставляет доступ к конкретной ссылке.
Примечание: Соответствующий обработчик — onLinkActivated.
linkHovered(string link)
Этот сигнал генерируется, когда пользователь наводит курсор на ссылку, встроенную в текст. Ссылка должна быть в формате форматированного текста или HTML, и строка link предоставляет доступ к конкретной ссылке.
Примечание: Соответствующий обработчик — onLinkHovered.
Этот сигнал был введен в Qt 5.2.
См. также hoveredLink и linkAt().
Документация по методам
void append(string text)
Добавляет новый абзац с text в конец TextEdit.
Для добавления без вставки нового абзаца, используйте myTextEdit.insert(myTextEdit.length, text).
Этот метод был введен в Qt 5.2.
clear()
Очищает содержимое текстового поля и сбрасывает частичный ввод текста от метода ввода.
Используйте этот метод вместо установки свойства text в пустую строку.
Этот метод был введен в Qt 5.7.
См. также QInputMethod::reset().
copy()
Копирует выделенный текст в буфер обмена системы.
cut()
Перемещает выделенный текст в буфер обмена системы.
deselect()
Удаляет активное выделение текста.
string getFormattedText(int start, int end)
Возвращает фрагмент текста между позициями start и end.
Возвращаемый текст будет отформатирован в соответствии со свойством textFormat.
string getText(int start, int end)
Возвращает фрагмент текста между позициями start и end.
Возвращаемый текст не включает форматирование форматированного текста.
insert(int position, string text)
Вставляет text в TextEdit в позиции position.
isRightToLeft(int start, int end)
Возвращает true, если естественное направление чтения текста редактора между позициями start и end — справа налево.
Возвращает строку ссылки в точке x, y в координатах содержимого или пустую строку, если ссылки в этой точке нет.
Этот метод был введен в Qt 5.3.
См. также hoveredLink.
moveCursorSelection(int position, SelectionMode mode)
Перемещает курсор в позицию и обновляет выделение в соответствии с необязательным параметром режима. (Чтобы только переместить курсор, задайте свойство cursorPosition.)
При вызове этого метода дополнительно устанавливается либо selectionStart, либо selectionEnd (в зависимости от того, какое из них находилось в предыдущей позиции курсора) в указанную позицию. Это позволяет легко расширять и сокращать выделенный диапазон текста.
Режим выделения определяет, обновляется ли выделение по символам или по словам. Если не указано, режим выделения по умолчанию будет TextEdit.SelectCharacters.
- TextEdit.SelectCharacters - Устанавливает либо selectionStart, либо selectionEnd (в зависимости от того, какое из них находилось в предыдущей позиции курсора) в указанную позицию.
- TextEdit.SelectWords - Устанавливает selectionStart и selectionEnd так, чтобы включать все слова между указанной позицией и предыдущей позицией курсора. Слова, частично находящиеся в диапазоне, также включаются.
Например, рассмотрим такую последовательность вызовов:
cursorPosition = 5 moveCursorSelection(9, TextEdit.SelectCharacters) moveCursorSelection(7, TextEdit.SelectCharacters)
Это перемещает курсор в позицию 5, расширяет конец выделения с 5 до 9, а затем сокращает конец выделения с 9 до 7, оставляя выделенным текст с позиции 5 до 7 (6-й и 7-й символы).
Такая же последовательность с TextEdit.SelectWords расширит selectionStart до границы слова перед или на позиции 5 и расширит selectionEnd до границы слова на или после позиции 9.
paste()
Заменяет текущий выделенный текст содержимым системного буфера обмена.
Возвращает позицию текста, ближайшую к пиксельной позиции (x, y).
Позиция 0 находится перед первым символом, позиция 1 — после первого, но перед вторым и так далее до позиции text.length, которая находится после всех символов.
rectangle positionToRectangle(position)
Возвращает прямоугольник в заданной позиции в тексте. Свойства x, y и height соответствуют курсору, который бы описывал эту позицию.
redo()
Повторяет последнюю операцию, если повторение доступно.
string remove(int start, int end)
Удаляет фрагмент текста, расположенный между позициями start и end, из TextEdit.
Выделяет текст с позиции start до end.
Если либо start, либо end находятся вне диапазона, выделение не изменяется.
После вызова этого метода selectionStart станет меньшим, а selectionEnd — большим значением (независимо от порядка, переданного в этот метод).
См. также selectionStart и selectionEnd.
selectAll()
Выделяет весь текст.
selectWord()
Выделяет слово, ближайшее к текущей позиции курсора.
undo()
Отменяет последнюю операцию, если отмена доступна. Снимает выделение с любого текущего выделения и обновляет начало выделения до текущей позиции курсора.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.15/qml-qtquick-textedit.html