QgsRichTextEditor Class Reference

A widget for editing rich text documents, with support for user controlled formatting of text and insertion of hyperlinks and images. More...

#include <qgsrichtexteditor.h>

Inheritance diagram for QgsRichTextEditor:

Public Types
enum class	Mode { QTextDocument , QgsTextRenderer , PlainText }
	Widget modes. More...

Public Slots
void	clearSource ()
	Clears the current text from the widget.
void	setText (const QString &text)
	Sets the text to show in the widget.

Signals
void	textChanged ()
	Emitted when the text contents are changed.

Public Member Functions
	QgsRichTextEditor (QWidget *parent=nullptr)
	Constructor for QgsRichTextEditor, with the specified parent widget.
QTextDocument *	document ()
	Returns a reference to the QTextDocument shown in the widget.
Mode	mode () const
	Returns the widget's mode, which defines which formatting options are exposed in the widget.
void	setMode (Mode mode)
	Sets the widget's mode, which defines which formatting options are exposed in the widget.
void	setTextCursor (const QTextCursor &cursor)
	Sets the current text cursor.
QTextCursor	textCursor () const
	Returns a reference to the text cursor.
QTextEdit *	textEdit ()
	Returns the widget's QTextEditor control.
QString	toHtml () const
	Returns the widget's content as a HTML string.
QString	toPlainText () const
	Returns the widget's content as a plain text string.

Protected Member Functions
void	focusInEvent (QFocusEvent *event) override

Detailed Description

A widget for editing rich text documents, with support for user controlled formatting of text and insertion of hyperlinks and images.

QgsRichTextEditor provides a reusable widget for allowing users to edit rich text documents, and retrieving and setting the documents via HTML formatted strings.

Since

QGIS 3.20

Definition at line 60 of file qgsrichtexteditor.h.

Member Enumeration Documentation

Mode

enum class QgsRichTextEditor::Mode

strong

Widget modes.

Since

QGIS 3.40

Enumerator
QTextDocument	Default mode, exposes the Qt supported HTML/CSS subset.
QgsTextRenderer	QGIS text renderer mode, exposes the HTML/CSS subset supported by the QgsTextRenderer class.
PlainText	Plain text mode.

Definition at line 70 of file qgsrichtexteditor.h.

Constructor & Destructor Documentation

QgsRichTextEditor()

QgsRichTextEditor::QgsRichTextEditor

(

QWidget *

parent = nullptr

)

Constructor for QgsRichTextEditor, with the specified parent widget.

Definition at line 56 of file qgsrichtexteditor.cpp.

Member Function Documentation

clearSource

void QgsRichTextEditor::clearSource ( )

slot

Clears the current text from the widget.

Definition at line 357 of file qgsrichtexteditor.cpp.

document()

QTextDocument * QgsRichTextEditor::document ( )

inline

Returns a reference to the QTextDocument shown in the widget.

Definition at line 125 of file qgsrichtexteditor.h.

focusInEvent()

void QgsRichTextEditor::focusInEvent ( QFocusEvent * event )

overrideprotected

Definition at line 400 of file qgsrichtexteditor.cpp.

mode()

Mode QgsRichTextEditor::mode ( ) const

inline

Returns the widget's mode, which defines which formatting options are exposed in the widget.

See also

setMode()

Since

QGIS 3.40

Definition at line 90 of file qgsrichtexteditor.h.

setMode()

void QgsRichTextEditor::setMode

(

Mode

mode

)

Sets the widget's mode, which defines which formatting options are exposed in the widget.

See also

mode()

Since

QGIS 3.40

Definition at line 146 of file qgsrichtexteditor.cpp.

setText

void QgsRichTextEditor::setText ( const QString & text )

slot

Sets the text to show in the widget.

The text can either be a plain text string or a HTML document.

Definition at line 753 of file qgsrichtexteditor.cpp.

setTextCursor()

void QgsRichTextEditor::setTextCursor ( const QTextCursor & cursor )

inline

Sets the current text cursor.

See also

textCursor()

Definition at line 139 of file qgsrichtexteditor.h.

textChanged

void QgsRichTextEditor::textChanged ( )

signal

Emitted when the text contents are changed.

Since

QGIS 3.26

textCursor()

QTextCursor QgsRichTextEditor::textCursor ( ) const

inline

Returns a reference to the text cursor.

See also

setTextCursor()

Definition at line 132 of file qgsrichtexteditor.h.

textEdit()

QTextEdit * QgsRichTextEditor::textEdit ( )

inline

Returns the widget's QTextEditor control.

Since

QGIS 3.40

Definition at line 120 of file qgsrichtexteditor.h.

toHtml()

QString QgsRichTextEditor::toHtml

(

)

const

Returns the widget's content as a HTML string.

See also

toPlainText()

Definition at line 305 of file qgsrichtexteditor.cpp.

toPlainText()

QString QgsRichTextEditor::toPlainText

(

)

const

Returns the widget's content as a plain text string.

See also

toHtml()

Definition at line 287 of file qgsrichtexteditor.cpp.

---

The documentation for this class was generated from the following files:

• /build/qgis-3.99.0+git20251207+21b3aa880ba+99sid/src/gui/qgsrichtexteditor.h
• /build/qgis-3.99.0+git20251207+21b3aa880ba+99sid/src/gui/qgsrichtexteditor.cpp