Тип QML TextEdit

Отображает несколько строк редактируемого форматированного текста. Подробнее...

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

Свойства

• activeFocusOnPress : bool
• baseUrl : url
• bottomPadding : real
• canPaste : bool
• canRedo : bool
• canUndo : bool
• цвет : цвет
• высота содержимого : real
• ширина содержимого : real
• делегат курсора : Компонент
• позиция курсора : int
• прямоугольник курсора : прямоугольник
• видимость курсора : bool
• эффективное выравнивание по горизонтали : перечисление
• шрифт.жирный : bool
• шрифт.заглавные буквы : перечисление
• шрифт.семейство : строка
• шрифт.предпочтение подстрочного выравнивания : перечисление
• шрифт.курсив : bool
• шрифт.кернинг : bool
• шрифт.пробел между буквами : real
• шрифт.размер в пикселях : int
• шрифт.размер в пунктах : real
• шрифт.предпочитать формирование : bool
• шрифт.зачеркнутый : bool
• шрифт.имя стиля : строка
• шрифт.подчеркнутый : bool
• шрифт.жирность : int
• шрифт.пробел между словами : real
• горизонтальное выравнивание : перечисление
• подсвеченная ссылка : строка
• ввод метода композиции : bool
• подсказки метода ввода : перечисление
• отступ слева : real
• длина : int
• количество строк : int
• режим выделения мышью : перечисление
• режим перезаписи : bool
• отступ : real
• постоянное выделение : bool
• предварительно введенный текст : строка
• только для чтения : bool
• тип отрисовки : перечисление
• отступ справа : real
• выделение с клавиатуры : bool
• выделение мышкой : bool
• выделенный текст : строка
• цвет выделенного текста : цвет
• цвет выделения : цвет
• конец выделения : int
• начало выделения : int
• расстояние до остановки табуляции : real
• текст : строка
• документ текста : TextDocument
• формат текста : перечисление
• отступ текста : real
• отступ сверху : real
• вертикальное выравнивание : перечисление
• режим переноса : перечисление

Сигналы

• editingFinished()
• linkActivated(строка link)
• linkHovered(строка link)

Методы

• void добавить(строка текст)
• очистить()
• скопировать()
• вырезать()
• отменить выделение()
• строка получить форматированный текст(int начало, int конец)
• строка получить текст(int начало, int конец)
• вставить(int позиция, строка текст)
• является справа налево(int начало, int конец)
• ссылка в(вещественное число x, вещественное число 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
}

Установление фокуса в 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().

См. также Текст и TextInput.

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

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

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

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

Допустимые значения для horizontalAlignment:

• TextEdit.AlignLeft (по умолчанию)
• TextEdit.AlignRight
• TextEdit.AlignHCenter
• TextEdit.AlignJustify

Допустимые значения для verticalAlignment:

• TextEdit.AlignTop (по умолчанию)
• TextEdit.AlignBottom
• TextEdit.AlignVCenter

При использовании присоединенного свойства 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]". Если семейство доступно от нескольких производителей, а производитель не указан, произвольно выбирается один производитель. Если семейство недоступно, семейство устанавливается с помощью алгоритма сопоставления шрифтов.

[с 5.8] 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 : булево

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

[с 5.10] font.kerning : булево

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

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

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

font.letterSpacing : вещественное

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

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

font.pixelSize : целое

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

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

font.pointSize : вещественное

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

[since 5.10] font.preferShaping : bool

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

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

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

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

font.strikeout : bool

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

[since 5.6] font.styleName : string

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

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

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

font.underline : bool

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

font.weight : int

Запрашиваемая толщина шрифта. Запрашиваемая толщина должна быть целым числом от 1 до 1000 или одним из предопределённых значений:

• 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

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

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

[since 5.2] hoveredLink : string

Это свойство содержит строку ссылки, когда пользователь наводит указатель мыши на ссылку, встроенную в текст. Ссылка должна быть в формате rich text или HTML, а строка ссылки предоставляет доступ к конкретной ссылке.

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

См. также linkHovered и linkAt().

inputMethodComposing : bool

Это свойство содержит значение, указывающее, имеет ли TextEdit частичный ввод текста от ввода.

Во время составления ввода метод ввода может полагаться на события мыши или клавиш от TextEdit для редактирования или подтверждения частичного текста. Это свойство можно использовать, чтобы определить, когда следует отключать обработчики событий, которые могут мешать правильной работе метода ввода.

inputMethodHints : enumeration

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

Значение представляет собой побитовое сочетание флагов или 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 : enumeration

Указывает, как текст должен выбираться с помощью мыши.

• TextEdit.SelectCharacters — выбор обновляется отдельными символами. (По умолчанию)
• TextEdit.SelectWords — выбор обновляется целыми словами.

Это свойство применяется только когда selectByMouse равно true.

[since 5.8] overwriteMode : bool

Указывает, будет ли введённый пользователем текст перезаписывать существующий текст.

Как и во многих текстовых редакторах, текстовый редактор может быть настроен на вставку или перезапись существующего текста новым текстом, введённым пользователем.

Если это свойство true, существующий текст перезаписывается посимвольно новым текстом; в противном случае текст вставляется в позицию курсора, смещая существующий текст.

По умолчанию это свойство false (новый текст не перезаписывает существующий текст).

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

persistentSelection : bool

Указывает, должен ли TextEdit сохранять выделение видимым, когда он теряет активный фокус на другой элемент сцены. По умолчанию это значение равно false.

[только для чтения, с 5.7] preeditText : string

Это свойство содержит частичный ввод текста от метода ввода.

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

readOnly : bool

Указывает, может ли пользователь взаимодействовать с элементом TextEdit. Если это свойство установлено в значение true, текст нельзя изменить взаимодействием пользователя.

По умолчанию это свойство равно false.

renderType : enumeration

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

Поддерживаемые типы рендеринга:

• Text.QtRendering
• Text.NativeRendering

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

Тип рендеринга по умолчанию определяется с помощью QQuickWindow::textRenderType().

[since 5.1] 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 : color

Цвет выделенного текста, используемый при выделении.

selectionColor : color

Цвет выделения текста, используемый за выделенным текстом.

selectionEnd : int

Позиция курсора после последнего символа в текущем выделении.

Это свойство является только для чтения. Чтобы изменить выделение, используйте select(start,end), selectAll() или selectWord().

См. также selectionStart, cursorPosition и selectedText.

selectionStart : int

Позиция курсора перед первой буквой в текущем выделении.

Это свойство является только для чтения. Чтобы изменить выделение, используйте select(start,end), selectAll() или selectWord().

См. также selectionEnd, cursorPosition и selectedText.

[since 5.10] tabStopDistance : real

Расстояние по умолчанию между отступами табуляции в единицах устройства.

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

См. также QTextOption::setTabStopDistance().

text : string

Текст для отображения. Если формат текста AutoText, текстовое поле автоматически определит, следует ли обрабатывать текст как форматированный. Это определение выполняется с помощью Qt::mightBeRichText(). Однако, автоматическое распознавание Markdown не выполняется.

Свойство text подходит в основном для задания начального содержимого и обработки изменений относительно небольшого текстового содержимого. Методы append(), insert() и remove() обеспечивают более точный контроль и значительно лучшую производительность при модификации, особенно большого форматированного текстового содержимого.

См. также clear() и textFormat.

[since 5.1] textDocument : TextDocument

Возвращает QQuickTextDocument этого TextEdit. Может использоваться для реализации подсветки синтаксиса с помощью QSyntaxHighlighter.

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

См. также QQuickTextDocument.

textFormat : перечисление

Способ отображения свойства text.

Поддерживаемые форматы текста:

По умолчанию 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 для флажков, могут быть интерактивно отмечены.

Примечание: Интерактивный ввод разметки или форматирования Markdown не поддерживается.

Примечание: С Text.MarkdownText, и с поддерживаемым подмножеством HTML, некоторые декоративные элементы не отображаются так, как они бы отображались в веб-браузере:

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

textMargin : real

Отступ в пикселях вокруг текста в TextEdit.

wrapMode : перечисление

Установите это свойство для перевода текста по ширине элемента TextEdit. Текст будет переноситься только если явным образом задана ширина.

• TextEdit.NoWrap - перевод не выполняется. Если текст содержит недостаточно символов новой строки, implicitWidth превысит заданную ширину.
• TextEdit.WordWrap - перенос осуществляется только по границам слов. Если слово слишком длинное, implicitWidth превысит заданную ширину.
• TextEdit.WrapAnywhere - перенос выполняется в любой точке строки, даже если он происходит посреди слова.
• TextEdit.Wrap - если возможно, перенос выполняется по границам слов; в противном случае он будет выполнен в соответствующей точке строки, даже посреди слова.

По умолчанию TextEdit.NoWrap. Если вы задаёте ширину, рассмотрите использование TextEdit.Wrap.

Документация сигналов

[since 5.6] editingFinished()

Этот сигнал испускается, когда текстовое поле теряет фокус.

Примечание: Соответствующий обработчик — onEditingFinished.

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

linkActivated(string link)

Этот сигнал испускается, когда пользователь нажимает на ссылку, встроенную в текст. Ссылка должна быть в формате форматированного текста или HTML, и строка link предоставляет доступ к конкретной ссылке.

Примечание: Соответствующий обработчик — onLinkActivated.

[since 5.2] linkHovered(string link)

Этот сигнал испускается, когда пользователь наводит курсор на ссылку, встроенную в текст. Ссылка должна быть в формате форматированного текста или HTML, и строка link предоставляет доступ к конкретной ссылке.

Примечание: Соответствующий обработчик — onLinkHovered.

Этот сигнал был добавлен в Qt 5.2.

См. также hoveredLink и linkAt().

Документация методов

[since 5.2] void append(string text)

Добавляет новый абзац с text в конец TextEdit.

Чтобы добавить без вставки нового абзаца, используйте myTextEdit.insert(myTextEdit.length, text).

Этот метод был добавлен в Qt 5.2.

[since 5.7] 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 справа налево.

[since 5.3] linkAt(real x, real y)

Возвращает строку ссылки в точке x, y в координатах содержимого, или пустую строку, если в этой точке нет ссылки.

Этот метод был добавлен в Qt 5.3.

См. также hoveredLink.

moveCursorSelection(int position, SelectionMode mode)

Перемещает курсор в позицию position и обновляет выделение в соответствии с необязательным параметром 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 расширит начало выделения до границы слова до или на позиции 5 и расширит конец выделения до границы слова на или после позиции 9.

paste()

Заменяет текущий выделенный текст содержимым системного буфера обмена.

int positionAt(int x, int y)

Возвращает позицию текста, ближайшую к пиксельной позиции (x, y).

Позиция 0 находится перед первым символом, позиция 1 — после первого, но перед вторым и так далее до позиции text.length, которая находится после всех символов.

rectangle positionToRectangle(position)

Возвращает прямоугольник в заданной позиции position в тексте. Свойства x, y и height соответствуют курсору, который описывает эту позицию.

redo()

Повторяет последнее действие, если повтор доступен.

string remove(int start, int end)

Удаляет часть текста между позициями start и end из TextEdit.

select(int start, int end)

Выделяет текст с позиции start до end.

Если start или end находятся вне диапазона, выделение не изменяется.

После вызова этого метода selectionStart станет меньшим, а selectionEnd — большим (независимо от порядка, переданного в этот метод).

См. также selectionStart и selectionEnd.

selectAll()

Выделяет весь текст.

selectWord()

Выделяет слово, ближайшее к текущей позиции курсора.

undo()

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