Класс QTextEdit

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

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

Открытые типы

Свойства

• 3 свойства унаследованы от QAbstractScrollArea
• 6 свойств унаследованы от QFrame
• 59 свойств унаследованы от QWidget
• 1 свойство унаследовано от QObject

Открытые функции

id="reimplemented-public-functions">Реализованные общедоступные функции

• 20 общедоступных функций, унаследованных от QAbstractScrollArea
• 14 общедоступных функций, унаследованных от QFrame
• 214 общедоступных функций, унаследованных от QWidget
• 31 общедоступных функций, унаследованных от QObject
• 14 общедоступных функций, унаследованных от QPaintDevice

id="public-slots">Публичные слоты

• 19 публичных слотов, унаследованных от QWidget
• 1 публичный слот, унаследованный от QObject

id="signals">Сигналы

• 3 сигнала, унаследованные от QWidget
• 2 сигнала, унаследованные от QObject

id="static-public-members">Статические общедоступные члены

• 5 статических общедоступных членов, унаследованных от QWidget
• 9 статических общедоступных членов, унаследованных от QObject

id="protected-functions">Защищённые функции

id="reimplemented-protected-functions">Реализованные защищённые функции

• 20 защищённых функций, унаследованных от QAbstractScrollArea
• 4 защищённых функций, унаследованных от QFrame
• 35 защищённых функций, унаследованных от QWidget
• 9 защищённых функций, унаследованных от QObject
• 1 защищённая функция, унаследованная от QPaintDevice

Дополнительные унаследованные члены

• 1 защищённый слот, унаследованный от QWidget

Подробное описание

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

Введение и концепции

QTextEdit — это расширенный виджет WYSIWYG, поддерживающий форматирование форматированного текста с использованием тегов в стиле HTML. Он оптимизирован для работы с большими документами и быстрой реакции на ввод пользователя.

QTextEdit работает с абзацами и символами. Абзац — это форматированная строка, которая переносится на следующую строку, чтобы поместиться в ширину виджета. По умолчанию при чтении простого текста одна новая строка обозначает абзац. Документ состоит из нуля или более абзацев. Слова в абзаце выравниваются в соответствии с выравниванием абзаца. Абзацы разделяются жёсткими разрывами строк. Каждый символ в абзаце имеет свои атрибуты, например, шрифт и цвет.

QTextEdit может отображать изображения, списки и таблицы. Если текст слишком большой для просмотра в области просмотра текстового поля, появятся полосы прокрутки. Текстовое поле может загружать как простой, так и форматированный текст. Форматированный текст описывается с помощью подмножества разметки HTML 4, см. страницу Поддерживаемое подмножество HTML для получения дополнительной информации.

Если вам нужно отобразить небольшой фрагмент форматированного текста, используйте QLabel.

Поддержка форматированного текста в Qt разработана для обеспечения быстрого, портативного и эффективного способа добавления разумных справочных данных онлайн в приложения и создания основы для редакторов форматированного текста. Если поддержка HTML недостаточна для ваших потребностей, рассмотрите использование Qt WebKit, которое предоставляет полнофункциональный виджет веб-браузера.

Форма курсора мыши в QTextEdit по умолчанию — Qt::IBeamCursor. Его можно изменить с помощью свойства курсора viewport().

Использование QTextEdit в качестве виджета отображения

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

Текст задаётся или заменяется с помощью setHtml(), которая удаляет весь существующий текст и заменяет его текстом, переданным в вызове setHtml(). Если вы вызываете setHtml() с устаревшим HTML, а затем вызываете toHtml(), возвращаемый текст может иметь другую разметку, но будет отображаться так же. Весь текст можно удалить с помощью clear().

Сам текст можно вставить с помощью класса QTextCursor или с помощью удобных функций insertHtml(), insertPlainText(), append() или paste(). QTextCursor также может вставлять сложные объекты, такие как таблицы или списки, в документ, а также обрабатывает создание выделений и применение изменений к выделенному тексту.

По умолчанию текстовое поле переносит слова при пробелах, чтобы уместиться в виджете текстового поля. Функция setLineWrapMode() используется для задания типа переноса строки или NoWrap, если вы не хотите никакого переноса. Вызовите setLineWrapMode() для установки фиксированной ширины в пикселях FixedPixelWidth или столбцов символов (например, 80 столбцов) FixedColumnWidth с указанием пикселей или столбцов с помощью setLineWrapColumnOrWidth(). Если вы используете перенос слов по ширине виджета WidgetWidth, вы можете указать, нужно ли переносить на пробелы или в любом месте с помощью setWordWrapMode().

Функция find() может использоваться для поиска и выделения заданной строки в тексте.

Если вы хотите ограничить общее количество абзацев в QTextEdit, например, это часто полезно в просмотре журналов, то вы можете использовать свойство максимаBlockCount QTextDocument для этого.

Связанные сочетания клавиш для только чтения

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

Текстовое поле может предоставить некоторую метаинформацию. Например, функция documentTitle() вернёт текст из тегов HTML <title>.

Примечание: Масштабирование HTML-документов работает только в том случае, если размер шрифта не задан фиксированным значением.

Использование QTextEdit в качестве редактора

Вся информация об использовании QTextEdit в качестве виджета отображения также применима и здесь.

Атрибуты текущего формата символа устанавливаются с помощью setFontItalic(), setFontWeight(), setFontUnderline(), setFontFamily(), setFontPointSize(), setTextColor() и setCurrentFont(). Выравнивание текущего абзаца устанавливается с помощью setAlignment().

Выбор текста осуществляется классом QTextCursor, который предоставляет функциональность для создания выделений, извлечения текстового содержимого или удаления выделений. Вы можете получить объект, соответствующий видимому курсору пользователя, используя метод textCursor(). Если вы хотите установить выделение в QTextEdit, просто создайте его на объекте QTextCursor, а затем сделайте этот курсор видимым курсором, используя setTextCursor(). Выделение можно скопировать в буфер обмена с помощью copy() или вырезать в буфер обмена с помощью cut(). Весь текст можно выделить, используя selectAll().

При перемещении курсора и изменении базовых атрибутов форматирования, сигнал currentCharFormatChanged() излучается для отображения новых атрибутов в новом положении курсора.

Сигнал textChanged() излучается всякий раз, когда текст изменяется (в результате setText() или через сам редактор).

QTextEdit содержит объект QTextDocument, который можно получить, используя метод document(). Вы также можете установить собственный объект документа с помощью setDocument().

QTextDocument предоставляет функцию isModified(), которая вернёт true, если текст был изменён с момента загрузки или с последнего вызова setModified с аргументом false. Кроме того, он предоставляет методы для отмены и повторения действий.

Перетаскивание

QTextEdit также поддерживает пользовательское поведение перетаскивания. По умолчанию QTextEdit вставит обычный текст, HTML и форматированный текст, когда пользователь перетащит данные этих типов MIME в документ. Переопределите canInsertFromMimeData() и insertFromMimeData(), чтобы добавить поддержку дополнительных типов MIME.

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

bool TextEdit::canInsertFromMimeData( const QMimeData *source ) const
{
    if (source->hasImage())
        return true;
    else
        return QTextEdit::canInsertFromMimeData(source);
}

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

void TextEdit::insertFromMimeData( const QMimeData *source )
{
    if (source->hasImage())
    {
        QImage image = qvariant_cast<QImage>(source->imageData());
        QTextCursor cursor = this->textCursor();
        QTextDocument *document = this->document();
        document->addResource(QTextDocument::ImageResource, QUrl("image"), image);
        cursor.insertImage("image");
    }
}

Мы распаковываем изображение из QVariant, хранящейся в источнике MIME, и вставляем его в документ как ресурс.

Сочетания клавиш для редактирования

Список сочетаний клавиш, реализованных для редактирования:

Для выбора (метки) текста удерживайте нажатой клавишу Shift, одновременно нажимая одну из клавиш перемещения, например, Shift+Вправо выберет символ справа, а Shift+Ctrl+Вправо выберет слово справа и т. д.

См. также QTextDocument, QTextCursor, Пример приложения, Пример выделения синтаксиса и Обработка форматированного текста.

Документация типов членов

перечисление QTextEdit::AutoFormattingFlagфлаги QTextEdit::AutoFormatting

Тип AutoFormatting — это тип-синоним для QFlags<AutoFormattingFlag>. Он хранит комбинацию значений AutoFormattingFlag с операцией ИЛИ.

перечисление QTextEdit::LineWrapMode

Документация по членам функций

QTextEdit::QTextEdit(QWidget *parent = nullptr)

Создаёт пустое текстовое поле QTextEdit со родителем parent.

QTextEdit::QTextEdit(const QString &text, QWidget *parent = nullptr)

Создаёт QTextEdit с родителем parent. Текстовое поле будет отображать текст text. Текст интерпретируется как HTML.

[virtual] QTextEdit::~QTextEdit()

Деструктор.

Qt::Alignment QTextEdit::alignment() const

Возвращает выравнивание текущего абзаца.

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

QString QTextEdit::anchorAt(const QPoint &pos) const

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

[slot] void QTextEdit::append(const QString &text)

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

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

См. также currentCharFormat() и QTextCursor::blockFormat().

[virtual protected] bool QTextEdit::canInsertFromMimeData(const QMimeData *source) const

Эта функция возвращает true, если содержимое объекта MIME-данных, указанного параметром source, может быть декодировано и вставлено в документ. Она вызывается, например, во время операции перетаскивания, когда курсор попадает в этот виджет, и необходимо определить, можно ли принять операцию перетаскивания и опускания.

Переопределите эту функцию, чтобы включить поддержку перетаскивания и опускания для дополнительных типов MIME.

bool QTextEdit::canPaste() const

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

Эта функция была добавлена в Qt 4.2.

[override virtual protected] void QTextEdit::changeEvent(QEvent *e)

Переопределено из QFrame::changeEvent().

[slot] void QTextEdit::clear()

Удаляет весь текст из текстового поля.

Примечания:

• История отмены/повтора также очищается.
• currentCharFormat() сбрасывается, если textCursor() уже находится в начале документа.

См. также cut(), setPlainText(), и setHtml().

[override virtual protected] void QTextEdit::contextMenuEvent(QContextMenuEvent *event)

Переопределено из QAbstractScrollArea::contextMenuEvent().

Отображает стандартное контекстное меню, созданное с помощью createStandardContextMenu().

Если вы не хотите, чтобы текстовое поле имело контекстное меню, установите его contextMenuPolicy в Qt::NoContextMenu. Если вы хотите настроить контекстное меню, переопределите эту функцию. Если вы хотите расширить стандартное контекстное меню, переопределите эту функцию, вызовите createStandardContextMenu() и расширьте возвращённое меню.

Информация о событии передаётся в объекте event.

void MyTextEdit::contextMenuEvent(QContextMenuEvent *event)
{
    QMenu *menu = createStandardContextMenu();
    menu->addAction(tr("My Menu Item"));
    //...
    menu->exec(event->globalPos());
    delete menu;
}

[slot] void QTextEdit::copy()

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

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

[signal] void QTextEdit::copyAvailable(bool yes)

Этот сигнал подаётся, когда текст выбран или отменён в текстовом поле.

Когда текст выбран, этот сигнал подаётся с установленным yes в true. Если текст не выбран или если выделенный текст отменён, этот сигнал подаётся с установленным yes в false.

Если yes true, то copy() можно использовать для копирования выделения в буфер обмена. Если yes false, то copy() ничего не делает.

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

[virtual protected] QMimeData *QTextEdit::createMimeDataFromSelection() const

Эта функция возвращает новый объект MIME данных, представляющий содержимое текущего выделения в редакторе текста. Она вызывается при необходимости инкапсуляции выделения в новый объект QMimeData, например, при запуске операции перетаскивания или копировании данных в буфер обмена.

Если вы переопределяете эту функцию, обратите внимание, что владение возвращённым объектом QMimeData передаётся вызывающей стороне. Выделение можно получить, используя функцию textCursor().

QMenu *QTextEdit::createStandardContextMenu()

Эта функция создаёт стандартное контекстное меню, которое отображается при щелчке правой кнопкой мыши по редактору текста. Она вызывается из обработчика событий контекстного меню contextMenuEvent() по умолчанию. Владение всплывающим меню передаётся вызывающей стороне.

Рекомендуется использовать версию createStandardContextMenu(QPoint) для включения действий, чувствительных к месту щелчка пользователя.

QMenu *QTextEdit::createStandardContextMenu(const QPoint &position)

Эта функция создаёт стандартное контекстное меню, которое отображается при щелчке правой кнопкой мыши по редактору текста. Она вызывается из обработчика событий контекстного меню contextMenuEvent() по умолчанию и принимает координаты position в координатах документа, где был щелчок мыши. Это может активировать действия, чувствительные к положению щелчка пользователя. Владение всплывающим меню передаётся вызывающей стороне.

Данная функция была введена в Qt 4.4.

QTextCharFormat QTextEdit::currentCharFormat() const

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

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

[signal] void QTextEdit::currentCharFormatChanged(const QTextCharFormat &f)

Этот сигнал генерируется, если текущий формат символа изменился, например, из-за изменения позиции курсора.

Новый формат — f.

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

QFont QTextEdit::currentFont() const

Возвращает шрифт текущего формата.

См. также setCurrentFont(), setFontFamily() и setFontPointSize().

QTextCursor QTextEdit::cursorForPosition(const QPoint &pos) const

Возвращает QTextCursor в позиции pos (в координатах области просмотра).

[signal] void QTextEdit::cursorPositionChanged()

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

QRect QTextEdit::cursorRect(const QTextCursor &cursor) const

Возвращает прямоугольник (в координатах области просмотра), включающий cursor.

QRect QTextEdit::cursorRect() const

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

[slot] void QTextEdit::cut()

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

Если выделенный текст отсутствует, ничего не происходит.

См. также copy() и paste().

[override virtual protected] void QTextEdit::dragEnterEvent(QDragEnterEvent *e)

Переопределено из QAbstractScrollArea::dragEnterEvent().

[override virtual protected] void QTextEdit::dragLeaveEvent(QDragLeaveEvent *e)

Переопределено из QAbstractScrollArea::dragLeaveEvent().

[override virtual protected] void QTextEdit::dragMoveEvent(QDragMoveEvent *e)

Переопределено из QAbstractScrollArea::dragMoveEvent().

[override virtual protected] void QTextEdit::dropEvent(QDropEvent *e)

Переопределено из QAbstractScrollArea::dropEvent().

void QTextEdit::ensureCursorVisible()

Обеспечивает видимость курсора, при необходимости прокручивая редактор текста.

QList<QTextEdit::ExtraSelection> QTextEdit::extraSelections() const

Возвращает ранее установленные дополнительные выделения.

Данная функция была введена в Qt 4.2.

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

bool QTextEdit::find(const QString &exp, QTextDocument::FindFlags options = ...)

Ищет следующее вхождение строки exp с использованием заданных options. Возвращает true если exp найдено и изменяет курсор для выделения совпадения; в противном случае возвращает false.

bool QTextEdit::find(const QRegExp &exp, QTextDocument::FindFlags options = ...)

Это перегруженная функция.

Ищет следующее вхождение, соответствующее регулярному выражению exp, используя заданные options. Опция QTextDocument::FindCaseSensitively игнорируется для этого переопределения; используйте QRegExp::caseSensitivity вместо этого.

Возвращает true если совпадение найдено и изменяет курсор для выделения совпадения; в противном случае возвращает false.

Данная функция была введена в Qt 5.3.

[override virtual protected] void QTextEdit::focusInEvent(QFocusEvent *e)

Переопределено из QWidget::focusInEvent().

[override virtual protected] bool QTextEdit::focusNextPrevChild(bool next)

Переопределено из QWidget::focusNextPrevChild().

[override virtual protected] void QTextEdit::focusOutEvent(QFocusEvent *e)

Переопределено из QWidget::focusOutEvent().

QString QTextEdit::fontFamily() const

Возвращает имя семейства шрифтов текущего формата.

См. также setFontFamily(), setCurrentFont() и setFontPointSize().

bool QTextEdit::fontItalic() const

Возвращает true если шрифт текущего формата курсивный, иначе возвращает false.

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

qreal QTextEdit::fontPointSize() const

Возвращает размер шрифта текущего формата в пунктах.

См. также setFontFamily(), setCurrentFont() и setFontPointSize().

bool QTextEdit::fontUnderline() const

Возвращает true если шрифт текущего формата подчеркнут, иначе возвращает false.

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

int QTextEdit::fontWeight() const

Возвращает начертание шрифта текущего формата.

См. также setFontWeight(), setCurrentFont(), setFontPointSize() и QFont::Weight.

[override virtual protected] void QTextEdit::inputMethodEvent(QInputMethodEvent *e)

Переопределено из QWidget::inputMethodEvent().

[override virtual] QVariant QTextEdit::inputMethodQuery(Qt::InputMethodQuery property) const

Переопределено из QWidget::inputMethodQuery().

[virtual protected] void QTextEdit::insertFromMimeData(const QMimeData *source)

Данная функция вставляет содержимое объекта данных MIME, заданного параметром source, в поле редактирования текста в текущей позиции курсора. Она вызывается всякий раз, когда текст вставляется в результате операции вставки из буфера обмена или когда поле редактирования текста принимает данные из операции перетаскивания.

Переопределите эту функцию, чтобы включить поддержку перетаскивания для дополнительных типов MIME.

[slot] void QTextEdit::insertHtml(const QString &text)

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

Он эквивалентен:

edit->textCursor().insertHtml(fragment);

Примечание: При использовании этой функции со стилем, стиль будет применён только к текущему блоку документа. Для применения стиля ко всему документу, используйте QTextDocument::setDefaultStyleSheet() вместо этого.

[slot] void QTextEdit::insertPlainText(const QString &text)

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

Он эквивалентен

edit->textCursor().insertText(text);

[override virtual protected] void QTextEdit::keyPressEvent(QKeyEvent *e)

Переопределено из QAbstractScrollArea::keyPressEvent().

[override virtual protected] void QTextEdit::keyReleaseEvent(QKeyEvent *e)

Переопределено из QWidget::keyReleaseEvent().

[virtual] QVariant QTextEdit::loadResource(int type, const QUrl &name)

Загружает ресурс, указанный заданным type и name.

Эта функция является расширением QTextDocument::loadResource().

Примечание: Эту функцию можно вызвать через систему метаобъектов и из QML. См. Q_INVOKABLE.

См. также QTextDocument::loadResource().

void QTextEdit::mergeCurrentCharFormat(const QTextCharFormat &modifier)

Объединяет свойства, заданные в modifier, в текущий формат символа, вызывая QTextCursor::mergeCharFormat на курсоре редактора. Если редактор имеет выделение, то свойства modifier непосредственно применяются к выделению.

См. также QTextCursor::mergeCharFormat().

[override virtual protected] void QTextEdit::mouseDoubleClickEvent(QMouseEvent *e)

Переопределено из QAbstractScrollArea::mouseDoubleClickEvent().

[override virtual protected] void QTextEdit::mouseMoveEvent(QMouseEvent *e)

Переопределено из QAbstractScrollArea::mouseMoveEvent().

[override virtual protected] void QTextEdit::mousePressEvent(QMouseEvent *e)

Переопределено из QAbstractScrollArea::mousePressEvent().

[override virtual protected] void QTextEdit::mouseReleaseEvent(QMouseEvent *e)

Переопределено из QAbstractScrollArea::mouseReleaseEvent().

void QTextEdit::moveCursor(QTextCursor::MoveOperation operation, QTextCursor::MoveMode mode = QTextCursor::MoveAnchor)

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

Если mode равен QTextCursor::KeepAnchor, курсор выделяет текст, по которому он перемещается. Это тот же эффект, который пользователь достигает, удерживая нажатой клавишу Shift и перемещая курсор клавишами курсора.

Эта функция была добавлена в Qt 4.2.

См. также QTextCursor::movePosition().

[override virtual protected] void QTextEdit::paintEvent(QPaintEvent *event)

Переопределено из QAbstractScrollArea::paintEvent().

Этот обработчик событий может быть переопределён в подклассе для получения событий рисования, переданных в event. Обычно нет необходимости переопределять эту функцию в подклассе QTextEdit.

Предупреждение: Необходимо не изменять основной документ с текста внутри переопределённой функции.

[slot] void QTextEdit::paste()

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

Если в буфере обмена нет текста, ничего не происходит.

Чтобы изменить поведение этой функции, т.е. изменить то, что QTextEdit может вставить и как это делается, переопределите виртуальные функции canInsertFromMimeData() и insertFromMimeData().

См. также cut() и copy().

void QTextEdit::print(QPagedPaintDevice *printer) const

Удобная функция для печати документа поля редактирования текста на заданном принтере printer. Это эквивалентно вызову метода печати на документе непосредственно, за исключением того, что эта функция также поддерживает QPrinter::Selection в качестве диапазона печати.

Эта функция была добавлена в Qt 4.3.

См. также QTextDocument::print().

[slot] void QTextEdit::redo()

Повторяет последнюю операцию.

Если нет операции для повтора, т.е. нет шага повтора в истории отмены/повтора, ничего не происходит.

Эта функция была добавлена в Qt 4.2.

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

[signal] void QTextEdit::redoAvailable(bool available)

Это сигнал, который испускается всякий раз, когда операции повтора становятся доступными (available истинно) или недоступными (available ложно).

[override virtual protected] void QTextEdit::resizeEvent(QResizeEvent *e)

Переопределено из QAbstractScrollArea::resizeEvent().

[override virtual protected] void QTextEdit::scrollContentsBy(int dx, int dy)

Переопределено из QAbstractScrollArea::scrollContentsBy().

[slot] void QTextEdit::scrollToAnchor(const QString &name)

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

[slot] void QTextEdit::selectAll()

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

См. также copy(), cut(), и textCursor().

[signal] void QTextEdit::selectionChanged()

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

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

[slot] void QTextEdit::setAlignment(Qt::Alignment a)

Устанавливает выравнивание текущего абзаца на a. Допустимые выравнивания — Qt::AlignLeft, Qt::AlignRight, Qt::AlignJustify и Qt::AlignCenter (которое центрирует по горизонтали).

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

void QTextEdit::setCurrentCharFormat(const QTextCharFormat &format)

Устанавливает формат символа, который будет использоваться при вставке нового текста в format, вызывая QTextCursor::setCharFormat() на курсоре редактора. Если редактор имеет выделение, то формат символа напрямую применяется к выделению.

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

[slot] void QTextEdit::setCurrentFont(const QFont &f)

Устанавливает шрифт текущего формата на f.

См. также currentFont(), setFontPointSize(), и setFontFamily().

void QTextEdit::setExtraSelections(const QList<QTextEdit::ExtraSelection> &selections)

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

Эта функция была введена в Qt 4.2.

См. также QTextEdit::ExtraSelection и extraSelections().

[slot] void QTextEdit::setFontFamily(const QString &fontFamily)

Устанавливает семейство шрифтов текущего формата на fontFamily.

См. также fontFamily() и setCurrentFont().

[slot] void QTextEdit::setFontItalic(bool italic)

Если italic равно true, устанавливает текущий формат на курсив; в противном случае устанавливает текущий формат на не курсив.

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

[slot] void QTextEdit::setFontPointSize(qreal s)

Устанавливает размер шрифта текущего формата на s.

Обратите внимание, что если s равно нулю или отрицательно, поведение этой функции не определено.

См. также fontPointSize(), setCurrentFont() и setFontFamily().

[slot] void QTextEdit::setFontUnderline(bool underline)

Если underline равно true, устанавливает текущий формат на подчеркнутый; в противном случае устанавливает текущий формат на не подчеркнутый.

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

[slot] void QTextEdit::setFontWeight(int weight)

Устанавливает начертание шрифта текущего формата на заданное значение weight, где значение находится в диапазоне, определённом перечислением QFont::Weight.

См. также fontWeight(), setCurrentFont() и setFontFamily().

[slot] void QTextEdit::setPlainText(const QString &text)

Изменяет текст текстового поля на строку text. Любой предыдущий текст удаляется.

Примечания:

• text интерпретируется как обычный текст.
• История отмены/повтор также очищается.
• currentCharFormat() сбрасывается, если textCursor() ещё не в начале документа.

Примечание: Функция-сеттер для свойства plainText.

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

[slot] void QTextEdit::setText(const QString &text)

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

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

Эта функция была введена в Qt 4.2.

См. также toPlainText() и toHtml().

[slot] void QTextEdit::setTextBackgroundColor(const QColor &c)

Устанавливает цвет фона текста текущего формата на c.

Эта функция была введена в Qt 4.4.

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

[slot] void QTextEdit::setTextColor(const QColor &c)

Устанавливает цвет текста текущего формата на c.

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

void QTextEdit::setTextCursor(const QTextCursor &cursor)

Устанавливает видимый cursor.

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

[override virtual protected] void QTextEdit::showEvent(QShowEvent *)

Переопределено из QWidget::showEvent().

QColor QTextEdit::textBackgroundColor() const

Возвращает цвет фона текста текущего формата.

Эта функция была введена в Qt 4.4.

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

[signal] void QTextEdit::textChanged()

Этот сигнал излучается всякий раз, когда содержимое документа изменяется; например, при вставке или удалении текста или применении форматирования.

Примечание: Сигнал-уведомление для свойства html.

QColor QTextEdit::textColor() const

Возвращает цвет текста текущего формата.

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

QTextCursor QTextEdit::textCursor() const

Возвращает копию QTextCursor, представляющей текущий видимый курсор. Обратите внимание, что изменения в возвращаемом курсоре не влияют на курсор QTextEdit; используйте setTextCursor() для обновления видимого курсора.

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

QString QTextEdit::toPlainText() const

QString QTextEdit::toPlainText() const

Возвращает текст текстового поля в виде простого текста.

Примечание: Функция-геттер для свойства plainText.

См. также QTextEdit::setPlainText().

[slot] void QTextEdit::undo()

Отменяет последнюю операцию.

Если нет операции для отмены, т.е. нет шага отмены в истории отмены/повтора, ничего не происходит.

Эта функция была введена в Qt 4.2.

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

[signal] void QTextEdit::undoAvailable(bool available)

Этот сигнал излучается всякий раз, когда операции отмены становятся доступными (available равно true) или недоступными (available равно false).

[override virtual protected] void QTextEdit::wheelEvent(QWheelEvent *e)

Переопределено из QAbstractScrollArea::wheelEvent().

[slot] void QTextEdit::zoomIn(int range = 1)

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

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

[slot] void QTextEdit::zoomOut(int range = 1)

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

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