QTextEdit Class Reference
[QtGui module]

Introduction and Concepts

QTextEdit is an advanced WYSIWYG viewer/editor supporting rich text formatting using HTML-style tags. It is optimized to handle large documents and to respond quickly to user input.

QTextEdit works on paragraphs and characters. A paragraph is a formatted string which is word-wrapped to fit into the width of the widget. By default when reading plain text, one newline signifies a paragraph. A document consists of zero or more paragraphs. The words in the paragraph are aligned in accordance with the paragraph's alignment. Paragraphs are separated by hard line breaks. Each character within a paragraph has its own attributes, for example, font and color.

QTextEdit can display images, lists and tables. If the text is too large to view within the text edit's viewport, scroll bars will appear. The text edit can load both plain text and HTML files (a subset of HTML 3.2 and 4).

If you just need to display a small piece of rich text use QLabel.

The rich text support in Qt is designed to provide a fast, portable and efficient way to add reasonable online help facilities to applications, and to provide a basis for rich text editors. If you find the HTML support insufficient for your needs you may consider the use of QtWebKit, which provides a full-featured web browser widget.

The shape of the mouse cursor on a QTextEdit is Qt::IBeamCursor by default. It can be changed through the viewport()'s cursor property.

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

 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");
     }
 }

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

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

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