Тип 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
• шрифт.начертание : перечисление
• шрифт.пробелы между словами : real
• горизонтальное выравнивание : перечисление
• подсвеченный ссылка : строка
• ввод метода компоновки : bool
• подсказки метода ввода : перечисление
• отступ слева : real
• длина : int
• количество строк : int
• режим выделения мышью : перечисление
• режим перезаписи : bool
• отступ : real
• постоянное выделение : bool
• предварительный текст : строка
• только чтение : bool
• тип рендеринга : перечисление
• отступ справа : real
• выделение клавиатурой : bool
• выделение мышью : bool
• выделенный текст : строка
• цвет выделенного текста : цвет
• цвет выделения : цвет
• конец выделения : int
• начало выделения : int
• расстояние до отступа : real
• текст : строка
• документ текста : Текстовый документ
• формат текста : перечисление
• отступ текста : real
• отступ сверху : real
• вертикальное выравнивание : перечисление
• режим перевода строки : перечисление

Сигналы

• editingFinished()
• активированная ссылка(строка ссылка)
• подсвеченная ссылка(строка ссылка)

Методы

• void добавить(строка текст)
• очистить()
• копировать()
• вырезать()
• отменить выделение()
• строка получить форматированный текст(int начало, int конец)
• строка получить текст(int начало, int конец)
• вставить(int позиция, строка текст)
• isRightToLeft(int начало, int конец)
• ссылка в(вещественное x, вещественное y)
• переместить выделение курсора(int позиция, РежимВыделения mode = TextEdit.SelectCharacters)
• вставить()
• 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.

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

activeFocusOnPress : bool

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

baseUrl : url

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

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

bottomPadding : real

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

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

canPaste : bool

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

canRedo : bool

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

canUndo : bool

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

color : color

Цвет текста.

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

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

contentHeight : real

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

contentWidth : real

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

cursorDelegate : Component

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

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

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

cursorPosition : int

Позиция курсора в TextEdit.

cursorRectangle : rectangle

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

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

cursorVisible : bool

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

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

effectiveHorizontalAlignment : enumeration

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

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

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

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

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

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

font.bold : bool

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

font.capitalization : enumeration

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

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

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

font.family : string

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

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

font.hintingPreference : enumeration

Устанавливает предпочтительный уровень сглаживания текста. Это подсказка для подсистемы рендеринга текста использовать определённый уровень сглаживания, и его поддержка варьируется в разных платформах. Подробности см. в таблице документации для 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

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

font.kerning : bool

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

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

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

font.letterSpacing : real

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

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

font.pixelSize : int

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

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

font.pointSize : real

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

font.preferShaping : bool

Иногда шрифт применяет сложные правила к набору символов для правильного отображения. В некоторых системах письма, таких как брахмические скрипты, это необходимо для удобочитаемости текста, но, например, в латинском шрифте это просто косметическая функция. Установка свойства 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

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

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

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

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

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

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

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

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

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

hoveredLink : string

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

leftPadding : real

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

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

length : int

Возвращает общее количество символов простого текста в элементе TextEdit.

Поскольку это число не включает какие-либо форматирующие метки, оно может отличаться от длины строки, возвращаемой свойством text.

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

lineCount : int

Возвращает общее количество строк в элементе TextEdit.

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

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

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

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

overwriteMode : bool

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

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

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

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

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

padding : real

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

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

persistentSelection : bool

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

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

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

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

readOnly : bool

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

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

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

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

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

• Text.QtRendering
• Text.NativeRendering

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

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

rightPadding : real

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

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

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.

tabStopDistance : real

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

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

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

text : string

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

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

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

textDocument : TextDocument

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

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

См. также QQuickTextDocument.

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

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

• TextEdit.AutoText
• TextEdit.PlainText
• TextEdit.RichText

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

Column {
    TextEdit {
        font.pointSize: 24
        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>"
    }
}

textMargin : real

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

topPadding : real

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

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

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

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

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

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

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

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

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

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()

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

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

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

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

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

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

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

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

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

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

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

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

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

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

См. также hoveredLink.

moveCursorSelection(целое position, SelectionMode mode = TextEdit.SelectCharacters)

Перемещает курсор в позицию 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 (шестой и седьмой символы).

Такая же последовательность с TextEdit.SelectWords расширит начальную позицию выделения до границы слова перед или на позиции 5 и расширит конечную позицию выделения до границы слова на или после позиции 9.

paste()

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

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

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

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

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

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

redo()

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

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

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

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

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

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

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

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

selectAll()

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

selectWord()

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

undo()

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