Тип QML TextEdit

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

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

Свойства

• activeFocusOnPress : bool
• baseUrl : url
• bottomPadding : real
• canPaste : bool
• canRedo : bool
• canUndo : bool
• цвет : цвет
• высотаСодержимого : real
• ширинаСодержимого : real
• делегатКурсора : Компонент
• позицияКурсора : int
• прямоугольникКурсора : прямоугольник
• видимостьКурсора : bool
• эффективноеГоризонтальноеВыравнивание : перечисление
• font.жирный : bool
• font.регистр : перечисление
• font.семействоШрифтов : строка
• font.предпочтениеНачертания : перечисление
• font.курсив : bool
• font.кернинг : bool
• font.пробелыМеждуБуквами : real
• font.размерВПикселях : int
• font.размерВТочках : real
• font.предпочитатьФормирование : bool
• font.зачеркнутый : bool
• font.имяСтили : строка
• font.подчеркнутый : bool
• font.жирность : int
• font.пробелыМеждуСловами : real
• горизонтальноеВыравнивание : перечисление
• выделенныйСсылка : строка
• вводМетодСоставления : bool
• вводМетодПодсказки : перечисление
• левыйОтступ : real
• длина : int
• количествоСтрок : int
• режимВыборМышью : перечисление
• режимПерезаписи : bool
• отступ : real
• постоянныйВыбор : bool
• предварительныйТекст : строка
• толькоЧтение : bool
• типОтрисовки : перечисление
• правыйОтступ : real
• выборКлавиатурой : bool
• выборМышью : bool
• выделенныйТекст : строка
• цветВыделенногоТекста : цвет
• цветВыбора : цвет
• конецВыбора : int
• началоВыбора : int
• расстояниеДоТабуляции : real
• текст : строка
• текстовыйДокумент : ТекстовыйДокумент
• форматТекста : перечисление
• отступТекста : real
• верхнийОтступ : real
• вертикальноеВыравнивание : перечисление
• режимПереноса : перечисление

Сигналы

• завершениеРедактирования()
• активированнаяСсылка(строка ссылка)
• наведениеНаСсылка(строка ссылка)

Методы

• void добавить(строка текст)
• очистить()
• копировать()
• вырезать()
• отменитьВыбор()
• строка получитьФорматированныйТекст(int начало, int конец)
• строка получитьТекст(int начало, int конец)
• вставить(int позиция, строка текст)
• являетсяСправаНалево(int начало, int конец)
• ссылкаВ(real x, real y)
• переместитьВыборКурсора(int позиция, РежимВыбора режим)
• вставить()
• 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 {
     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().

См. также Text и 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 : bool

Определяет, должен ли TextEdit получать активный фокус при нажатии мыши. По умолчанию это значение равно true.

baseUrl : url

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

Значение по умолчанию — URL файла QML, который создаёт элемент TextEdit.

canPaste : bool

Возвращает true, если TextEdit допускает запись и содержимое буфера обмена подходит для вставки в TextEdit.

canRedo : bool

Возвращает true, если TextEdit допускает запись и существуют отменённые операции, которые можно повторить.

canUndo : bool

Возвращает true, если TextEdit допускает запись и существуют предыдущие операции, которые можно отменить.

color : цвет

Цвет текста.

// green text using hexadecimal notation
TextEdit { color: "#00FF00" }

// steelblue text using SVG color name
TextEdit { color: "steelblue" }

contentHeight : real

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

contentWidth : real

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

cursorDelegate : Компонент

Делегат для курсора в TextEdit.

Если вы установите cursorDelegate для TextEdit, этот делегат будет использоваться для рисования курсора вместо стандартного. Экземпляр делегата будет создан и управляться текстовым полем при необходимости курсора, а свойства x и y экземпляра делегата будут установлены так, чтобы находиться на один пиксель перед верхним левым углом текущего символа.

Обратите внимание, что корневой элемент компонента делегата должен быть QQuickItem или элементом, производным от QQuickItem.

cursorPosition : int

Положение курсора в TextEdit.

cursorRectangle : rectangle

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

Положение и высота пользовательского cursorDelegate обновляются для следования за cursorRectangle автоматически при его изменении. Ширина делегата не изменяется при изменении прямоугольника курсора.

cursorVisible : bool

Если true, текстовое поле отображает курсор.

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

font.bold : bool

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

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 : bool

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

[с 5.10] font.kerning : bool

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

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

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

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

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

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

font.pixelSize : int

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

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

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

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

[с 5.10] font.preferShaping : bool

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

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

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

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

font.strikeout : bool

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

[с 5.6] font.styleName : строка

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

Имя стиля не чувствительно к регистру. При установке шрифт будет сопоставляться с именем стиля вместо свойств шрифта 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 : вещественное

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

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

[с 5.2] hoveredLink : строка

Это свойство содержит строку ссылки, когда пользователь наводит курсор на ссылку, встроенную в текст. Ссылка должна быть в формате форматированного текста или 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.

[since 5.8] overwriteMode : bool

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

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

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

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

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

persistentSelection : bool

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

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

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

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

readOnly : bool

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

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

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

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

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

• Text.QtRendering
• Text.NativeRendering

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

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

[начиная с 5.1] selectByKeyboard : bool

По умолчанию равно true, когда редактор редактируемый, и false, когда только для чтения.

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

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

См. также readOnly.

selectByMouse : bool

По умолчанию равно false.

Если true, пользователь может использовать мышь для выбора текста каким-то платформенно-зависимым способом. Обратите внимание, что для некоторых платформ это может быть неподходящее взаимодействие; оно может конфликтовать с тем, как текст должен вести себя внутри Flickable, например.

selectedText : строка

Это свойство только для чтения предоставляет текст, который в настоящее время выделен в текстовом редакторе.

Это эквивалентно следующему фрагменту, но быстрее и проще в использовании.

//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.

[начиная с 5.10] tabStopDistance : вещественное

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

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

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

text : строка

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

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

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

[начиная с 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(строка link)

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

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

[since 5.2] linkHovered(строка link)

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

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

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

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

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

[since 5.2] пусто append(строка text)

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

Для добавления без вставки нового абзаца, вызовите myTextEdit.insert(myTextEdit.length, text) вместо этого.

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

[since 5.7] clear()

Очищает содержимое текстового редактора и сбрасывает частичный ввод текста от метода ввода.

Используйте этот метод вместо задания свойства text на пустую строку.

Этот метод был представлен в Qt 5.7.

См. также QInputMethod::reset().

copy()

Копирует выделенный текст в буфер обмена системы.

cut()

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

deselect()

Удаляет активный выбор текста.

строка getFormattedText(целое start, целое end)

Возвращает часть текста между позициями start и end.

Возвращаемый текст будет отформатирован в соответствии со свойством textFormat.

строка getText(целое start, целое end)

Возвращает часть текста между позициями start и end.

Возвращаемый текст не включает форматирование форматированного текста.

insert(целое position, строка text)

Вставляет text в TextEdit по позиции position.

isRightToLeft(целое start, целое end)

Возвращает true, если естественное направление чтения текста редактора между позициями start и end — справа налево.

[since 5.3] linkAt(вещественное x, вещественное y)

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

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

См. также hoveredLink.

moveCursorSelection(целое 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()

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

целое positionAt(целое x, целое y)

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

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

прямоугольник positionToRectangle(position)

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

redo()

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

строка remove(целое start, целое end)

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

select(целое start, целое end)

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

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

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

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

selectAll()

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

selectWord()

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

undo()

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