QTextView - A sophisticated single-page rich text viewer
#include <qtextview.h>
Inherits QScrollView.
Inherited by QTextBrowser.
Public Members
QTextView ( QWidget * parent=0, const char * name=0 )
QTextView ( const QString & text, const QString & context
= QString::null, QWidget * parent=0, const char *
name=0 )
~QTextView ()
virtual void setText ( const QString & text, const QString
& context )
void setText ( const QString & text )
virtual QString text () const
virtual QString context () const
TextFormat textFormat () const
void setTextFormat ( TextFormat )
QStyleSheet* styleSheet () const
void setStyleSheet ( QStyleSheet * styleSheet )
void setPaper ( const QBrush & pap )
const QBrush& paper ()
const QBrush& paper () const
void setPaperColorGroup ( const QColorGroup & colgrp )
const QColorGroup& paperColorGroup () const
void setLinkColor ( const QColor & )
const QColor& linkColor () const
void setLinkUnderline ( bool )
bool linkUnderline () const
void setMimeSourceFactory ( QMimeSourceFactory * factory )
QMimeSourceFactory* mimeSourceFactory () const
QString documentTitle () const
virtual int heightForWidth ( int w ) const
void append ( const QString & text )
bool hasSelectedText () const
QString selectedText () const
Public Slots
void copy ()
void selectAll ()
Protected Members
virtual void keyPressEvent ( QKeyEvent * )
QRichText& richText () const
Properties
Type Name READ WRITE Options
-------------------------------------------------------------------------------
TextFormat textFormat textFormat setTextFormat
QBrush paper paper setPaper
QColorGroup paperColorGroup paperColorGroup setPaperColorGroup
QColor linkColor linkColor setLinkColor
bool linkUnderline linkUnderline setLinkUnderline
QString documentTitle documentTitle
DESCRIPTION
A sophisticated single-page rich text viewer.
Unlike QSimpleRichText, which merely draws small pieces of
rich text, a QTextView is a real widget, with scrollbars
when necessary, for showing large text documents.
The rendering style and available tags are defined by a
styleSheet(). Currently, a small XML/CSS1 subset including
embedded images and tables is supported. See QStyleSheet
for details. Possible images within the text document are
resolved by using a QMimeSourceFactory. See
setMimeSourceFactory() for details.
Using QTextView is quite similar to QLabel. It's mainly a
call to setText() to set the contents. Setting the
background color is slightly different from other widgets,
since a text view is a scrollable widget that naturally
provides a scrolling background. You can specify the
colorgroup of the displayed text with setPaperColorGroup()
or directly define the paper background with setPaper().
QTextView supports both plain color and complex pixmap
backgrounds.
Note that we do not intend to add a full-featured web
browser widget to Qt (since that would easily double Qt's
size and only few applications would benefit from it). In
particular, the rich text support in Qt is supposed to
provide a fast, portable and sufficient way to add
reasonable online help facilities to applications. We
will, however, extend it to some degree in future versions
of Qt.
For even more, like hypertext capabilities, see
QTextBrowser.
MEMBER FUNCTION DOCUMENTATION
QTextView::QTextView ( QWidget * parent=0, const char * name=0 )
Constructs an empty QTextView with the standard parent and
name optional arguments.
QTextView::QTextView ( const QString & text, const QString &
context = QString::null, QWidget * parent=0, const char *
name=0 )
Constructs a QTextView displaying the contents text with
optional arguments.
QTextView::~QTextView ()
Destructs the view.
void QTextView::append ( const QString & text )
Appends text to the current text.
Useful for log viewers.
Warning: This function has known problems (incorrect
painting and layouting). If this problem occures to you,
use setText( text() + theNewText ) instead. The new
richtext engine, which is part of Qt 3.0, is able to
handle append(), insert(), etc. properly.
QString QTextView::context () const [virtual]
Returns the context of the view.
See also text() and setText().
void QTextView::copy () [slot]
Copies the marked text to the clipboard.
QString QTextView::documentTitle () const
Returns the document title parsed from the content.
void QTextView::drawContentsOffset ( QPainter * p, int ox, int
oy, int cx, int cy, int cw, int ch ) [virtual protected]
Reimplemented for internal reasons; the API is not
affected.
Reimplemented from QScrollView.
void QTextView::focusInEvent ( QFocusEvent * ) [virtual
protected]
Reimplemented for internal reasons; the API is not
affected.
Reimplemented from QWidget.
void QTextView::focusOutEvent ( QFocusEvent * ) [virtual
protected]
Reimplemented for internal reasons; the API is not
affected.
Reimplemented from QWidget.
bool QTextView::hasSelectedText () const
Returns TRUE if there is any text selected, FALSE
otherwise.
See also selectedText().
Returns the height of the view given a width of w.
Reimplemented from QWidget.
void QTextView::keyPressEvent ( QKeyEvent * e ) [virtual
protected]
Provides scrolling and paging.
Reimplemented from QWidget.
const QColor& QTextView::linkColor () const
Returns the current link color.
The color may either have been set with setLinkColor() or
stem from the document's body tag.
See also setLinkColor().
bool QTextView::linkUnderline () const
Returns whether or not links should be displayed
underlined.
QMimeSourceFactory* QTextView::mimeSourceFactory () const
Returns the current mime source factory for the view.
See also setMimeSourceFactory().
void QTextView::paletteChange ( const QPalette & p ) [virtual
protected]
Reimplemented for internal reasons; the API is not
affected.
Reimplemented from QWidget.
const QBrush& QTextView::paper ()
Returns the brush used to paint the background.
const QBrush& QTextView::paper () const
Returns the brush used to paint the background.
const QColorGroup& QTextView::paperColorGroup () const
Returns the colorgroup of the paper.
See also setPaperColorGroup() and setPaper().
void QTextView::resizeEvent ( QResizeEvent * e ) [virtual
protected]
Reimplemented for internal reasons; the API is not
affected.
Reimplemented from QWidget.
Returns the document defining the view as drawable and
queryable rich text object. This is not currently useful
for applications.
void QTextView::selectAll () [slot]
Selects all text.
QString QTextView::selectedText () const
Returns a copy of the selected text in plain text format.
See also hasSelectedText().
void QTextView::setLinkColor ( const QColor & col )
Sets the color used to display links in the document to
col.
See also linkColor().
void QTextView::setLinkUnderline ( bool u )
Defines whether or not links should be displayed
underlined.
void QTextView::setMimeSourceFactory ( QMimeSourceFactory *
factory )
Sets the mime source factory for the view. The factory is
used to resolve named references within rich text
documents. If no factory has been specified, the text view
uses the default factory
QMimeSourceFactory::defaultFactory().
Ownership of factory is not transferred to make it
possible for several text view widgets to share the same
mime source.
See also mimeSourceFactory().
void QTextView::setPaper ( const QBrush & pap )
Sets the brush to use as the background to pap.
This may be a nice parchment or marble pixmap or simply
another plain color.
Technically, setPaper() is just a convenience function to
set the base brush of the paperColorGroup().
See also paper().
void QTextView::setPaperColorGroup ( const QColorGroup & colgrp )
Sets the full colorgroup of the paper to colgrp. If not
specified otherwise in the document itself, any text will
use QColorGroup::text(). The background will be painted
with QColorGroup::brush(QColorGroup::Base).
void QTextView::setStyleSheet ( QStyleSheet * styleSheet )
Sets the style sheet of the view.
See also styleSheet().
void QTextView::setText ( const QString & text, const QString &
context ) [virtual]
Changes the contents of the view to the string text and
the context to context.
text may be interpreted either as plain text or as rich
text, depending on the textFormat(). The default setting
is AutoText, i.e. the text view autodetects the format
from text.
The optional context is used to resolve references within
the text document, for example image sources. It is passed
directly to the mimeSourceFactory() when quering data.
See also text() and setTextFormat().
Reimplemented in QTextBrowser.
void QTextView::setText ( const QString & text )
This is an overloaded member function, provided for
convenience. It differs from the above function only in
what argument(s) it accepts.
Changes the contents of the view to the string text.
text may be interpreted either as plain text or as rich
text, depending on the textFormat(). The default setting
is AutoText, i.e. the text view autodetects the format
from text.
This function calls setText( text, QString::null ), i.e.
it sets a text without any context.
See also text() and setTextFormat().
void QTextView::setTextFormat ( Qt::TextFormat format )
Sets the text format to format. Possible choices are
PlainText - all characters are displayed verbatim,
including all blanks and linebreaks.
RichText - rich text rendering. The available styles are
defined in the default stylesheet
QStyleSheet::defaultSheet().
AutoText - this is also the default. The label autodetects
which rendering style suits best, PlainText or
QStyleSheet::mightBeRichText() heuristic.
void QTextView::showEvent ( QShowEvent * ) [virtual protected]
Reimplemented for internal reasons; the API is not
affected.
Reimplemented from QWidget.
QStyleSheet* QTextView::styleSheet () const
Returns the current style sheet of the view.
See also setStyleSheet().
QString QTextView::text () const [virtual]
Returns the contents of the view.
See also context() and setText().
Qt::TextFormat QTextView::textFormat() const
Returns the current text format.
See also setTextFormat().
void QTextView::viewportMouseMoveEvent ( QMouseEvent * e )
[virtual protected]
Reimplemented for internal reasons; the API is not
affected.
Reimplemented from QScrollView.
void QTextView::viewportMousePressEvent ( QMouseEvent * e )
[virtual protected]
Reimplemented for internal reasons; the API is not
affected.
Reimplemented from QScrollView.
void QTextView::viewportMouseReleaseEvent ( QMouseEvent * e )
[virtual protected]
Reimplemented for internal reasons; the API is not
affected.
Reimplemented from QScrollView.
void QTextView::viewportResizeEvent ( QResizeEvent * ) [virtual
protected]
Reimplemented for internal reasons; the API is not
affected.
Reimplemented from QScrollView.
SEE ALSO
http://doc.trolltech.com/qtextview.html
COPYRIGHT
Copyright 1992-2001 Trolltech AS,
http://www.trolltech.com. See the license file included
in the distribution for a complete license statement.
AUTHOR
Generated automatically from the source code.
BUGS
If you find a bug in Qt, please report it as described in
http://doc.trolltech.com/bughowto.html. Good bug reports
make our job much simpler. Thank you.
In case of content or formattting problems with this
manual page, please report them to qt-bugs@trolltech.com.
Please include the name of the manual page (qtextview.3qt)
and the Qt version (2.3.1).
Man(1) output converted with
man2html