AuroraMiddleware/qt5base-lts
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Doc: Fix \sa usage

Browse Source 
Ensure comma between elements (757 missing), single space and curly-
braces around title elements, etc.

Change-Id: Id16c3fda7fc47a12a0682f8720214f4990609a97
Reviewed-by: Giuseppe D'Angelo <giuseppe.dangelo@kdab.com>
Reviewed-by: Casper van Donderen <casper.vandonderen@nokia.com>
This commit is contained in:
Marius Storm-Olsen 2012-05-10 13:10:23 +02:00 committed by Qt by Nokia
parent 87d21127de
commit ad97aba452
91 changed files with 531 additions and 554 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
doc/src/examples/textfinder.qdoc
View File

@ -155,5 +155,5 @@
The \c main() function initialises the \e{textfinder.qrc} resource file The \c main() function initialises the \e{textfinder.qrc} resource file
and instantiates as well as displays \c TextFinder. and instantiates as well as displays \c TextFinder.
\sa{Calculator Builder Example}, {World Time Clock Builder Example} \sa {Calculator Builder Example}, {World Time Clock Builder Example}
*/ */

2
src/concurrent/qfuture.cpp
View File

@ -412,7 +412,7 @@
uninitialized iterartor. Use operator=() to assign a value to it before uninitialized iterartor. Use operator=() to assign a value to it before
using it. using it.
\sa QFuture::constBegin() QFuture::constEnd() \sa QFuture::constBegin(), QFuture::constEnd()
*/ */
/*! \fn QFuture::const_iterator::const_iterator(QFuture const * const future, int index) /*! \fn QFuture::const_iterator::const_iterator(QFuture const * const future, int index)

2
src/corelib/global/qlogging.cpp
View File

@ -832,7 +832,7 @@ void qWinMessageHandler2(QtMsgType t, const QMessageLogContext &context,
qSetMessagePattern() has no effect if a custom message handler is installed. qSetMessagePattern() has no effect if a custom message handler is installed.
\sa qInstallMessageHandler, Debugging Techniques \sa qInstallMessageHandler, {Debugging Techniques}
*/ */
QtMessageHandler qInstallMessageHandler(QtMessageHandler h) QtMessageHandler qInstallMessageHandler(QtMessageHandler h)

2
src/corelib/kernel/qcoreapplication.cpp
View File

@ -1559,7 +1559,7 @@ bool QCoreApplication::installTranslator(QTranslator *translationFile)
The function returns true on success and false on failure. The function returns true on success and false on failure.
\sa installTranslator() translate(), QObject::tr() \sa installTranslator(), translate(), QObject::tr()
*/ */
bool QCoreApplication::removeTranslator(QTranslator *translationFile) bool QCoreApplication::removeTranslator(QTranslator *translationFile)

22
src/gui/image/qpicture.cpp
View File

@ -1189,7 +1189,7 @@ QT_END_INCLUDE_NAMESPACE
fileName, or 0 if the file cannot be read or if the format is not fileName, or 0 if the file cannot be read or if the format is not
recognized. recognized.
\sa load() save() \sa load(), save()
*/ */
const char* QPicture::pictureFormat(const QString &fileName) const char* QPicture::pictureFormat(const QString &fileName)
@ -1203,7 +1203,7 @@ const char* QPicture::pictureFormat(const QString &fileName)
Returns a list of picture formats that are supported for picture Returns a list of picture formats that are supported for picture
input. input.
\sa outputFormats() inputFormatList() QPictureIO \sa outputFormats(), inputFormatList(), QPictureIO
*/ */
QList<QByteArray> QPicture::inputFormats() QList<QByteArray> QPicture::inputFormats()
{ {
@ -1228,7 +1228,7 @@ static QStringList qToStringList(const QList<QByteArray> arr)
over a copy, e.g. over a copy, e.g.
\snippet picture/picture.cpp 2 \snippet picture/picture.cpp 2
\sa outputFormatList() inputFormats() QPictureIO \sa outputFormatList(), inputFormats(), QPictureIO
*/ */
QStringList QPicture::inputFormatList() QStringList QPicture::inputFormatList()
{ {
@ -1246,7 +1246,7 @@ QStringList QPicture::inputFormatList()
over a copy, e.g. over a copy, e.g.
\snippet picture/picture.cpp 3 \snippet picture/picture.cpp 3
\sa inputFormatList() outputFormats() QPictureIO \sa inputFormatList(), outputFormats(), QPictureIO
*/ */
QStringList QPicture::outputFormatList() QStringList QPicture::outputFormatList()
{ {
@ -1259,7 +1259,7 @@ QStringList QPicture::outputFormatList()
Returns a list of picture formats that are supported for picture Returns a list of picture formats that are supported for picture
output. output.
\sa inputFormats() outputFormatList() QPictureIO \sa inputFormats(), outputFormatList(), QPictureIO
*/ */
QList<QByteArray> QPicture::outputFormats() QList<QByteArray> QPicture::outputFormats()
{ {
@ -1288,7 +1288,7 @@ QList<QByteArray> QPicture::outputFormats()
You don't normally need to use this class; QPicture::load(), You don't normally need to use this class; QPicture::load(),
QPicture::save(). QPicture::save().
\sa QPicture QPixmap QFile \sa QPicture, QPixmap, QFile
*/ */
struct QPictureIOData struct QPictureIOData
@ -1581,7 +1581,7 @@ void QPictureIO::setStatus(int status)
reading it. If a format is set the picture will only be read if it reading it. If a format is set the picture will only be read if it
has that format. has that format.
\sa read() write() format() \sa read(), write(), format()
*/ */
void QPictureIO::setFormat(const char *format) void QPictureIO::setFormat(const char *format)
{ {
@ -1619,7 +1619,7 @@ void QPictureIO::setFileName(const QString &fileName)
Returns the quality of the written picture, related to the Returns the quality of the written picture, related to the
compression ratio. compression ratio.
\sa setQuality() QPicture::save() \sa setQuality(), QPicture::save()
*/ */
int QPictureIO::quality() const int QPictureIO::quality() const
{ {
@ -1634,7 +1634,7 @@ int QPictureIO::quality() const
compressed files, 100 for large uncompressed files. (-1 signifies compressed files, 100 for large uncompressed files. (-1 signifies
the default compression.) the default compression.)
\sa quality() QPicture::save() \sa quality(), QPicture::save()
*/ */
void QPictureIO::setQuality(int q) void QPictureIO::setQuality(int q)
@ -1841,7 +1841,7 @@ QList<QByteArray> QPictureIO::outputFormats()
\snippet picture/picture.cpp 4 \snippet picture/picture.cpp 4
\sa setIODevice() setFileName() setFormat() write() QPixmap::load() \sa setIODevice(), setFileName(), setFormat(), write(), QPixmap::load()
*/ */
bool QPictureIO::read() bool QPictureIO::read()
{ {
@ -1910,7 +1910,7 @@ bool QPictureIO::read()
Example: Example:
\snippet picture/picture.cpp 5 \snippet picture/picture.cpp 5
\sa setIODevice() setFileName() setFormat() read() QPixmap::save() \sa setIODevice(), setFileName(), setFormat(), read(), QPixmap::save()
*/ */
bool QPictureIO::write() bool QPictureIO::write()
{ {

8
src/gui/kernel/qclipboard.cpp
View File

@ -345,7 +345,7 @@ void QClipboard::setText(const QString &text, Mode mode)
QClipboard::Selection, the image is retrieved from the global QClipboard::Selection, the image is retrieved from the global
mouse selection. mouse selection.
\sa setImage() pixmap() mimeData(), QImage::isNull() \sa setImage(), pixmap(), mimeData(), QImage::isNull()
*/ */
QImage QClipboard::image(Mode mode) const QImage QClipboard::image(Mode mode) const
{ {
@ -368,7 +368,7 @@ QImage QClipboard::image(Mode mode) const
\snippet code/src_gui_kernel_qclipboard.cpp 1 \snippet code/src_gui_kernel_qclipboard.cpp 1
\sa image(), setPixmap() setMimeData() \sa image(), setPixmap(), setMimeData()
*/ */
void QClipboard::setImage(const QImage &image, Mode mode) void QClipboard::setImage(const QImage &image, Mode mode)
{ {
@ -390,7 +390,7 @@ void QClipboard::setImage(const QImage &image, Mode mode)
QClipboard::Selection, the pixmap is retrieved from the global QClipboard::Selection, the pixmap is retrieved from the global
mouse selection. mouse selection.
\sa setPixmap() image() mimeData() QPixmap::convertFromImage() \sa setPixmap(), image(), mimeData(), QPixmap::convertFromImage()
*/ */
QPixmap QClipboard::pixmap(Mode mode) const QPixmap QClipboard::pixmap(Mode mode) const
{ {
@ -409,7 +409,7 @@ QPixmap QClipboard::pixmap(Mode mode) const
QClipboard::Selection, the pixmap is stored in the global QClipboard::Selection, the pixmap is stored in the global
mouse selection. mouse selection.
\sa pixmap() setImage() setMimeData() \sa pixmap(), setImage(), setMimeData()
*/ */
void QClipboard::setPixmap(const QPixmap &pixmap, Mode mode) void QClipboard::setPixmap(const QPixmap &pixmap, Mode mode)
{ {

67
src/gui/kernel/qevent.cpp
View File

@ -135,7 +135,7 @@ QInputEvent::~QInputEvent()
and QWidget::mouseMoveEvent() to receive mouse events in your own and QWidget::mouseMoveEvent() to receive mouse events in your own
widgets. widgets.
\sa QWidget::setMouseTracking() QWidget::grabMouse() \sa QWidget::setMouseTracking(), QWidget::grabMouse(),
QCursor::pos() QCursor::pos()
*/ */
@ -234,7 +234,7 @@ QMouseEvent::~QMouseEvent()
screen position returned by screenPos() to avoid a shaking screen position returned by screenPos() to avoid a shaking
motion. motion.
\sa x() y() windowPos() screenPos() \sa x(), y(), windowPos(), screenPos()
*/ */
/*! /*!
@ -249,7 +249,7 @@ QMouseEvent::~QMouseEvent()
global position returned by globalPos() to avoid a shaking global position returned by globalPos() to avoid a shaking
motion. motion.
\sa x() y() pos() localPos() screenPos() \sa x(), y(), pos(), localPos(), screenPos()
*/ */
/*! /*!
@ -260,7 +260,7 @@ QMouseEvent::~QMouseEvent()
Returns the position of the mouse cursor as a QPointF, relative to the Returns the position of the mouse cursor as a QPointF, relative to the
screen that received the event. screen that received the event.
\sa x() y() pos() localPos() screenPos() \sa x(), y(), pos(), localPos(), screenPos()
*/ */
/*! /*!
@ -273,7 +273,7 @@ QMouseEvent::~QMouseEvent()
global position returned by globalPos() to avoid a shaking global position returned by globalPos() to avoid a shaking
motion. motion.
\sa x() y() globalPos() \sa x(), y(), globalPos()
*/ */
/*! /*!
@ -286,7 +286,7 @@ QMouseEvent::~QMouseEvent()
pointer position QCursor::pos(), and from pointer position QCursor::pos(), and from
QWidget::mapToGlobal(pos()). QWidget::mapToGlobal(pos()).
\sa globalX() globalY() \sa globalX(), globalY()
*/ */
/*! /*!
@ -295,7 +295,7 @@ QMouseEvent::~QMouseEvent()
Returns the x position of the mouse cursor, relative to the Returns the x position of the mouse cursor, relative to the
widget that received the event. widget that received the event.
\sa y() pos() \sa y(), pos()
*/ */
/*! /*!
@ -304,7 +304,7 @@ QMouseEvent::~QMouseEvent()
Returns the y position of the mouse cursor, relative to the Returns the y position of the mouse cursor, relative to the
widget that received the event. widget that received the event.
\sa x() pos() \sa x(), pos()
*/ */
/*! /*!
@ -313,7 +313,7 @@ QMouseEvent::~QMouseEvent()
Returns the global x position of the mouse cursor at the time of Returns the global x position of the mouse cursor at the time of
the event. the event.
\sa globalY() globalPos() \sa globalY(), globalPos()
*/ */
/*! /*!
@ -322,7 +322,7 @@ QMouseEvent::~QMouseEvent()
Returns the global y position of the mouse cursor at the time of Returns the global y position of the mouse cursor at the time of
the event. the event.
\sa globalX() globalPos() \sa globalX(), globalPos()
*/ */
/*! /*!
@ -333,7 +333,7 @@ QMouseEvent::~QMouseEvent()
Note that the returned value is always Qt::NoButton for mouse Note that the returned value is always Qt::NoButton for mouse
move events. move events.
\sa buttons() Qt::MouseButton \sa buttons(), Qt::MouseButton
*/ */
/*! /*!
@ -347,7 +347,7 @@ QMouseEvent::~QMouseEvent()
event. For mouse release events this excludes the button that event. For mouse release events this excludes the button that
caused the event. caused the event.
\sa button() Qt::MouseButton \sa button(), Qt::MouseButton
*/ */
/*! /*!
@ -473,7 +473,7 @@ QHoverEvent::~QHoverEvent()
The event handler QWidget::wheelEvent() receives wheel events. The event handler QWidget::wheelEvent() receives wheel events.
\sa QMouseEvent QWidget::grabMouse() \sa QMouseEvent, QWidget::grabMouse()
*/ */
/*! /*!
@ -505,7 +505,7 @@ QHoverEvent::~QHoverEvent()
\a modifiers holds the keyboard modifier flags at the time of the \a modifiers holds the keyboard modifier flags at the time of the
event, and \a orient holds the wheel's orientation. event, and \a orient holds the wheel's orientation.
\sa pos() pixelDelta() angleDelta() state() \sa pos(), pixelDelta(), angleDelta(), state()
*/ */
#ifndef QT_NO_WHEELEVENT #ifndef QT_NO_WHEELEVENT
QWheelEvent::QWheelEvent(const QPointF &pos, int delta, QWheelEvent::QWheelEvent(const QPointF &pos, int delta,
@ -536,7 +536,7 @@ QWheelEvent::~QWheelEvent()
\a orient holds the wheel's orientation. \a orient holds the wheel's orientation.
\sa pos() pixelDelta() angleDelta() state() \sa pos(), pixelDelta(), angleDelta(), state()
*/ */
QWheelEvent::QWheelEvent(const QPointF &pos, const QPointF& globalPos, int delta, QWheelEvent::QWheelEvent(const QPointF &pos, const QPointF& globalPos, int delta,
Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers, Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers,
@ -559,7 +559,7 @@ QWheelEvent::QWheelEvent(const QPointF &pos, const QPointF& globalPos, int delta
\a angleDelta contains the rotation distance, and \a angleDelta contains the rotation distance, and
\a orient holds the wheel's orientation. \a orient holds the wheel's orientation.
\sa pos() globalPos() delta() state() \sa pos(), globalPos(), delta(), state()
*/ */
QWheelEvent::QWheelEvent(const QPointF &pos, const QPointF& globalPos, QWheelEvent::QWheelEvent(const QPointF &pos, const QPointF& globalPos,
@ -622,7 +622,7 @@ QWheelEvent::QWheelEvent(const QPointF &pos, const QPointF& globalPos,
If you move your widgets around in response to mouse events, If you move your widgets around in response to mouse events,
use globalPos() instead of this function. use globalPos() instead of this function.
\sa x() y() globalPos() \sa x(), y(), globalPos()
*/ */
/*! /*!
@ -631,7 +631,7 @@ QWheelEvent::QWheelEvent(const QPointF &pos, const QPointF& globalPos,
Returns the x position of the mouse cursor, relative to the Returns the x position of the mouse cursor, relative to the
widget that received the event. widget that received the event.
\sa y() pos() \sa y(), pos()
*/ */
/*! /*!
@ -640,7 +640,7 @@ QWheelEvent::QWheelEvent(const QPointF &pos, const QPointF& globalPos,
Returns the y position of the mouse cursor, relative to the Returns the y position of the mouse cursor, relative to the
widget that received the event. widget that received the event.
\sa x() pos() \sa x(), pos()
*/ */
@ -653,7 +653,7 @@ QWheelEvent::QWheelEvent(const QPointF &pos, const QPointF& globalPos,
mouse events, globalPos() can differ a lot from the current mouse events, globalPos() can differ a lot from the current
cursor position returned by QCursor::pos(). cursor position returned by QCursor::pos().
\sa globalX() globalY() \sa globalX(), globalY()
*/ */
/*! /*!
@ -662,7 +662,7 @@ QWheelEvent::QWheelEvent(const QPointF &pos, const QPointF& globalPos,
Returns the global x position of the mouse cursor at the time of Returns the global x position of the mouse cursor at the time of
the event. the event.
\sa globalY() globalPos() \sa globalY(), globalPos()
*/ */
/*! /*!
@ -671,7 +671,7 @@ QWheelEvent::QWheelEvent(const QPointF &pos, const QPointF& globalPos,
Returns the global y position of the mouse cursor at the time of Returns the global y position of the mouse cursor at the time of
the event. the event.
\sa globalX() globalPos() \sa globalX(), globalPos()
*/ */
/*! /*!
@ -1059,7 +1059,7 @@ QPaintEvent::~QPaintEvent()
Returns the rectangle that needs to be updated. Returns the rectangle that needs to be updated.
\sa region() QPainter::setClipRect() \sa region(), QPainter::setClipRect()
*/ */
/*! /*!
@ -1067,7 +1067,7 @@ QPaintEvent::~QPaintEvent()
Returns the region that needs to be updated. Returns the region that needs to be updated.
\sa rect() QPainter::setClipRegion() \sa rect(), QPainter::setClipRegion()
*/ */
@ -1157,7 +1157,7 @@ QExposeEvent::~QExposeEvent()
The event handler QWidget::resizeEvent() receives resize events. The event handler QWidget::resizeEvent() receives resize events.
\sa QWidget::resize() QWidget::setGeometry() \sa QWidget::resize(), QWidget::setGeometry()
*/ */
/*! /*!
@ -1907,7 +1907,8 @@ QVariant QInputMethodQueryEvent::value(Qt::InputMethodQuery query) const
\a rotation contains the device's rotation in degrees. 4D mice support \a rotation contains the device's rotation in degrees. 4D mice support
rotation. If the device does not support rotation, pass 0 here. rotation. If the device does not support rotation, pass 0 here.
\sa pos() globalPos() device() pressure() xTilt() yTilt() uniqueId(), rotation(), tangentialPressure(), z() \sa pos(), globalPos(), device(), pressure(), xTilt(), yTilt(), uniqueId(), rotation(),
tangentialPressure(), z()
*/ */
QTabletEvent::QTabletEvent(Type type, const QPointF &pos, const QPointF &globalPos, QTabletEvent::QTabletEvent(Type type, const QPointF &pos, const QPointF &globalPos,
@ -2014,7 +2015,7 @@ QTabletEvent::~QTabletEvent()
If you move widgets around in response to mouse events, use If you move widgets around in response to mouse events, use
globalPos() instead of this function. globalPos() instead of this function.
\sa x() y() globalPos() \sa x(), y(), globalPos()
*/ */
/*! /*!
@ -2023,7 +2024,7 @@ QTabletEvent::~QTabletEvent()
Returns the x position of the device, relative to the widget that Returns the x position of the device, relative to the widget that
received the event. received the event.
\sa y() pos() \sa y(), pos()
*/ */
/*! /*!
@ -2032,7 +2033,7 @@ QTabletEvent::~QTabletEvent()
Returns the y position of the device, relative to the widget that Returns the y position of the device, relative to the widget that
received the event. received the event.
\sa x() pos() \sa x(), pos()
*/ */
/*! /*!
@ -2054,7 +2055,7 @@ QTabletEvent::~QTabletEvent()
globalPos() can differ significantly from the current position globalPos() can differ significantly from the current position
QCursor::pos(). QCursor::pos().
\sa globalX() globalY() hiResGlobalPos() \sa globalX(), globalY(), hiResGlobalPos()
*/ */
/*! /*!
@ -2063,7 +2064,7 @@ QTabletEvent::~QTabletEvent()
Returns the global x position of the mouse pointer at the time of Returns the global x position of the mouse pointer at the time of
the event. the event.
\sa globalY() globalPos() hiResGlobalX() \sa globalY(), globalPos(), hiResGlobalX()
*/ */
/*! /*!
@ -2072,7 +2073,7 @@ QTabletEvent::~QTabletEvent()
Returns the global y position of the tablet device at the time of Returns the global y position of the tablet device at the time of
the event. the event.
\sa globalX() globalPos() hiResGlobalY() \sa globalX(), globalPos(), hiResGlobalY()
*/ */
/*! /*!
@ -2104,7 +2105,7 @@ QTabletEvent::~QTabletEvent()
The high precision coordinates delivered from the tablet expressed. The high precision coordinates delivered from the tablet expressed.
Sub pixeling information is in the fractional part of the QPointF. Sub pixeling information is in the fractional part of the QPointF.
\sa globalPos() hiResGlobalX() hiResGlobalY() \sa globalPos(), hiResGlobalX(), hiResGlobalY()
*/ */
/*! /*!

8
src/gui/kernel/qkeysequence.cpp
View File

@ -1593,7 +1593,7 @@ bool QKeySequence::operator==(const QKeySequence &other) const
This function is useful in some circumstances, for example This function is useful in some circumstances, for example
if you want to use QKeySequence objects as keys in a QMap. if you want to use QKeySequence objects as keys in a QMap.
\sa operator==() operator!=() operator>() operator<=() operator>=() \sa operator==(), operator!=(), operator>(), operator<=(), operator>=()
*/ */
bool QKeySequence::operator< (const QKeySequence &other) const bool QKeySequence::operator< (const QKeySequence &other) const
{ {
@ -1609,7 +1609,7 @@ bool QKeySequence::operator< (const QKeySequence &other) const
Returns true if this key sequence is larger than the \a other key Returns true if this key sequence is larger than the \a other key
sequence; otherwise returns false. sequence; otherwise returns false.
\sa operator==() operator!=() operator<() operator<=() operator>=() \sa operator==(), operator!=(), operator<(), operator<=(), operator>=()
*/ */
/*! /*!
@ -1618,7 +1618,7 @@ bool QKeySequence::operator< (const QKeySequence &other) const
Returns true if this key sequence is smaller or equal to the Returns true if this key sequence is smaller or equal to the
\a other key sequence; otherwise returns false. \a other key sequence; otherwise returns false.
\sa operator==() operator!=() operator<() operator>() operator>=() \sa operator==(), operator!=(), operator<(), operator>(), operator>=()
*/ */
/*! /*!
@ -1627,7 +1627,7 @@ bool QKeySequence::operator< (const QKeySequence &other) const
Returns true if this key sequence is larger or equal to the Returns true if this key sequence is larger or equal to the
\a other key sequence; otherwise returns false. \a other key sequence; otherwise returns false.
\sa operator==() operator!=() operator<() operator>() operator<=() \sa operator==(), operator!=(), operator<(), operator>(), operator<=()
*/ */
/*! /*!

56
src/gui/kernel/qpalette.cpp
View File

@ -97,7 +97,7 @@ static void qt_palette_from_color(QPalette &pal, const QColor &button)
Returns the color that has been set for the given color \a role in Returns the color that has been set for the given color \a role in
the current ColorGroup. the current ColorGroup.
\sa brush() ColorRole \sa brush(), ColorRole
*/ */
/*! /*!
@ -108,7 +108,7 @@ static void qt_palette_from_color(QPalette &pal, const QColor &button)
Returns the brush that has been set for the given color \a role in Returns the brush that has been set for the given color \a role in
the current ColorGroup. the current ColorGroup.
\sa color() setBrush() ColorRole \sa color(), setBrush(), ColorRole
*/ */
/*! /*!
@ -119,7 +119,7 @@ static void qt_palette_from_color(QPalette &pal, const QColor &button)
Sets the color used for the given color \a role, in all color Sets the color used for the given color \a role, in all color
groups, to the specified solid \a color. groups, to the specified solid \a color.
\sa brush() setColor() ColorRole \sa brush(), setColor(), ColorRole
*/ */
/*! /*!
@ -128,7 +128,7 @@ static void qt_palette_from_color(QPalette &pal, const QColor &button)
Sets the brush for the given color \a role to the specified \a Sets the brush for the given color \a role to the specified \a
brush for all groups in the palette. brush for all groups in the palette.
\sa brush() setColor() ColorRole \sa brush(), setColor(), ColorRole
*/ */
/*! /*!
@ -144,7 +144,7 @@ static void qt_palette_from_color(QPalette &pal, const QColor &button)
Returns the window text (general foreground) brush of the Returns the window text (general foreground) brush of the
current color group. current color group.
\sa ColorRole brush() \sa ColorRole, brush()
*/ */
/*! /*!
@ -152,7 +152,7 @@ static void qt_palette_from_color(QPalette &pal, const QColor &button)
Returns the button brush of the current color group. Returns the button brush of the current color group.
\sa ColorRole brush() \sa ColorRole, brush()
*/ */
/*! /*!
@ -160,7 +160,7 @@ static void qt_palette_from_color(QPalette &pal, const QColor &button)
Returns the light brush of the current color group. Returns the light brush of the current color group.
\sa ColorRole brush() \sa ColorRole, brush()
*/ */
/*! /*!
@ -168,7 +168,7 @@ static void qt_palette_from_color(QPalette &pal, const QColor &button)
Returns the midlight brush of the current color group. Returns the midlight brush of the current color group.
\sa ColorRole brush() \sa ColorRole, brush()
*/ */
/*! /*!
@ -176,7 +176,7 @@ static void qt_palette_from_color(QPalette &pal, const QColor &button)
Returns the dark brush of the current color group. Returns the dark brush of the current color group.
\sa ColorRole brush() \sa ColorRole, brush()
*/ */
/*! /*!
@ -184,7 +184,7 @@ static void qt_palette_from_color(QPalette &pal, const QColor &button)
Returns the mid brush of the current color group. Returns the mid brush of the current color group.
\sa ColorRole brush() \sa ColorRole, brush()
*/ */
/*! /*!
@ -192,7 +192,7 @@ static void qt_palette_from_color(QPalette &pal, const QColor &button)
Returns the text foreground brush of the current color group. Returns the text foreground brush of the current color group.
\sa ColorRole brush() \sa ColorRole, brush()
*/ */
/*! /*!
@ -200,7 +200,7 @@ static void qt_palette_from_color(QPalette &pal, const QColor &button)
Returns the bright text foreground brush of the current color group. Returns the bright text foreground brush of the current color group.
\sa ColorRole brush() \sa ColorRole, brush()
*/ */
/*! /*!
@ -208,7 +208,7 @@ static void qt_palette_from_color(QPalette &pal, const QColor &button)
Returns the button text foreground brush of the current color group. Returns the button text foreground brush of the current color group.
\sa ColorRole brush() \sa ColorRole, brush()
*/ */
/*! /*!
@ -216,7 +216,7 @@ static void qt_palette_from_color(QPalette &pal, const QColor &button)
Returns the base brush of the current color group. Returns the base brush of the current color group.
\sa ColorRole brush() \sa ColorRole, brush()
*/ */
/*! /*!
@ -224,7 +224,7 @@ static void qt_palette_from_color(QPalette &pal, const QColor &button)
Returns the alternate base brush of the current color group. Returns the alternate base brush of the current color group.
\sa ColorRole brush() \sa ColorRole, brush()
*/ */
/*! /*!
@ -237,7 +237,7 @@ static void qt_palette_from_color(QPalette &pal, const QColor &button)
\note Tool tips use the Inactive color group of QPalette, because tool \note Tool tips use the Inactive color group of QPalette, because tool
tips are not active windows. tips are not active windows.
\sa ColorRole brush() \sa ColorRole, brush()
*/ */
/*! /*!
@ -250,7 +250,7 @@ static void qt_palette_from_color(QPalette &pal, const QColor &button)
\note Tool tips use the Inactive color group of QPalette, because tool \note Tool tips use the Inactive color group of QPalette, because tool
tips are not active windows. tips are not active windows.
\sa ColorRole brush() \sa ColorRole, brush()
*/ */
/*! /*!
@ -266,7 +266,7 @@ static void qt_palette_from_color(QPalette &pal, const QColor &button)
Returns the window (general background) brush of the current Returns the window (general background) brush of the current
color group. color group.
\sa ColorRole brush() \sa ColorRole, brush()
*/ */
/*! /*!
@ -274,7 +274,7 @@ static void qt_palette_from_color(QPalette &pal, const QColor &button)
Returns the shadow brush of the current color group. Returns the shadow brush of the current color group.
\sa ColorRole brush() \sa ColorRole, brush()
*/ */
/*! /*!
@ -282,7 +282,7 @@ static void qt_palette_from_color(QPalette &pal, const QColor &button)
Returns the highlight brush of the current color group. Returns the highlight brush of the current color group.
\sa ColorRole brush() \sa ColorRole, brush()
*/ */
/*! /*!
@ -290,7 +290,7 @@ static void qt_palette_from_color(QPalette &pal, const QColor &button)
Returns the highlighted text brush of the current color group. Returns the highlighted text brush of the current color group.
\sa ColorRole brush() \sa ColorRole, brush()
*/ */
/*! /*!
@ -298,7 +298,7 @@ static void qt_palette_from_color(QPalette &pal, const QColor &button)
Returns the unvisited link text brush of the current color group. Returns the unvisited link text brush of the current color group.
\sa ColorRole brush() \sa ColorRole, brush()
*/ */
/*! /*!
@ -306,7 +306,7 @@ static void qt_palette_from_color(QPalette &pal, const QColor &button)
Returns the visited link text brush of the current color group. Returns the visited link text brush of the current color group.
\sa ColorRole brush() \sa ColorRole, brush()
*/ */
/*! /*!
@ -682,7 +682,7 @@ QPalette::operator QVariant() const
Returns the color in the specified color \a group, used for the Returns the color in the specified color \a group, used for the
given color \a role. given color \a role.
\sa brush() setColor() ColorRole \sa brush(), setColor(), ColorRole
*/ */
/*! /*!
@ -691,7 +691,7 @@ QPalette::operator QVariant() const
Returns the brush in the specified color \a group, used for the Returns the brush in the specified color \a group, used for the
given color \a role. given color \a role.
\sa color() setBrush() ColorRole \sa color(), setBrush(), ColorRole
*/ */
const QBrush &QPalette::brush(ColorGroup gr, ColorRole cr) const const QBrush &QPalette::brush(ColorGroup gr, ColorRole cr) const
{ {
@ -713,7 +713,7 @@ const QBrush &QPalette::brush(ColorGroup gr, ColorRole cr) const
Sets the color in the specified color \a group, used for the given Sets the color in the specified color \a group, used for the given
color \a role, to the specified solid \a color. color \a role, to the specified solid \a color.
\sa setBrush() color() ColorRole \sa setBrush(), color(), ColorRole
*/ */
/*! /*!
@ -723,7 +723,7 @@ const QBrush &QPalette::brush(ColorGroup gr, ColorRole cr) const
Sets the brush in the specified color \a group, used for the given Sets the brush in the specified color \a group, used for the given
color \a role, to \a brush. color \a role, to \a brush.
\sa brush() setColor() ColorRole \sa brush(), setColor(), ColorRole
*/ */
void QPalette::setBrush(ColorGroup cg, ColorRole cr, const QBrush &b) void QPalette::setBrush(ColorGroup cg, ColorRole cr, const QBrush &b)
{ {
@ -1001,7 +1001,7 @@ QDataStream &operator>>(QDataStream &s, QPalette &p)
was subsequently modified; otherwise returns false. This is much was subsequently modified; otherwise returns false. This is much
stricter than equality. stricter than equality.
\sa operator=() operator==() \sa operator=(), operator==()
*/ */
bool QPalette::isCopyOf(const QPalette &p) const bool QPalette::isCopyOf(const QPalette &p) const

4
src/gui/kernel/qplatformintegration_qpa.cpp
View File

@ -163,7 +163,7 @@ QPlatformServices *QPlatformIntegration::services() const
or QWindow::setWindowState(), respectively. or QWindow::setWindowState(), respectively.
\sa QPlatformWindow, QPlatformWindowFormat \sa QPlatformWindow, QPlatformWindowFormat
\sa createPlatformBackingStore(QWindow *window) const \sa createPlatformBackingStore()
*/ */
/*! /*!
@ -174,7 +174,7 @@ QPlatformServices *QPlatformIntegration::services() const
before the QPlatformBackingStore for tlw where the widget also requires a backing store. before the QPlatformBackingStore for tlw where the widget also requires a backing store.
\sa QBackingStore \sa QBackingStore
\sa createPlatformWindow(QWindow *window, WId winId = 0) const \sa createPlatformWindow()
*/ */
/*! /*!

2
src/gui/kernel/qshortcutmap.cpp
View File

@ -316,7 +316,7 @@ QKeySequence::SequenceMatch QShortcutMap::state()
Uses ShortcutOverride event to see if any widgets want to override Uses ShortcutOverride event to see if any widgets want to override
the event. If not, uses nextState(QKeyEvent) to check for a grabbed the event. If not, uses nextState(QKeyEvent) to check for a grabbed
Shortcut, and dispatchEvent() is found an identical. Shortcut, and dispatchEvent() is found an identical.
\sa nextState dispatchEvent \sa nextState, dispatchEvent
*/ */
bool QShortcutMap::tryShortcutEvent(QObject *o, QKeyEvent *e) bool QShortcutMap::tryShortcutEvent(QObject *o, QKeyEvent *e)
{ {

98
src/gui/painting/qcolor.cpp
View File

@ -589,7 +589,7 @@ QStringList QColor::colorNames()
These components can be retrieved individually using the hueF(), These components can be retrieved individually using the hueF(),
saturationF(), valueF() and alphaF() functions. saturationF(), valueF() and alphaF() functions.
\sa setHsv() {QColor#The HSV Color Model}{The HSV Color Model} \sa setHsv(), {QColor#The HSV Color Model}{The HSV Color Model}
*/ */
void QColor::getHsvF(qreal *h, qreal *s, qreal *v, qreal *a) const void QColor::getHsvF(qreal *h, qreal *s, qreal *v, qreal *a) const
{ {
@ -643,8 +643,7 @@ void QColor::getHsv(int *h, int *s, int *v, int *a) const
All the values must be in the range 0.0-1.0. All the values must be in the range 0.0-1.0.
\sa getHsvF(), setHsv(), {QColor#The HSV Color Model}{The HSV \sa getHsvF(), setHsv(), {QColor#The HSV Color Model}{The HSV Color Model}
Color Model}
*/ */
void QColor::setHsvF(qreal h, qreal s, qreal v, qreal a) void QColor::setHsvF(qreal h, qreal s, qreal v, qreal a)
{ {
@ -671,8 +670,7 @@ void QColor::setHsvF(qreal h, qreal s, qreal v, qreal a)
The saturation, value and alpha-channel values must be in the range 0-255, The saturation, value and alpha-channel values must be in the range 0-255,
and the hue value must be greater than -1. and the hue value must be greater than -1.
\sa getHsv(), setHsvF(), {QColor#The HSV Color Model}{The HSV \sa getHsv(), setHsvF(), {QColor#The HSV Color Model}{The HSV Color Model}
Color Model}
*/ */
void QColor::setHsv(int h, int s, int v, int a) void QColor::setHsv(int h, int s, int v, int a)
{ {
@ -978,8 +976,7 @@ void QColor::setRgb(QRgb rgb)
/*! /*!
Returns the alpha color component of this color. Returns the alpha color component of this color.
\sa setAlpha(), alphaF(), {QColor#Alpha-Blended \sa setAlpha(), alphaF(), {QColor#Alpha-Blended Drawing}{Alpha-Blended Drawing}
Drawing}{Alpha-Blended Drawing}
*/ */
int QColor::alpha() const int QColor::alpha() const
{ return ct.argb.alpha >> 8; } { return ct.argb.alpha >> 8; }
@ -989,8 +986,7 @@ int QColor::alpha() const
Sets the alpha of this color to \a alpha. Integer alpha is specified in the Sets the alpha of this color to \a alpha. Integer alpha is specified in the
range 0-255. range 0-255.
\sa alpha(), alphaF(), {QColor#Alpha-Blended \sa alpha(), alphaF(), {QColor#Alpha-Blended Drawing}{Alpha-Blended Drawing}
Drawing}{Alpha-Blended Drawing}
*/ */
void QColor::setAlpha(int alpha) void QColor::setAlpha(int alpha)
@ -1002,8 +998,7 @@ void QColor::setAlpha(int alpha)
/*! /*!
Returns the alpha color component of this color. Returns the alpha color component of this color.
\sa setAlphaF(), alpha(), {QColor#Alpha-Blended \sa setAlphaF(), alpha(), {QColor#Alpha-Blended Drawing}{Alpha-Blended Drawing}
Drawing}{Alpha-Blended Drawing}
*/ */
qreal QColor::alphaF() const qreal QColor::alphaF() const
{ return ct.argb.alpha / qreal(USHRT_MAX); } { return ct.argb.alpha / qreal(USHRT_MAX); }
@ -1012,8 +1007,7 @@ qreal QColor::alphaF() const
Sets the alpha of this color to \a alpha. qreal alpha is specified in the Sets the alpha of this color to \a alpha. qreal alpha is specified in the
range 0.0-1.0. range 0.0-1.0.
\sa alphaF(), alpha(), {QColor#Alpha-Blended \sa alphaF(), alpha(), {QColor#Alpha-Blended Drawing}{Alpha-Blended Drawing}
Drawing}{Alpha-Blended Drawing}
*/ */
void QColor::setAlphaF(qreal alpha) void QColor::setAlphaF(qreal alpha)
@ -1195,8 +1189,7 @@ void QColor::setBlueF(qreal blue)
The color is implicitly converted to HSV. The color is implicitly converted to HSV.
\sa hsvHue(), hueF(), getHsv(), {QColor#The HSV Color Model}{The HSV Color \sa hsvHue(), hueF(), getHsv(), {QColor#The HSV Color Model}{The HSV Color Model}
Model}
*/ */
int QColor::hue() const int QColor::hue() const
@ -1207,8 +1200,7 @@ int QColor::hue() const
/*! /*!
Returns the hue color component of this color. Returns the hue color component of this color.
\sa hueF(), getHsv(), {QColor#The HSV Color Model}{The HSV Color \sa hueF(), getHsv(), {QColor#The HSV Color Model}{The HSV Color Model}
Model}
*/ */
int QColor::hsvHue() const int QColor::hsvHue() const
{ {
@ -1234,8 +1226,7 @@ int QColor::saturation() const
/*! /*!
Returns the saturation color component of this color. Returns the saturation color component of this color.
\sa saturationF(), getHsv(), {QColor#The HSV Color Model}{The HSV Color \sa saturationF(), getHsv(), {QColor#The HSV Color Model}{The HSV Color Model}
Model}
*/ */
int QColor::hsvSaturation() const int QColor::hsvSaturation() const
{ {
@ -1247,8 +1238,7 @@ int QColor::hsvSaturation() const
/*! /*!
Returns the value color component of this color. Returns the value color component of this color.
\sa valueF(), getHsv(), {QColor#The HSV Color Model}{The HSV Color \sa valueF(), getHsv(), {QColor#The HSV Color Model}{The HSV Color Model}
Model}
*/ */
int QColor::value() const int QColor::value() const
{ {
@ -1262,8 +1252,7 @@ int QColor::value() const
The color is implicitly converted to HSV. The color is implicitly converted to HSV.
\sa hsvHueF(), hue(), getHsvF(), {QColor#The HSV Color Model}{The HSV Color \sa hsvHueF(), hue(), getHsvF(), {QColor#The HSV Color Model}{The HSV Color Model}
Model}
*/ */
qreal QColor::hueF() const qreal QColor::hueF() const
{ {
@ -1288,7 +1277,7 @@ qreal QColor::hsvHueF() const
The color is implicitly converted to HSV. The color is implicitly converted to HSV.
\sa hsvSaturationF(), saturation() getHsvF(), {QColor#The HSV Color Model}{The HSV Color \sa hsvSaturationF(), saturation(), getHsvF(), {QColor#The HSV Color Model}{The HSV Color
Model} Model}
*/ */
qreal QColor::saturationF() const qreal QColor::saturationF() const
@ -1299,8 +1288,7 @@ qreal QColor::saturationF() const
/*! /*!
Returns the saturation color component of this color. Returns the saturation color component of this color.
\sa saturation() getHsvF(), {QColor#The HSV Color Model}{The HSV Color \sa saturation(), getHsvF(), {QColor#The HSV Color Model}{The HSV Color Model}
Model}
*/ */
qreal QColor::hsvSaturationF() const qreal QColor::hsvSaturationF() const
{ {
@ -1312,8 +1300,7 @@ qreal QColor::hsvSaturationF() const
/*! /*!
Returns the value color component of this color. Returns the value color component of this color.
\sa value() getHsvF(), {QColor#The HSV Color Model}{The HSV Color \sa value(), getHsvF(), {QColor#The HSV Color Model}{The HSV Color Model}
Model}
*/ */
qreal QColor::valueF() const qreal QColor::valueF() const
{ {
@ -1341,8 +1328,7 @@ int QColor::hslHue() const
Returns the saturation color component of this color. Returns the saturation color component of this color.
\sa saturationF(), getHsv(), {QColor#The HSV Color Model}{The HSV Color \sa saturationF(), getHsv(), {QColor#The HSV Color Model}{The HSV Color Model}
Model}
*/ */
int QColor::hslSaturation() const int QColor::hslSaturation() const
{ {
@ -1384,7 +1370,7 @@ qreal QColor::hslHueF() const
Returns the saturation color component of this color. Returns the saturation color component of this color.
\sa saturationF() getHslF() \sa saturationF(), getHslF()
*/ */
qreal QColor::hslSaturationF() const qreal QColor::hslSaturationF() const
{ {
@ -1398,7 +1384,7 @@ qreal QColor::hslSaturationF() const
Returns the lightness color component of this color. Returns the lightness color component of this color.
\sa value() getHslF() \sa value(), getHslF()
*/ */
qreal QColor::lightnessF() const qreal QColor::lightnessF() const
{ {
@ -1410,8 +1396,7 @@ qreal QColor::lightnessF() const
/*! /*!
Returns the cyan color component of this color. Returns the cyan color component of this color.
\sa cyanF(), getCmyk(), {QColor#The CMYK Color Model}{The CMYK \sa cyanF(), getCmyk(), {QColor#The CMYK Color Model}{The CMYK Color Model}
Color Model}
*/ */
int QColor::cyan() const int QColor::cyan() const
{ {
@ -1423,8 +1408,7 @@ int QColor::cyan() const
/*! /*!
Returns the magenta color component of this color. Returns the magenta color component of this color.
\sa magentaF(), getCmyk(), {QColor#The CMYK Color Model}{The CMYK \sa magentaF(), getCmyk(), {QColor#The CMYK Color Model}{The CMYK Color Model}
Color Model}
*/ */
int QColor::magenta() const int QColor::magenta() const
{ {
@ -1436,8 +1420,7 @@ int QColor::magenta() const
/*! /*!
Returns the yellow color component of this color. Returns the yellow color component of this color.
\sa yellowF(), getCmyk(), {QColor#The CMYK Color Model}{The CMYK \sa yellowF(), getCmyk(), {QColor#The CMYK Color Model}{The CMYK Color Model}
Color Model}
*/ */
int QColor::yellow() const int QColor::yellow() const
{ {
@ -1449,8 +1432,7 @@ int QColor::yellow() const
/*! /*!
Returns the black color component of this color. Returns the black color component of this color.
\sa blackF(), getCmyk(), {QColor#The CMYK Color Model}{The CMYK \sa blackF(), getCmyk(), {QColor#The CMYK Color Model}{The CMYK Color Model}
Color Model}
*/ */
int QColor::black() const int QColor::black() const
@ -1463,8 +1445,7 @@ int QColor::black() const
/*! /*!
Returns the cyan color component of this color. Returns the cyan color component of this color.
\sa cyan(), getCmykF(), {QColor#The CMYK Color Model}{The CMYK \sa cyan(), getCmykF(), {QColor#The CMYK Color Model}{The CMYK Color Model}
Color Model}
*/ */
qreal QColor::cyanF() const qreal QColor::cyanF() const
{ {
@ -1476,8 +1457,7 @@ qreal QColor::cyanF() const
/*! /*!
Returns the magenta color component of this color. Returns the magenta color component of this color.
\sa magenta(), getCmykF(), {QColor#The CMYK Color Model}{The CMYK \sa magenta(), getCmykF(), {QColor#The CMYK Color Model}{The CMYK Color Model}
Color Model}
*/ */
qreal QColor::magentaF() const qreal QColor::magentaF() const
{ {
@ -1489,8 +1469,7 @@ qreal QColor::magentaF() const
/*! /*!
Returns the yellow color component of this color. Returns the yellow color component of this color.
\sa yellow(), getCmykF(), {QColor#The CMYK Color Model}{The CMYK \sa yellow(), getCmykF(), {QColor#The CMYK Color Model}{The CMYK Color Model}
Color Model}
*/ */
qreal QColor::yellowF() const qreal QColor::yellowF() const
{ {
@ -1502,8 +1481,7 @@ qreal QColor::yellowF() const
/*! /*!
Returns the black color component of this color. Returns the black color component of this color.
\sa black(), getCmykF(), {QColor#The CMYK Color Model}{The CMYK \sa black(), getCmykF(), {QColor#The CMYK Color Model}{The CMYK Color Model}
Color Model}
*/ */
qreal QColor::blackF() const qreal QColor::blackF() const
{ {
@ -1661,8 +1639,7 @@ QColor QColor::toRgb() const
/*! /*!
Creates and returns an HSV QColor based on this color. Creates and returns an HSV QColor based on this color.
\sa fromHsv(), convertTo(), isValid(), {QColor#The HSV Color \sa fromHsv(), convertTo(), isValid(), {QColor#The HSV Color Model}{The HSV Color Model}
Model}{The HSV Color Model}
*/ */
QColor QColor::toHsv() const QColor QColor::toHsv() const
{ {
@ -1769,8 +1746,7 @@ QColor QColor::toHsl() const
/*! /*!
Creates and returns a CMYK QColor based on this color. Creates and returns a CMYK QColor based on this color.
\sa fromCmyk(), convertTo(), isValid(), {QColor#The CMYK Color \sa fromCmyk(), convertTo(), isValid(), {QColor#The CMYK Color Model}{The CMYK Color Model}
Model}{The CMYK Color Model}
*/ */
QColor QColor::toCmyk() const QColor QColor::toCmyk() const
{ {
@ -1926,8 +1902,7 @@ QColor QColor::fromRgbF(qreal r, qreal g, qreal b, qreal a)
The value of \a s, \a v, and \a a must all be in the range 0-255; the value The value of \a s, \a v, and \a a must all be in the range 0-255; the value
of \a h must be in the range 0-359. of \a h must be in the range 0-359.
\sa toHsv(), fromHsvF(), isValid(), {QColor#The HSV Color \sa toHsv(), fromHsvF(), isValid(), {QColor#The HSV Color Model}{The HSV Color Model}
Model}{The HSV Color Model}
*/ */
QColor QColor::fromHsv(int h, int s, int v, int a) QColor QColor::fromHsv(int h, int s, int v, int a)
{ {
@ -1958,8 +1933,7 @@ QColor QColor::fromHsv(int h, int s, int v, int a)
All the values must be in the range 0.0-1.0. All the values must be in the range 0.0-1.0.
\sa toHsv(), fromHsv(), isValid(), {QColor#The HSV Color \sa toHsv(), fromHsv(), isValid(), {QColor#The HSV Color Model}{The HSV Color Model}
Model}{The HSV Color Model}
*/ */
QColor QColor::fromHsvF(qreal h, qreal s, qreal v, qreal a) QColor QColor::fromHsvF(qreal h, qreal s, qreal v, qreal a)
{ {
@ -2112,8 +2086,7 @@ void QColor::getCmykF(qreal *c, qreal *m, qreal *y, qreal *k, qreal *a)
All the values must be in the range 0-255. All the values must be in the range 0-255.
\sa getCmyk(), setCmykF(), {QColor#The CMYK Color Model}{The \sa getCmyk(), setCmykF(), {QColor#The CMYK Color Model}{The CMYK Color Model}
CMYK Color Model}
*/ */
void QColor::setCmyk(int c, int m, int y, int k, int a) void QColor::setCmyk(int c, int m, int y, int k, int a)
{ {
@ -2142,8 +2115,7 @@ void QColor::setCmyk(int c, int m, int y, int k, int a)
All the values must be in the range 0.0-1.0. All the values must be in the range 0.0-1.0.
\sa getCmykF() setCmyk(), {QColor#The CMYK Color Model}{The CMYK \sa getCmykF(), setCmyk(), {QColor#The CMYK Color Model}{The CMYK Color Model}
Color Model}
*/ */
void QColor::setCmykF(qreal c, qreal m, qreal y, qreal k, qreal a) void QColor::setCmykF(qreal c, qreal m, qreal y, qreal k, qreal a)
{ {
@ -2171,8 +2143,7 @@ void QColor::setCmykF(qreal c, qreal m, qreal y, qreal k, qreal a)
All the values must be in the range 0-255. All the values must be in the range 0-255.
\sa toCmyk(), fromCmykF(), isValid(), {QColor#The CMYK Color Model}{The CMYK \sa toCmyk(), fromCmykF(), isValid(), {QColor#The CMYK Color Model}{The CMYK Color Model}
Color Model}
*/ */
QColor QColor::fromCmyk(int c, int m, int y, int k, int a) QColor QColor::fromCmyk(int c, int m, int y, int k, int a)
{ {
@ -2204,8 +2175,7 @@ QColor QColor::fromCmyk(int c, int m, int y, int k, int a)
All the values must be in the range 0.0-1.0. All the values must be in the range 0.0-1.0.
\sa toCmyk(), fromCmyk(), isValid(), {QColor#The CMYK Color \sa toCmyk(), fromCmyk(), isValid(), {QColor#The CMYK Color Model}{The CMYK Color Model}
Model}{The CMYK Color Model}
*/ */
QColor QColor::fromCmykF(qreal c, qreal m, qreal y, qreal k, qreal a) QColor QColor::fromCmykF(qreal c, qreal m, qreal y, qreal k, qreal a)
{ {

4
src/gui/painting/qpaintengine.cpp
View File

@ -414,7 +414,7 @@ void QPaintEngine::drawPolygon(const QPoint *points, int pointCount, PolygonDraw
painting is to start on the paint device \a pdev. Return true if painting is to start on the paint device \a pdev. Return true if
the initialization was successful; otherwise return false. the initialization was successful; otherwise return false.
\sa end() isActive() \sa end(), isActive()
*/ */
/*! /*!
@ -424,7 +424,7 @@ void QPaintEngine::drawPolygon(const QPoint *points, int pointCount, PolygonDraw
device. Return true if painting was finished successfully; device. Return true if painting was finished successfully;
otherwise return false. otherwise return false.
\sa begin() isActive() \sa begin(), isActive()
*/ */

16
src/gui/painting/qpainter.cpp
View File

@ -3085,8 +3085,7 @@ bool QPainter::matrixEnabled() const
/*! /*!
Scales the coordinate system by (\a{sx}, \a{sy}). Scales the coordinate system by (\a{sx}, \a{sy}).
\sa setWorldTransform() {QPainter#Coordinate Transformations}{Coordinate \sa setWorldTransform(), {QPainter#Coordinate Transformations}{Coordinate Transformations}
Transformations}
*/ */
void QPainter::scale(qreal sx, qreal sy) void QPainter::scale(qreal sx, qreal sy)
@ -3109,8 +3108,7 @@ void QPainter::scale(qreal sx, qreal sy)
/*! /*!
Shears the coordinate system by (\a{sh}, \a{sv}). Shears the coordinate system by (\a{sh}, \a{sv}).
\sa setWorldTransform(), {QPainter#Coordinate Transformations}{Coordinate \sa setWorldTransform(), {QPainter#Coordinate Transformations}{Coordinate Transformations}
Transformations}
*/ */
void QPainter::shear(qreal sh, qreal sv) void QPainter::shear(qreal sh, qreal sv)
@ -3135,8 +3133,7 @@ void QPainter::shear(qreal sh, qreal sv)
Rotates the coordinate system the given \a angle clockwise. Rotates the coordinate system the given \a angle clockwise.
\sa setWorldTransform(), {QPainter#Coordinate Transformations}{Coordinate \sa setWorldTransform(), {QPainter#Coordinate Transformations}{Coordinate Transformations}
Transformations}
*/ */
void QPainter::rotate(qreal a) void QPainter::rotate(qreal a)
@ -3160,8 +3157,7 @@ void QPainter::rotate(qreal a)
Translates the coordinate system by the given \a offset; i.e. the Translates the coordinate system by the given \a offset; i.e. the
given \a offset is added to points. given \a offset is added to points.
\sa setWorldTransform(), {QPainter#Coordinate Transformations}{Coordinate \sa setWorldTransform(), {QPainter#Coordinate Transformations}{Coordinate Transformations}
Transformations}
*/ */
void QPainter::translate(const QPointF &offset) void QPainter::translate(const QPointF &offset)
{ {
@ -7140,7 +7136,7 @@ QRect QPainter::window() const
The default viewport rectangle is the same as the device's The default viewport rectangle is the same as the device's
rectangle. rectangle.
\sa viewport(), viewTransformEnabled() {Coordinate \sa viewport(), viewTransformEnabled(), {Coordinate
System#Window-Viewport Conversion}{Window-Viewport Conversion} System#Window-Viewport Conversion}{Window-Viewport Conversion}
*/ */
@ -8102,7 +8098,7 @@ qreal QPaintEngineState::opacity() const
If \a combine is true, the specified \a transform is combined with If \a combine is true, the specified \a transform is combined with
the current matrix; otherwise it replaces the current matrix. the current matrix; otherwise it replaces the current matrix.
\sa transform() setWorldTransform() \sa transform(), setWorldTransform()
*/ */
void QPainter::setTransform(const QTransform &transform, bool combine ) void QPainter::setTransform(const QTransform &transform, bool combine )

4
src/gui/painting/qpen.cpp
View File

@ -606,7 +606,7 @@ int QPen::width() const
Returns the pen width with floating point precision. Returns the pen width with floating point precision.
\sa setWidthF() width() \sa setWidthF(), width()
*/ */
qreal QPen::widthF() const qreal QPen::widthF() const
{ {
@ -649,7 +649,7 @@ void QPen::setWidth(int width)
Setting a pen width with a negative value is not supported. Setting a pen width with a negative value is not supported.
\sa setWidth() widthF() \sa setWidth(), widthF()
*/ */
void QPen::setWidthF(qreal width) void QPen::setWidthF(qreal width)

2
src/gui/painting/qpolygon.cpp
View File

@ -306,7 +306,7 @@ void QPolygon::point(int index, int *x, int *y) const
\snippet polygon/polygon.cpp 2 \snippet polygon/polygon.cpp 2
\sa setPoint() putPoints() \sa setPoint(), putPoints()
*/ */
void QPolygon::setPoints(int nPoints, const int *points) void QPolygon::setPoints(int nPoints, const int *points)

52
src/gui/text/qfont.cpp
View File

@ -607,7 +607,7 @@ QFontEngineData::~QFontEngineData()
Returns the family name that corresponds to the current style Returns the family name that corresponds to the current style
hint. hint.
\sa StyleHint styleHint() setStyleHint() \sa StyleHint, styleHint(), setStyleHint()
*/ */
/*! /*!
@ -629,7 +629,7 @@ QFontEngineData::~QFontEngineData()
happens. Please \link bughowto.html report it as a bug\endlink if happens. Please \link bughowto.html report it as a bug\endlink if
it does, preferably with a list of the fonts you have installed. it does, preferably with a list of the fonts you have installed.
\sa lastResortFamily() rawName() \sa lastResortFamily(), rawName()
*/ */
/*! /*!
@ -702,7 +702,7 @@ QFont::QFont()
algorithm. algorithm.
\sa Weight, setFamily(), setPointSize(), setWeight(), setItalic(), \sa Weight, setFamily(), setPointSize(), setWeight(), setItalic(),
setStyleHint() QGuiApplication::font() setStyleHint(), QGuiApplication::font()
*/ */
QFont::QFont(const QString &family, int pointSize, int weight, bool italic) QFont::QFont(const QString &family, int pointSize, int weight, bool italic)
: d(new QFontPrivate()), resolve_mask(QFont::FamilyResolved) : d(new QFontPrivate()), resolve_mask(QFont::FamilyResolved)
@ -758,7 +758,7 @@ QFont &QFont::operator=(const QFont &font)
Returns the requested font family name, i.e. the name set in the Returns the requested font family name, i.e. the name set in the
constructor or the last setFont() call. constructor or the last setFont() call.
\sa setFamily() substitutes() substitute() \sa setFamily(), substitutes(), substitute()
*/ */
QString QFont::family() const QString QFont::family() const
{ {
@ -796,7 +796,7 @@ void QFont::setFamily(const QString &family)
Mac OS X and X11 so far. On Windows irregular styles will be added Mac OS X and X11 so far. On Windows irregular styles will be added
as separate font families so there is no need for this. as separate font families so there is no need for this.
\sa setFamily() setStyle() \sa setFamily(), setStyle()
*/ */
QString QFont::styleName() const QString QFont::styleName() const
{ {
@ -823,7 +823,7 @@ void QFont::setStyleName(const QString &styleName)
Returns the point size of the font. Returns -1 if the font size Returns the point size of the font. Returns -1 if the font size
was specified in pixels. was specified in pixels.
\sa setPointSize() pointSizeF() \sa setPointSize(), pointSizeF()
*/ */
int QFont::pointSize() const int QFont::pointSize() const
{ {
@ -933,7 +933,7 @@ QFont::HintingPreference QFont::hintingPreference() const
Sets the point size to \a pointSize. The point size must be Sets the point size to \a pointSize. The point size must be
greater than zero. greater than zero.
\sa pointSize() setPointSizeF() \sa pointSize(), setPointSizeF()
*/ */
void QFont::setPointSize(int pointSize) void QFont::setPointSize(int pointSize)
{ {
@ -955,7 +955,7 @@ void QFont::setPointSize(int pointSize)
greater than zero. The requested precision may not be achieved on greater than zero. The requested precision may not be achieved on
all platforms. all platforms.
\sa pointSizeF() setPointSize() setPixelSize() \sa pointSizeF(), setPointSize(), setPixelSize()
*/ */
void QFont::setPointSizeF(qreal pointSize) void QFont::setPointSizeF(qreal pointSize)
{ {
@ -976,7 +976,7 @@ void QFont::setPointSizeF(qreal pointSize)
Returns the point size of the font. Returns -1 if the font size was Returns the point size of the font. Returns -1 if the font size was
specified in pixels. specified in pixels.
\sa pointSize() setPointSizeF() pixelSize() QFontInfo::pointSize() QFontInfo::pixelSize() \sa pointSize(), setPointSizeF(), pixelSize(), QFontInfo::pointSize(), QFontInfo::pixelSize()
*/ */
qreal QFont::pointSizeF() const qreal QFont::pointSizeF() const
{ {
@ -1012,7 +1012,7 @@ void QFont::setPixelSize(int pixelSize)
setPixelSize(). Returns -1 if the size was set with setPointSize() setPixelSize(). Returns -1 if the size was set with setPointSize()
or setPointSizeF(). or setPointSizeF().
\sa setPixelSize() pointSize() QFontInfo::pointSize() QFontInfo::pixelSize() \sa setPixelSize(), pointSize(), QFontInfo::pointSize(), QFontInfo::pixelSize()
*/ */
int QFont::pixelSize() const int QFont::pixelSize() const
{ {
@ -1024,7 +1024,7 @@ int QFont::pixelSize() const
Returns true if the style() of the font is not QFont::StyleNormal Returns true if the style() of the font is not QFont::StyleNormal
\sa setItalic() style() \sa setItalic(), style()
*/ */
/*! /*!
@ -1033,7 +1033,7 @@ int QFont::pixelSize() const
Sets the style() of the font to QFont::StyleItalic if \a enable is true; Sets the style() of the font to QFont::StyleItalic if \a enable is true;
otherwise the style is set to QFont::StyleNormal. otherwise the style is set to QFont::StyleNormal.
\sa italic() QFontInfo \sa italic(), QFontInfo
*/ */
/*! /*!
@ -1254,7 +1254,7 @@ void QFont::setKerning(bool enable)
The style strategy affects the \l{QFont}{font matching} algorithm. The style strategy affects the \l{QFont}{font matching} algorithm.
See \l QFont::StyleStrategy for the list of available strategies. See \l QFont::StyleStrategy for the list of available strategies.
\sa setStyleHint() QFont::StyleHint \sa setStyleHint(), QFont::StyleHint
*/ */
QFont::StyleStrategy QFont::styleStrategy() const QFont::StyleStrategy QFont::styleStrategy() const
{ {
@ -1267,7 +1267,7 @@ QFont::StyleStrategy QFont::styleStrategy() const
The style hint affects the \l{QFont}{font matching} algorithm. The style hint affects the \l{QFont}{font matching} algorithm.
See \l QFont::StyleHint for the list of available hints. See \l QFont::StyleHint for the list of available hints.
\sa setStyleHint(), QFont::StyleStrategy QFontInfo::styleHint() \sa setStyleHint(), QFont::StyleStrategy, QFontInfo::styleHint()
*/ */
QFont::StyleHint QFont::styleHint() const QFont::StyleHint QFont::styleHint() const
{ {
@ -1407,7 +1407,7 @@ void QFont::setStyleStrategy(StyleStrategy s)
\value ExtraExpanded 150 \value ExtraExpanded 150
\value UltraExpanded 200 \value UltraExpanded 200
\sa setStretch() stretch() \sa setStretch(), stretch()
*/ */
/*! /*!
@ -1436,7 +1436,7 @@ int QFont::stretch() const
X11, the stretch factor is matched against a predefined set of X11, the stretch factor is matched against a predefined set of
values for the SETWIDTH_NAME field of the XLFD. values for the SETWIDTH_NAME field of the XLFD.
\sa stretch() QFont::Stretch \sa stretch(), QFont::Stretch
*/ */
void QFont::setStretch(int factor) void QFont::setStretch(int factor)
{ {
@ -1647,7 +1647,7 @@ bool QFont::exactMatch() const
equal. If rawMode() is enabled for both fonts, only the family equal. If rawMode() is enabled for both fonts, only the family
fields are compared. fields are compared.
\sa operator!=() isCopyOf() \sa operator!=(), isCopyOf()
*/ */
bool QFont::operator==(const QFont &f) const bool QFont::operator==(const QFont &f) const
{ {
@ -1675,7 +1675,7 @@ bool QFont::operator==(const QFont &f) const
This function is useful in some circumstances, for example if you This function is useful in some circumstances, for example if you
want to use QFont objects as keys in a QMap. want to use QFont objects as keys in a QMap.
\sa operator==() operator!=() isCopyOf() \sa operator==(), operator!=(), isCopyOf()
*/ */
bool QFont::operator<(const QFont &f) const bool QFont::operator<(const QFont &f) const
{ {
@ -1731,7 +1731,7 @@ QFont::operator QVariant() const
one of them was created as a copy of the other and neither has one of them was created as a copy of the other and neither has
been modified since. This is much stricter than equality. been modified since. This is much stricter than equality.
\sa operator=() operator==() \sa operator=(), operator==()
*/ */
bool QFont::isCopyOf(const QFont & f) const bool QFont::isCopyOf(const QFont & f) const
{ {
@ -1742,7 +1742,7 @@ bool QFont::isCopyOf(const QFont & f) const
Returns true if raw mode is used for font name matching; otherwise Returns true if raw mode is used for font name matching; otherwise
returns false. returns false.
\sa setRawMode() rawName() \sa setRawMode(), rawName()
*/ */
bool QFont::rawMode() const bool QFont::rawMode() const
{ {
@ -1797,7 +1797,7 @@ Q_GLOBAL_STATIC(QFontSubst, globalFontSubst)
To obtain a list of substitutions use substitutes(). To obtain a list of substitutions use substitutes().
\sa setFamily() insertSubstitutions() insertSubstitution() removeSubstitutions() \sa setFamily(), insertSubstitutions(), insertSubstitution(), removeSubstitutions()
*/ */
QString QFont::substitute(const QString &familyName) QString QFont::substitute(const QString &familyName)
{ {
@ -1818,7 +1818,7 @@ QString QFont::substitute(const QString &familyName)
If there is no substitution for \a familyName, an empty list is If there is no substitution for \a familyName, an empty list is
returned. returned.
\sa substitute() insertSubstitutions() insertSubstitution() removeSubstitutions() \sa substitute(), insertSubstitutions(), insertSubstitution(), removeSubstitutions()
*/ */
QStringList QFont::substitutes(const QString &familyName) QStringList QFont::substitutes(const QString &familyName)
{ {
@ -1832,7 +1832,7 @@ QStringList QFont::substitutes(const QString &familyName)
Inserts \a substituteName into the substitution Inserts \a substituteName into the substitution
table for the family \a familyName. table for the family \a familyName.
\sa insertSubstitutions() removeSubstitutions() substitutions() substitute() substitutes() \sa insertSubstitutions(), removeSubstitutions(), substitutions(), substitute(), substitutes()
*/ */
void QFont::insertSubstitution(const QString &familyName, void QFont::insertSubstitution(const QString &familyName,
const QString &substituteName) const QString &substituteName)
@ -2266,7 +2266,7 @@ QDataStream &operator>>(QDataStream &s, QFont &font)
info object is \e not updated. info object is \e not updated.
\endlist \endlist
\sa QFont QFontMetrics QFontDatabase \sa QFont, QFontMetrics, QFontDatabase
*/ */
/*! /*!
@ -2343,7 +2343,7 @@ QString QFontInfo::styleName() const
/*! /*!
Returns the point size of the matched window system font. Returns the point size of the matched window system font.
\sa pointSizeF() QFont::pointSize() \sa pointSizeF(), QFont::pointSize()
*/ */
int QFontInfo::pointSize() const int QFontInfo::pointSize() const
{ {
@ -2492,7 +2492,7 @@ bool QFontInfo::fixedPitch() const
Currently only returns the style hint set in QFont. Currently only returns the style hint set in QFont.
\sa QFont::styleHint() QFont::StyleHint \sa QFont::styleHint(), QFont::StyleHint
*/ */
QFont::StyleHint QFontInfo::styleHint() const QFont::StyleHint QFontInfo::styleHint() const
{ {

2
src/gui/text/qfontmetrics.cpp
View File

@ -978,7 +978,7 @@ int QFontMetrics::lineWidth() const
Example: Example:
\snippet code/src_gui_text_qfontmetrics.cpp 1 \snippet code/src_gui_text_qfontmetrics.cpp 1
\sa QFont QFontInfo QFontDatabase \sa QFont, QFontInfo, QFontDatabase
*/ */
/*! /*!

30
src/gui/text/qtextcursor.cpp
View File

@ -1138,7 +1138,7 @@ bool QTextCursor::isNull() const
\a pos using a \c MoveMode specified by \a m. The cursor is positioned \a pos using a \c MoveMode specified by \a m. The cursor is positioned
between characters. between characters.
\sa position() movePosition() anchor() \sa position(), movePosition(), anchor()
*/ */
void QTextCursor::setPosition(int pos, MoveMode m) void QTextCursor::setPosition(int pos, MoveMode m)
{ {
@ -1169,7 +1169,7 @@ void QTextCursor::setPosition(int pos, MoveMode m)
Returns the absolute position of the cursor within the document. Returns the absolute position of the cursor within the document.
The cursor is positioned between characters. The cursor is positioned between characters.
\sa setPosition() movePosition() anchor() positionInBlock() \sa setPosition(), movePosition(), anchor(), positionInBlock()
*/ */
int QTextCursor::position() const int QTextCursor::position() const
{ {
@ -1200,7 +1200,7 @@ int QTextCursor::positionInBlock() const
selection and anchor() marks the other end. Just like the cursor selection and anchor() marks the other end. Just like the cursor
position, the anchor position is between characters. position, the anchor position is between characters.
\sa position() setPosition() movePosition() selectionStart() selectionEnd() \sa position(), setPosition(), movePosition(), selectionStart(), selectionEnd()
*/ */
int QTextCursor::anchor() const int QTextCursor::anchor() const
{ {
@ -1388,7 +1388,7 @@ void QTextCursor::setKeepPositionOnInsert(bool b)
Any ASCII linefeed characters (\\n) in the inserted text are transformed Any ASCII linefeed characters (\\n) in the inserted text are transformed
into unicode block separators, corresponding to insertBlock() calls. into unicode block separators, corresponding to insertBlock() calls.
\sa charFormat() hasSelection() \sa charFormat(), hasSelection()
*/ */
void QTextCursor::insertText(const QString &text) void QTextCursor::insertText(const QString &text)
{ {
@ -1476,7 +1476,7 @@ void QTextCursor::insertText(const QString &text, const QTextCharFormat &_format
If there is no selected text, deletes the character \e at the If there is no selected text, deletes the character \e at the
current cursor position; otherwise deletes the selected text. current cursor position; otherwise deletes the selected text.
\sa deletePreviousChar() hasSelection() clearSelection() \sa deletePreviousChar(), hasSelection(), clearSelection()
*/ */
void QTextCursor::deleteChar() void QTextCursor::deleteChar()
{ {
@ -1500,7 +1500,7 @@ void QTextCursor::deleteChar()
If there is no selected text, deletes the character \e before the If there is no selected text, deletes the character \e before the
current cursor position; otherwise deletes the selected text. current cursor position; otherwise deletes the selected text.
\sa deleteChar() hasSelection() clearSelection() \sa deleteChar(), hasSelection(), clearSelection()
*/ */
void QTextCursor::deletePreviousChar() void QTextCursor::deletePreviousChar()
{ {
@ -1623,7 +1623,7 @@ void QTextCursor::selectedTableCells(int *firstRow, int *numRows, int *firstColu
Note that it does \b{not} delete the text of the selection. Note that it does \b{not} delete the text of the selection.
\sa removeSelectedText() hasSelection() \sa removeSelectedText(), hasSelection()
*/ */
void QTextCursor::clearSelection() void QTextCursor::clearSelection()
{ {
@ -1654,7 +1654,7 @@ void QTextCursor::removeSelectedText()
Returns the start of the selection or position() if the Returns the start of the selection or position() if the
cursor doesn't have a selection. cursor doesn't have a selection.
\sa selectionEnd() position() anchor() \sa selectionEnd(), position(), anchor()
*/ */
int QTextCursor::selectionStart() const int QTextCursor::selectionStart() const
{ {
@ -1667,7 +1667,7 @@ int QTextCursor::selectionStart() const
Returns the end of the selection or position() if the cursor Returns the end of the selection or position() if the cursor
doesn't have a selection. doesn't have a selection.
\sa selectionStart() position() anchor() \sa selectionStart(), position(), anchor()
*/ */
int QTextCursor::selectionEnd() const int QTextCursor::selectionEnd() const
{ {
@ -1770,7 +1770,7 @@ QTextBlock QTextCursor::block() const
/*! /*!
Returns the block format of the block the cursor is in. Returns the block format of the block the cursor is in.
\sa setBlockFormat() charFormat() \sa setBlockFormat(), charFormat()
*/ */
QTextBlockFormat QTextCursor::blockFormat() const QTextBlockFormat QTextCursor::blockFormat() const
{ {
@ -2049,7 +2049,7 @@ void QTextCursor::insertBlock(const QTextBlockFormat &format, const QTextCharFor
list item of a newly created list with the given \a format. Returns list item of a newly created list with the given \a format. Returns
the created list. the created list.
\sa currentList() createList() insertBlock() \sa currentList(), createList(), insertBlock()
*/ */
QTextList *QTextCursor::insertList(const QTextListFormat &format) QTextList *QTextCursor::insertList(const QTextListFormat &format)
{ {
@ -2076,7 +2076,7 @@ QTextList *QTextCursor::insertList(QTextListFormat::Style style)
Creates and returns a new list with the given \a format, and makes the Creates and returns a new list with the given \a format, and makes the
current paragraph the cursor is in the first list item. current paragraph the cursor is in the first list item.
\sa insertList() currentList() \sa insertList(), currentList()
*/ */
QTextList *QTextCursor::createList(const QTextListFormat &format) QTextList *QTextCursor::createList(const QTextListFormat &format)
{ {
@ -2098,7 +2098,7 @@ QTextList *QTextCursor::createList(const QTextListFormat &format)
The style to be used is defined by the QTextListFormat::Style enum. The style to be used is defined by the QTextListFormat::Style enum.
\sa insertList() currentList() \sa insertList(), currentList()
*/ */
QTextList *QTextCursor::createList(QTextListFormat::Style style) QTextList *QTextCursor::createList(QTextListFormat::Style style)
{ {
@ -2111,7 +2111,7 @@ QTextList *QTextCursor::createList(QTextListFormat::Style style)
Returns the current list if the cursor position() is inside a Returns the current list if the cursor position() is inside a
block that is part of a list; otherwise returns 0. block that is part of a list; otherwise returns 0.
\sa insertList() createList() \sa insertList(), createList()
*/ */
QTextList *QTextCursor::currentList() const QTextList *QTextCursor::currentList() const
{ {
@ -2509,7 +2509,7 @@ void QTextCursor::endEditBlock()
one of them was created as a copy of the other and neither has moved since. one of them was created as a copy of the other and neither has moved since.
This is much stricter than equality. This is much stricter than equality.
\sa operator=() operator==() \sa operator=(), operator==()
*/ */
bool QTextCursor::isCopyOf(const QTextCursor &other) const bool QTextCursor::isCopyOf(const QTextCursor &other) const
{ {

4
src/gui/text/qtextdocument.cpp
View File

@ -272,7 +272,7 @@ QTextCodec *Qt::codecForHtml(const QByteArray &ba)
\li Text block group format changes. \li Text block group format changes.
\endlist \endlist
\sa QTextCursor, QTextEdit, \link richtext.html Rich Text Processing\endlink , {Text Object Example} \sa QTextCursor, QTextEdit, {Rich Text Processing}, {Text Object Example}
*/ */
/*! /*!
@ -432,7 +432,7 @@ void QTextDocument::redo(QTextCursor *cursor)
signals are emitted, QTextDocument::undoAvailable() or signals are emitted, QTextDocument::undoAvailable() or
QTextDocument::redoAvailable(). QTextDocument::redoAvailable().
\sa QTextDocument::undoAvailable() QTextDocument::redoAvailable() \sa QTextDocument::undoAvailable(), QTextDocument::redoAvailable()
*/ */
void QTextDocument::clearUndoRedoStacks(Stacks stacksToClear) void QTextDocument::clearUndoRedoStacks(Stacks stacksToClear)
{ {

2
src/gui/text/qtextdocumentfragment.cpp
View File

@ -303,7 +303,7 @@ QTextDocumentFragment::QTextDocumentFragment(const QTextDocument *document)
Creates a QTextDocumentFragment from the \a{cursor}'s selection. Creates a QTextDocumentFragment from the \a{cursor}'s selection.
If the cursor doesn't have a selection, the created fragment is empty. If the cursor doesn't have a selection, the created fragment is empty.
\sa isEmpty() QTextCursor::selection() \sa isEmpty(), QTextCursor::selection()
*/ */
QTextDocumentFragment::QTextDocumentFragment(const QTextCursor &cursor) QTextDocumentFragment::QTextDocumentFragment(const QTextCursor &cursor)
: d(0) : d(0)

92
src/gui/text/qtextformat.cpp
View File

@ -908,7 +908,8 @@ QTextTableCellFormat QTextFormat::toTableCellFormat() const
Returns the value of the property specified by \a propertyId. If the Returns the value of the property specified by \a propertyId. If the
property isn't of QTextFormat::Bool type, false is returned instead. property isn't of QTextFormat::Bool type, false is returned instead.
\sa setProperty() intProperty() doubleProperty() stringProperty() colorProperty() lengthProperty() lengthVectorProperty() Property \sa setProperty(), intProperty(), doubleProperty(), stringProperty(), colorProperty(),
lengthProperty(), lengthVectorProperty(), Property
*/ */
bool QTextFormat::boolProperty(int propertyId) const bool QTextFormat::boolProperty(int propertyId) const
{ {
@ -924,7 +925,8 @@ bool QTextFormat::boolProperty(int propertyId) const
Returns the value of the property specified by \a propertyId. If the Returns the value of the property specified by \a propertyId. If the
property is not of QTextFormat::Integer type, 0 is returned instead. property is not of QTextFormat::Integer type, 0 is returned instead.
\sa setProperty() boolProperty() doubleProperty() stringProperty() colorProperty() lengthProperty() lengthVectorProperty() Property \sa setProperty(), boolProperty(), doubleProperty(), stringProperty(), colorProperty(),
lengthProperty(), lengthVectorProperty(), Property
*/ */
int QTextFormat::intProperty(int propertyId) const int QTextFormat::intProperty(int propertyId) const
{ {
@ -944,7 +946,8 @@ int QTextFormat::intProperty(int propertyId) const
property isn't of QVariant::Double or QMetaType::Float type, 0 is property isn't of QVariant::Double or QMetaType::Float type, 0 is
returned instead. returned instead.
\sa setProperty() boolProperty() intProperty() stringProperty() colorProperty() lengthProperty() lengthVectorProperty() Property \sa setProperty(), boolProperty(), intProperty(), stringProperty(), colorProperty(),
lengthProperty(), lengthVectorProperty(), Property
*/ */
qreal QTextFormat::doubleProperty(int propertyId) const qreal QTextFormat::doubleProperty(int propertyId) const
{ {
@ -961,7 +964,8 @@ qreal QTextFormat::doubleProperty(int propertyId) const
property isn't of QVariant::String type, an empty string is property isn't of QVariant::String type, an empty string is
returned instead. returned instead.
\sa setProperty() boolProperty() intProperty() doubleProperty() colorProperty() lengthProperty() lengthVectorProperty() Property \sa setProperty(), boolProperty(), intProperty(), doubleProperty(), colorProperty(),
lengthProperty(), lengthVectorProperty(), Property
*/ */
QString QTextFormat::stringProperty(int propertyId) const QString QTextFormat::stringProperty(int propertyId) const
{ {
@ -996,7 +1000,8 @@ QColor QTextFormat::colorProperty(int propertyId) const
property isn't of QVariant::Pen type, Qt::NoPen is property isn't of QVariant::Pen type, Qt::NoPen is
returned instead. returned instead.
\sa setProperty() boolProperty() intProperty() doubleProperty() stringProperty() lengthProperty() lengthVectorProperty() Property \sa setProperty(), boolProperty(), intProperty(), doubleProperty(), stringProperty(),
lengthProperty(), lengthVectorProperty(), Property
*/ */
QPen QTextFormat::penProperty(int propertyId) const QPen QTextFormat::penProperty(int propertyId) const
{ {
@ -1013,7 +1018,8 @@ QPen QTextFormat::penProperty(int propertyId) const
property isn't of QVariant::Brush type, Qt::NoBrush is property isn't of QVariant::Brush type, Qt::NoBrush is
returned instead. returned instead.
\sa setProperty() boolProperty() intProperty() doubleProperty() stringProperty() lengthProperty() lengthVectorProperty() Property \sa setProperty(), boolProperty(), intProperty(), doubleProperty(), stringProperty(),
lengthProperty(), lengthVectorProperty(), Property
*/ */
QBrush QTextFormat::brushProperty(int propertyId) const QBrush QTextFormat::brushProperty(int propertyId) const
{ {
@ -1028,7 +1034,8 @@ QBrush QTextFormat::brushProperty(int propertyId) const
/*! /*!
Returns the value of the property given by \a propertyId. Returns the value of the property given by \a propertyId.
\sa setProperty() boolProperty() intProperty() doubleProperty() stringProperty() colorProperty() lengthVectorProperty() Property \sa setProperty(), boolProperty(), intProperty(), doubleProperty(), stringProperty(),
colorProperty(), lengthVectorProperty(), Property
*/ */
QTextLength QTextFormat::lengthProperty(int propertyId) const QTextLength QTextFormat::lengthProperty(int propertyId) const
{ {
@ -1042,7 +1049,8 @@ QTextLength QTextFormat::lengthProperty(int propertyId) const
property isn't of QTextFormat::LengthVector type, an empty length property isn't of QTextFormat::LengthVector type, an empty length
vector is returned instead. vector is returned instead.
\sa setProperty() boolProperty() intProperty() doubleProperty() stringProperty() colorProperty() lengthProperty() Property \sa setProperty(), boolProperty(), intProperty(), doubleProperty(), stringProperty(),
colorProperty(), lengthProperty(), Property
*/ */
QVector<QTextLength> QTextFormat::lengthVectorProperty(int propertyId) const QVector<QTextLength> QTextFormat::lengthVectorProperty(int propertyId) const
{ {
@ -1091,7 +1099,7 @@ void QTextFormat::setProperty(int propertyId, const QVariant &value)
/*! /*!
Sets the value of the property given by \a propertyId to \a value. Sets the value of the property given by \a propertyId to \a value.
\sa lengthVectorProperty() Property \sa lengthVectorProperty(), Property
*/ */
void QTextFormat::setProperty(int propertyId, const QVector<QTextLength> &value) void QTextFormat::setProperty(int propertyId, const QVector<QTextLength> &value)
{ {
@ -1173,7 +1181,7 @@ void QTextFormat::setObjectIndex(int o)
Returns true if the text format has a property with the given \a Returns true if the text format has a property with the given \a
propertyId; otherwise returns false. propertyId; otherwise returns false.
\sa properties() Property \sa properties(), Property
*/ */
bool QTextFormat::hasProperty(int propertyId) const bool QTextFormat::hasProperty(int propertyId) const
{ {
@ -1183,7 +1191,7 @@ bool QTextFormat::hasProperty(int propertyId) const
/* /*
Returns the property type for the given \a propertyId. Returns the property type for the given \a propertyId.
\sa hasProperty() allPropertyIds() Property \sa hasProperty(), allPropertyIds(), Property
*/ */
/*! /*!
@ -1267,7 +1275,7 @@ bool QTextFormat::operator==(const QTextFormat &rhs) const
setAnchorHref() and setAnchorNames() functions are used to specify the setAnchorHref() and setAnchorNames() functions are used to specify the
information about the hyperlink's destination and the anchor's name. information about the hyperlink's destination and the anchor's name.
\sa QTextFormat QTextBlockFormat QTextTableFormat QTextListFormat \sa QTextFormat, QTextBlockFormat, QTextTableFormat, QTextListFormat
*/ */
/*! /*!
@ -1638,7 +1646,7 @@ void QTextCharFormat::setUnderlineStyle(UnderlineStyle style)
Sets the foreground brush to the specified \a brush. The foreground Sets the foreground brush to the specified \a brush. The foreground
brush is mostly used to render text. brush is mostly used to render text.
\sa foreground() clearForeground() setBackground() \sa foreground(), clearForeground(), setBackground()
*/ */
@ -1648,7 +1656,7 @@ void QTextCharFormat::setUnderlineStyle(UnderlineStyle style)
Returns the brush used to render foreground details, such as text, Returns the brush used to render foreground details, such as text,
frame outlines, and table borders. frame outlines, and table borders.
\sa setForeground() clearForeground() background() \sa setForeground(), clearForeground(), background()
*/ */
/*! /*!
@ -1657,7 +1665,7 @@ void QTextCharFormat::setUnderlineStyle(UnderlineStyle style)
Clears the brush used to paint the document's foreground. The default Clears the brush used to paint the document's foreground. The default
brush will be used. brush will be used.
\sa foreground() setForeground() clearBackground() \sa foreground(), setForeground(), clearBackground()
*/ */
@ -1683,7 +1691,7 @@ void QTextCharFormat::setUnderlineStyle(UnderlineStyle style)
Returns true if the text is formatted as an anchor; otherwise Returns true if the text is formatted as an anchor; otherwise
returns false. returns false.
\sa setAnchor() setAnchorHref() setAnchorNames() \sa setAnchor(), setAnchorHref(), setAnchorNames()
*/ */
@ -2044,7 +2052,7 @@ QList<QTextOption::Tab> QTextBlockFormat::tabPositions() const
Sets the paragraph's top \a margin. Sets the paragraph's top \a margin.
\sa topMargin() setBottomMargin() setLeftMargin() setRightMargin() \sa topMargin(), setBottomMargin(), setLeftMargin(), setRightMargin()
*/ */
@ -2053,7 +2061,7 @@ QList<QTextOption::Tab> QTextBlockFormat::tabPositions() const
Returns the paragraph's top margin. Returns the paragraph's top margin.
\sa setTopMargin() bottomMargin() \sa setTopMargin(), bottomMargin()
*/ */
@ -2062,7 +2070,7 @@ QList<QTextOption::Tab> QTextBlockFormat::tabPositions() const
Sets the paragraph's bottom \a margin. Sets the paragraph's bottom \a margin.
\sa bottomMargin() setTopMargin() setLeftMargin() setRightMargin() \sa bottomMargin(), setTopMargin(), setLeftMargin(), setRightMargin()
*/ */
@ -2071,7 +2079,7 @@ QList<QTextOption::Tab> QTextBlockFormat::tabPositions() const
Returns the paragraph's bottom margin. Returns the paragraph's bottom margin.
\sa setBottomMargin() topMargin() \sa setBottomMargin(), topMargin()
*/ */
@ -2081,7 +2089,7 @@ QList<QTextOption::Tab> QTextBlockFormat::tabPositions() const
Sets the paragraph's left \a margin. Indentation can be applied separately Sets the paragraph's left \a margin. Indentation can be applied separately
with setIndent(). with setIndent().
\sa leftMargin() setRightMargin() setTopMargin() setBottomMargin() \sa leftMargin(), setRightMargin(), setTopMargin(), setBottomMargin()
*/ */
@ -2090,7 +2098,7 @@ QList<QTextOption::Tab> QTextBlockFormat::tabPositions() const
Returns the paragraph's left margin. Returns the paragraph's left margin.
\sa setLeftMargin() rightMargin() indent() \sa setLeftMargin(), rightMargin(), indent()
*/ */
@ -2099,7 +2107,7 @@ QList<QTextOption::Tab> QTextBlockFormat::tabPositions() const
Sets the paragraph's right \a margin. Sets the paragraph's right \a margin.
\sa rightMargin() setLeftMargin() setTopMargin() setBottomMargin() \sa rightMargin(), setLeftMargin(), setTopMargin(), setBottomMargin()
*/ */
@ -2108,7 +2116,7 @@ QList<QTextOption::Tab> QTextBlockFormat::tabPositions() const
Returns the paragraph's right margin. Returns the paragraph's right margin.
\sa setRightMargin() leftMargin() \sa setRightMargin(), leftMargin()
*/ */
@ -2119,7 +2127,7 @@ QList<QTextOption::Tab> QTextBlockFormat::tabPositions() const
line of a paragraph to be indented differently to the other lines, line of a paragraph to be indented differently to the other lines,
enhancing the readability of the text. enhancing the readability of the text.
\sa textIndent() setLeftMargin() setRightMargin() setTopMargin() setBottomMargin() \sa textIndent(), setLeftMargin(), setRightMargin(), setTopMargin(), setBottomMargin()
*/ */
@ -2140,7 +2148,7 @@ QList<QTextOption::Tab> QTextBlockFormat::tabPositions() const
The \a indentation is an integer that is multiplied with the document-wide The \a indentation is an integer that is multiplied with the document-wide
standard indent, resulting in the actual indent of the paragraph. standard indent, resulting in the actual indent of the paragraph.
\sa indent() QTextDocument::indentWidth() \sa indent(), QTextDocument::indentWidth()
*/ */
@ -2325,7 +2333,7 @@ QTextListFormat::QTextListFormat(const QTextFormat &fmt)
Sets the list format's \a style. Sets the list format's \a style.
\sa style() Style \sa style(), Style
*/ */
/*! /*!
@ -2333,7 +2341,7 @@ QTextListFormat::QTextListFormat(const QTextFormat &fmt)
Returns the list format's style. Returns the list format's style.
\sa setStyle() Style \sa setStyle(), Style
*/ */
@ -2432,7 +2440,7 @@ QTextListFormat::QTextListFormat(const QTextFormat &fmt)
The validity of a QTextFrameFormat object can be determined with the The validity of a QTextFrameFormat object can be determined with the
isValid() function. isValid() function.
\sa QTextFrame QTextBlockFormat \sa QTextFrame, QTextBlockFormat
*/ */
/*! /*!
@ -2444,7 +2452,7 @@ QTextListFormat::QTextListFormat(const QTextFormat &fmt)
\value FloatLeft \value FloatLeft
\value FloatRight \value FloatRight
\sa position() CssFloat \sa position(), CssFloat
*/ */
/*! /*!
@ -2465,7 +2473,7 @@ QTextListFormat::QTextListFormat(const QTextFormat &fmt)
\value BorderStyle_Inset \value BorderStyle_Inset
\value BorderStyle_Outset \value BorderStyle_Outset
\sa borderStyle() FrameBorderStyle \sa borderStyle(), FrameBorderStyle
*/ */
/*! /*!
@ -2768,7 +2776,7 @@ qreal QTextFrameFormat::rightMargin() const
with a vector containing new constraints. If no constraints are with a vector containing new constraints. If no constraints are
required, clearColumnWidthConstraints() can be used to remove them. required, clearColumnWidthConstraints() can be used to remove them.
\sa QTextTable QTextTableCell QTextLength \sa QTextTable, QTextTableCell, QTextLength
*/ */
/*! /*!
@ -2825,7 +2833,7 @@ QTextTableFormat::QTextTableFormat(const QTextFormat &fmt)
Clears the column width constraints for the table. Clears the column width constraints for the table.
\sa columnWidthConstraints() setColumnWidthConstraints() \sa columnWidthConstraints(), setColumnWidthConstraints()
*/ */
/*! /*!
@ -2833,7 +2841,7 @@ QTextTableFormat::QTextTableFormat(const QTextFormat &fmt)
Sets the column width \a constraints for the table. Sets the column width \a constraints for the table.
\sa columnWidthConstraints() clearColumnWidthConstraints() \sa columnWidthConstraints(), clearColumnWidthConstraints()
*/ */
/*! /*!
@ -2913,7 +2921,7 @@ QTextTableFormat::QTextTableFormat(const QTextFormat &fmt)
Sets the brush use to paint the document's background to the Sets the brush use to paint the document's background to the
\a brush specified. \a brush specified.
\sa background() clearBackground() setForeground() \sa background(), clearBackground(), setForeground()
*/ */
/*! /*!
@ -2921,7 +2929,7 @@ QTextTableFormat::QTextTableFormat(const QTextFormat &fmt)
Returns the brush used to paint the document's background. Returns the brush used to paint the document's background.
\sa setBackground() clearBackground() foreground() \sa setBackground(), clearBackground(), foreground()
*/ */
/*! /*!
@ -2930,7 +2938,7 @@ QTextTableFormat::QTextTableFormat(const QTextFormat &fmt)
Clears the brush used to paint the document's background. The default Clears the brush used to paint the document's background. The default
brush will be used. brush will be used.
\sa background() setBackground() clearForeground() \sa background(), setBackground(), clearForeground()
*/ */
@ -3006,7 +3014,7 @@ QTextImageFormat::QTextImageFormat(const QTextFormat &fmt)
Sets the \a width of the rectangle occupied by the image. Sets the \a width of the rectangle occupied by the image.
\sa width() setHeight() \sa width(), setHeight()
*/ */
@ -3015,7 +3023,7 @@ QTextImageFormat::QTextImageFormat(const QTextFormat &fmt)
Returns the width of the rectangle occupied by the image. Returns the width of the rectangle occupied by the image.
\sa height() setWidth() \sa height(), setWidth()
*/ */
@ -3024,7 +3032,7 @@ QTextImageFormat::QTextImageFormat(const QTextFormat &fmt)
Sets the \a height of the rectangle occupied by the image. Sets the \a height of the rectangle occupied by the image.
\sa height() setWidth() \sa height(), setWidth()
*/ */
@ -3033,7 +3041,7 @@ QTextImageFormat::QTextImageFormat(const QTextFormat &fmt)
Returns the height of the rectangle occupied by the image. Returns the height of the rectangle occupied by the image.
\sa width() setHeight() \sa width(), setHeight()
*/ */
/*! /*!
@ -3262,7 +3270,7 @@ QTextTableCellFormat::QTextTableCellFormat(const QTextFormat &fmt)
setRightPadding(), setTopPadding(), and setBottomPadding(). All the paddings setRightPadding(), setTopPadding(), and setBottomPadding(). All the paddings
can be set at once using setPadding(). can be set at once using setPadding().
\sa QTextFormat QTextBlockFormat QTextTableFormat QTextCharFormat \sa QTextFormat, QTextBlockFormat, QTextTableFormat, QTextCharFormat
*/ */
// ------------------------------------------------------ // ------------------------------------------------------

2
src/gui/text/qtextlist.cpp
View File

@ -139,7 +139,7 @@ int QTextList::count() const
/*! /*!
Returns the \a{i}-th text block in the list. Returns the \a{i}-th text block in the list.
\sa count() itemText() \sa count(), itemText()
*/ */
QTextBlock QTextList::item(int i) const QTextBlock QTextList::item(int i) const
{ {

34
src/gui/text/qtextobject.cpp
View File

@ -115,7 +115,7 @@ QTextObject::~QTextObject()
/*! /*!
Returns the text object's format. Returns the text object's format.
\sa setFormat() document() \sa setFormat(), document()
*/ */
QTextFormat QTextObject::format() const QTextFormat QTextObject::format() const
{ {
@ -201,7 +201,7 @@ QTextDocumentPrivate *QTextObject::docHandle() const
for example, the top-level items in a multi-level list will be separated for example, the top-level items in a multi-level list will be separated
by the items in lower levels of the list. by the items in lower levels of the list.
\sa QTextBlock QTextDocument \sa QTextBlock, QTextDocument
*/ */
void QTextBlockGroupPrivate::markBlocksDirty() void QTextBlockGroupPrivate::markBlocksDirty()
@ -343,7 +343,7 @@ QTextFrameLayoutData::~QTextFrameLayoutData()
QTextFrame::iterator class: this provides read-only access to its QTextFrame::iterator class: this provides read-only access to its
internal list of text blocks and child frames. internal list of text blocks and child frames.
\sa QTextCursor QTextDocument \sa QTextCursor, QTextDocument
*/ */
/*! /*!
@ -357,7 +357,7 @@ QTextFrameLayoutData::~QTextFrameLayoutData()
Returns the parent frame of the current frame. Returns the parent frame of the current frame.
\sa currentFrame() QTextFrame::parentFrame() \sa currentFrame(), QTextFrame::parentFrame()
*/ */
/*! /*!
@ -447,7 +447,7 @@ QList<QTextFrame *> QTextFrame::childFrames() const
Returns the frame's parent frame. If the frame is the root frame of a Returns the frame's parent frame. If the frame is the root frame of a
document, this will return 0. document, this will return 0.
\sa childFrames() QTextDocument::rootFrame() \sa childFrames(), QTextDocument::rootFrame()
*/ */
QTextFrame *QTextFrame::parentFrame() const QTextFrame *QTextFrame::parentFrame() const
{ {
@ -459,7 +459,7 @@ QTextFrame *QTextFrame::parentFrame() const
/*! /*!
Returns the first cursor position inside the frame. Returns the first cursor position inside the frame.
\sa lastCursorPosition() firstPosition() lastPosition() \sa lastCursorPosition(), firstPosition(), lastPosition()
*/ */
QTextCursor QTextFrame::firstCursorPosition() const QTextCursor QTextFrame::firstCursorPosition() const
{ {
@ -470,7 +470,7 @@ QTextCursor QTextFrame::firstCursorPosition() const
/*! /*!
Returns the last cursor position inside the frame. Returns the last cursor position inside the frame.
\sa firstCursorPosition() firstPosition() lastPosition() \sa firstCursorPosition(), firstPosition(), lastPosition()
*/ */
QTextCursor QTextFrame::lastCursorPosition() const QTextCursor QTextFrame::lastCursorPosition() const
{ {
@ -481,7 +481,7 @@ QTextCursor QTextFrame::lastCursorPosition() const
/*! /*!
Returns the first document position inside the frame. Returns the first document position inside the frame.
\sa lastPosition() firstCursorPosition() lastCursorPosition() \sa lastPosition(), firstCursorPosition(), lastCursorPosition()
*/ */
int QTextFrame::firstPosition() const int QTextFrame::firstPosition() const
{ {
@ -494,7 +494,7 @@ int QTextFrame::firstPosition() const
/*! /*!
Returns the last document position inside the frame. Returns the last document position inside the frame.
\sa firstPosition() firstCursorPosition() lastCursorPosition() \sa firstPosition(), firstCursorPosition(), lastCursorPosition()
*/ */
int QTextFrame::lastPosition() const int QTextFrame::lastPosition() const
{ {
@ -718,7 +718,7 @@ QTextBlock QTextFrame::iterator::currentBlock() const
/*! /*!
Moves the iterator to the next frame or block. Moves the iterator to the next frame or block.
\sa currentBlock() currentFrame() \sa currentBlock(), currentFrame()
*/ */
QTextFrame::iterator &QTextFrame::iterator::operator++() QTextFrame::iterator &QTextFrame::iterator::operator++()
{ {
@ -756,7 +756,7 @@ QTextFrame::iterator &QTextFrame::iterator::operator++()
/*! /*!
Moves the iterator to the previous frame or block. Moves the iterator to the previous frame or block.
\sa currentBlock() currentFrame() \sa currentBlock(), currentFrame()
*/ */
QTextFrame::iterator &QTextFrame::iterator::operator--() QTextFrame::iterator &QTextFrame::iterator::operator--()
{ {
@ -864,7 +864,7 @@ QTextBlockUserData::~QTextBlockUserData()
\img qtextblock-sequence.png \img qtextblock-sequence.png
\sa QTextBlockFormat QTextCharFormat QTextFragment \sa QTextBlockFormat, QTextCharFormat, QTextFragment
*/ */
/*! /*!
@ -1027,7 +1027,7 @@ int QTextBlock::position() const
\note The length returned includes all formatting characters, \note The length returned includes all formatting characters,
for example, newline. for example, newline.
\sa text() charFormat() blockFormat() \sa text(), charFormat(), blockFormat()
*/ */
int QTextBlock::length() const int QTextBlock::length() const
{ {
@ -1195,7 +1195,7 @@ Qt::LayoutDirection QTextBlock::textDirection() const
/*! /*!
Returns the block's contents as plain text. Returns the block's contents as plain text.
\sa length() charFormat() blockFormat() \sa length(), charFormat(), blockFormat()
*/ */
QString QTextBlock::text() const QString QTextBlock::text() const
{ {
@ -1468,7 +1468,7 @@ QTextBlock::iterator QTextBlock::begin() const
Returns a text block iterator pointing to the end of the text Returns a text block iterator pointing to the end of the text
block. block.
\sa begin() next() previous() \sa begin(), next(), previous()
*/ */
QTextBlock::iterator QTextBlock::end() const QTextBlock::iterator QTextBlock::end() const
{ {
@ -1489,7 +1489,7 @@ QTextBlock::iterator QTextBlock::end() const
Note that the next block may be in a different frame or table to this block. Note that the next block may be in a different frame or table to this block.
\sa previous() begin() end() \sa previous(), begin(), end()
*/ */
QTextBlock QTextBlock::next() const QTextBlock QTextBlock::next() const
{ {
@ -1505,7 +1505,7 @@ QTextBlock QTextBlock::next() const
Note that the next block may be in a different frame or table to this block. Note that the next block may be in a different frame or table to this block.
\sa next() begin() end() \sa next(), begin(), end()
*/ */
QTextBlock QTextBlock::previous() const QTextBlock QTextBlock::previous() const
{ {

18
src/gui/text/qtexttable.cpp
View File

@ -76,7 +76,7 @@ QT_BEGIN_NAMESPACE
contents. The firstCursorPosition() and lastCursorPosition() functions contents. The firstCursorPosition() and lastCursorPosition() functions
are used to obtain the extent of the cell in the document. are used to obtain the extent of the cell in the document.
\sa QTextTable QTextTableFormat \sa QTextTable, QTextTableFormat
*/ */
/*! /*!
@ -583,7 +583,7 @@ QTextTable::~QTextTable()
Returns the table cell at the given \a row and \a column in the table. Returns the table cell at the given \a row and \a column in the table.
\sa columns() rows() \sa columns(), rows()
*/ */
QTextTableCell QTextTable::cellAt(int row, int col) const QTextTableCell QTextTable::cellAt(int row, int col) const
{ {
@ -639,7 +639,7 @@ QTextTableCell QTextTable::cellAt(const QTextCursor &c) const
Resizes the table to contain the required number of \a rows and \a columns. Resizes the table to contain the required number of \a rows and \a columns.
\sa insertRows() insertColumns() removeRows() removeColumns() \sa insertRows(), insertColumns(), removeRows(), removeColumns()
*/ */
void QTextTable::resize(int rows, int cols) void QTextTable::resize(int rows, int cols)
{ {
@ -673,7 +673,7 @@ void QTextTable::resize(int rows, int cols)
Inserts a number of \a rows before the row with the specified \a index. Inserts a number of \a rows before the row with the specified \a index.
\sa resize() insertColumns() removeRows() removeColumns() appendRows() appendColumns() \sa resize(), insertColumns(), removeRows(), removeColumns(), appendRows(), appendColumns()
*/ */
void QTextTable::insertRows(int pos, int num) void QTextTable::insertRows(int pos, int num)
{ {
@ -735,7 +735,7 @@ void QTextTable::insertRows(int pos, int num)
Inserts a number of \a columns before the column with the specified \a index. Inserts a number of \a columns before the column with the specified \a index.
\sa insertRows() resize() removeRows() removeColumns() appendRows() appendColumns() \sa insertRows(), resize(), removeRows(), removeColumns(), appendRows(), appendColumns()
*/ */
void QTextTable::insertColumns(int pos, int num) void QTextTable::insertColumns(int pos, int num)
{ {
@ -816,7 +816,7 @@ void QTextTable::insertColumns(int pos, int num)
\since 4.5 \since 4.5
Appends \a count rows at the bottom of the table. Appends \a count rows at the bottom of the table.
\sa insertColumns() insertRows() resize() removeRows() removeColumns() appendColumns() \sa insertColumns(), insertRows(), resize(), removeRows(), removeColumns(), appendColumns()
*/ */
void QTextTable::appendRows(int count) void QTextTable::appendRows(int count)
{ {
@ -827,7 +827,7 @@ void QTextTable::appendRows(int count)
\since 4.5 \since 4.5
Appends \a count columns at the right side of the table. Appends \a count columns at the right side of the table.
\sa insertColumns() insertRows() resize() removeRows() removeColumns() appendRows() \sa insertColumns(), insertRows(), resize(), removeRows(), removeColumns(), appendRows()
*/ */
void QTextTable::appendColumns(int count) void QTextTable::appendColumns(int count)
{ {
@ -839,7 +839,7 @@ void QTextTable::appendColumns(int count)
Removes a number of \a rows starting with the row at the specified \a index. Removes a number of \a rows starting with the row at the specified \a index.
\sa insertRows(), insertColumns(), resize(), removeColumns() appendRows() appendColumns() \sa insertRows(), insertColumns(), resize(), removeColumns(), appendRows(), appendColumns()
*/ */
void QTextTable::removeRows(int pos, int num) void QTextTable::removeRows(int pos, int num)
{ {
@ -901,7 +901,7 @@ void QTextTable::removeRows(int pos, int num)
Removes a number of \a columns starting with the column at the specified Removes a number of \a columns starting with the column at the specified
\a index. \a index.
\sa insertRows() insertColumns() removeRows() resize() appendRows() appendColumns() \sa insertRows(), insertColumns(), removeRows(), resize(), appendRows(), appendColumns()
*/ */
void QTextTable::removeColumns(int pos, int num) void QTextTable::removeColumns(int pos, int num)
{ {

2
src/gui/util/qdesktopservices.cpp
View File

@ -269,7 +269,7 @@ void QDesktopServices::unsetUrlHandler(const QString &scheme)
\value CacheLocation Returns a directory location where user-specific \value CacheLocation Returns a directory location where user-specific
non-essential (cached) data should be written. non-essential (cached) data should be written.
\sa storageLocation() displayName() \sa storageLocation(), displayName()
*/ */
/*! /*!

2
src/gui/util/qvalidator.cpp
View File

@ -248,7 +248,7 @@ QLocale QValidator::locale() const
locale set with QLocale::setDefault(). If a default locale has not locale set with QLocale::setDefault(). If a default locale has not
been set, it is the operating system's locale. been set, it is the operating system's locale.
\sa locale() QLocale::setDefault() \sa locale(), QLocale::setDefault()
*/ */
void QValidator::setLocale(const QLocale &locale) void QValidator::setLocale(const QLocale &locale)
{ {

2
src/network/ssl/qsslconfiguration.cpp
View File

@ -104,7 +104,7 @@ const QSsl::SslOptions QSslConfigurationPrivate::defaultSslOptions = QSsl::SslOp
\snippet code/src_network_ssl_qsslconfiguration.cpp 0 \snippet code/src_network_ssl_qsslconfiguration.cpp 0
\sa QSsl::SslProtocol, QSslCertificate, QSslCipher, QSslKey \sa QSsl::SslProtocol, QSslCertificate, QSslCipher, QSslKey,
QSslSocket, QNetworkAccessManager, QSslSocket, QNetworkAccessManager,
QSslSocket::sslConfiguration(), QSslSocket::setSslConfiguration() QSslSocket::sslConfiguration(), QSslSocket::setSslConfiguration()
*/ */

4
src/plugins/accessible/widgets/complexwidgets.cpp
View File

@ -211,7 +211,7 @@ QString QAccessibleTabBar::text(QAccessible::Text t) const
to and including the item with index \a child. Returns true if a to and including the item with index \a child. Returns true if a
selection was made or extended; otherwise returns false. selection was made or extended; otherwise returns false.
\sa selection() clearSelection() \sa selection(), clearSelection()
*/ */
bool QAccessibleTabBar::setSelected(int child, bool on, bool extend) bool QAccessibleTabBar::setSelected(int child, bool on, bool extend)
{ {
@ -228,7 +228,7 @@ bool QAccessibleTabBar::setSelected(int child, bool on, bool extend)
Returns a (possibly empty) list of indexes of the items selected Returns a (possibly empty) list of indexes of the items selected
in the list box. in the list box.
\sa setSelected() clearSelection() \sa setSelected(), clearSelection()
*/ */
QVector<int> QAccessibleTabBar::selection() const QVector<int> QAccessibleTabBar::selection() const
{ {

12
src/printsupport/kernel/qprinter.cpp
View File

@ -573,7 +573,7 @@ void QPrinterPrivate::init(QPrinter::PrinterMode mode)
Note that changing the engines will reset the printer state and Note that changing the engines will reset the printer state and
all its properties. all its properties.
\sa printEngine() paintEngine() setOutputFormat() \sa printEngine(), paintEngine(), setOutputFormat()
\since 4.1 \since 4.1
*/ */
@ -812,7 +812,7 @@ QString QPrinter::outputFileName() const
Mac OS X can generate PDF's from its print engine, set the output format Mac OS X can generate PDF's from its print engine, set the output format
back to NativeFormat. back to NativeFormat.
\sa outputFileName() setOutputToFile() setOutputFormat() \sa outputFileName(), setOutputToFile(), setOutputFormat()
*/ */
void QPrinter::setOutputFileName(const QString &fileName) void QPrinter::setOutputFileName(const QString &fileName)
@ -971,7 +971,7 @@ void QPrinter::setOrientation(Orientation orientation)
\since 4.4 \since 4.4
Returns the printer paper size. The default value is driver-dependent. Returns the printer paper size. The default value is driver-dependent.
\sa setPaperSize() pageRect() paperRect() \sa setPaperSize(), pageRect(), paperRect()
*/ */
QPrinter::PaperSize QPrinter::paperSize() const QPrinter::PaperSize QPrinter::paperSize() const
@ -992,7 +992,7 @@ QPrinter::PaperSize QPrinter::paperSize() const
This function is useful mostly for setting a default value that This function is useful mostly for setting a default value that
the user can override in the print dialog. the user can override in the print dialog.
\sa paperSize() PaperSize setFullPage() setResolution() pageRect() paperRect() \sa paperSize(), PaperSize, setFullPage(), setResolution(), pageRect(), paperRect()
*/ */
void QPrinter::setPaperSize(PaperSize newPaperSize) void QPrinter::setPaperSize(PaperSize newPaperSize)
{ {
@ -1351,7 +1351,7 @@ void QPrinter::setFullPage(bool fp)
See setFullPage() for details and caveats. See setFullPage() for details and caveats.
\sa setFullPage() PaperSize \sa setFullPage(), PaperSize
*/ */
bool QPrinter::fullPage() const bool QPrinter::fullPage() const
@ -1371,7 +1371,7 @@ bool QPrinter::fullPage() const
This function must be called before QPainter::begin() to have an effect on This function must be called before QPainter::begin() to have an effect on
all platforms. all platforms.
\sa resolution() setPaperSize() \sa resolution(), setPaperSize()
*/ */
void QPrinter::setResolution(int dpi) void QPrinter::setResolution(int dpi)

2
src/tools/qdoc/doc/qdoc-manual.qdoc
View File

@ -6378,7 +6378,7 @@
should be set at application startup, before any non-GUI should be set at application startup, before any non-GUI
threads are created. threads are created.
\sa system() c() \sa system(), c()
* / * /
void QLocale::setDefault(const QLocale &locale) void QLocale::setDefault(const QLocale &locale)
{ {

4
src/widgets/dialogs/qdialog.cpp
View File

@ -579,7 +579,7 @@ void QDialog::done(int r)
/*! /*!
Hides the modal dialog and sets the result code to \c Accepted. Hides the modal dialog and sets the result code to \c Accepted.
\sa reject() done() \sa reject(), done()
*/ */
void QDialog::accept() void QDialog::accept()
@ -590,7 +590,7 @@ void QDialog::accept()
/*! /*!
Hides the modal dialog and sets the result code to \c Rejected. Hides the modal dialog and sets the result code to \c Rejected.
\sa accept() done() \sa accept(), done()
*/ */
void QDialog::reject() void QDialog::reject()

2
src/widgets/dialogs/qsidebar.cpp
View File

@ -355,7 +355,7 @@ void QUrlModel::layoutChanged()
/*! /*!
The following path changed data update our copy of that data The following path changed data update our copy of that data
\sa layoutChanged() dataChanged() \sa layoutChanged(), dataChanged()
*/ */
void QUrlModel::changed(const QString &path) void QUrlModel::changed(const QString &path)
{ {

2
src/widgets/graphicsview/qgraphicsitem.cpp
View File

@ -2057,7 +2057,7 @@ void QGraphicsItem::setPanelModality(PanelModality panelModality)
This function always returns false for items not in a scene. This function always returns false for items not in a scene.
\sa panelModality() setPanelModality() PanelModality \sa panelModality(), setPanelModality(), PanelModality
*/ */
bool QGraphicsItem::isBlockedByModalPanel(QGraphicsItem **blockingPanel) const bool QGraphicsItem::isBlockedByModalPanel(QGraphicsItem **blockingPanel) const
{ {

8
src/widgets/graphicsview/qgraphicswidget.cpp
View File

@ -1890,7 +1890,7 @@ QGraphicsWidget *QGraphicsWidget::focusWidget() const
key sequence, so are much easier to use than this low-level key sequence, so are much easier to use than this low-level
function. function.
\sa releaseShortcut() setShortcutEnabled() QWidget::grabShortcut() \sa releaseShortcut(), setShortcutEnabled(), QWidget::grabShortcut()
*/ */
int QGraphicsWidget::grabShortcut(const QKeySequence &sequence, Qt::ShortcutContext context) int QGraphicsWidget::grabShortcut(const QKeySequence &sequence, Qt::ShortcutContext context)
{ {
@ -1916,7 +1916,7 @@ int QGraphicsWidget::grabShortcut(const QKeySequence &sequence, Qt::ShortcutCont
this low-level function. Note also that this is an expensive this low-level function. Note also that this is an expensive
operation. operation.
\sa grabShortcut() setShortcutEnabled() , QWidget::releaseShortcut() \sa grabShortcut(), setShortcutEnabled(), QWidget::releaseShortcut()
*/ */
void QGraphicsWidget::releaseShortcut(int id) void QGraphicsWidget::releaseShortcut(int id)
{ {
@ -1937,7 +1937,7 @@ void QGraphicsWidget::releaseShortcut(int id)
to use QAction or QShortcut to handle shortcuts, since they are to use QAction or QShortcut to handle shortcuts, since they are
easier to use than this low-level function. easier to use than this low-level function.
\sa grabShortcut() releaseShortcut(), QWidget::setShortcutEnabled() \sa grabShortcut(), releaseShortcut(), QWidget::setShortcutEnabled()
*/ */
void QGraphicsWidget::setShortcutEnabled(int id, bool enabled) void QGraphicsWidget::setShortcutEnabled(int id, bool enabled)
{ {
@ -1952,7 +1952,7 @@ void QGraphicsWidget::setShortcutEnabled(int id, bool enabled)
If \a enabled is true, auto repeat of the shortcut with the If \a enabled is true, auto repeat of the shortcut with the
given \a id is enabled; otherwise it is disabled. given \a id is enabled; otherwise it is disabled.
\sa grabShortcut() releaseShortcut() QWidget::setShortcutAutoRepeat() \sa grabShortcut(), releaseShortcut(), QWidget::setShortcutAutoRepeat()
*/ */
void QGraphicsWidget::setShortcutAutoRepeat(int id, bool enabled) void QGraphicsWidget::setShortcutAutoRepeat(int id, bool enabled)
{ {

2
src/widgets/itemviews/qabstractitemdelegate.cpp
View File

@ -232,7 +232,7 @@ QAbstractItemDelegate::~QAbstractItemDelegate()
editor paints its own background (e.g., with editor paints its own background (e.g., with
\l{QWidget::}{setAutoFillBackground()}). \l{QWidget::}{setAutoFillBackground()}).
\sa destroyEditor() setModelData() setEditorData() \sa destroyEditor(), setModelData(), setEditorData()
*/ */
QWidget *QAbstractItemDelegate::createEditor(QWidget *, QWidget *QAbstractItemDelegate::createEditor(QWidget *,
const QStyleOptionViewItem &, const QStyleOptionViewItem &,

26
src/widgets/itemviews/qabstractitemview.cpp
View File

@ -1009,7 +1009,7 @@ QAbstractItemDelegate *QAbstractItemView::itemDelegate(const QModelIndex &index)
and, in many-item selections, whether the selection must be a and, in many-item selections, whether the selection must be a
continuous range of items. continuous range of items.
\sa SelectionMode SelectionBehavior \sa SelectionMode, SelectionBehavior
*/ */
void QAbstractItemView::setSelectionMode(SelectionMode mode) void QAbstractItemView::setSelectionMode(SelectionMode mode)
{ {
@ -1030,7 +1030,7 @@ QAbstractItemView::SelectionMode QAbstractItemView::selectionMode() const
This property holds whether selections are done This property holds whether selections are done
in terms of single items, rows or columns. in terms of single items, rows or columns.
\sa SelectionMode SelectionBehavior \sa SelectionMode, SelectionBehavior
*/ */
void QAbstractItemView::setSelectionBehavior(QAbstractItemView::SelectionBehavior behavior) void QAbstractItemView::setSelectionBehavior(QAbstractItemView::SelectionBehavior behavior)
@ -1383,7 +1383,7 @@ bool QAbstractItemView::tabKeyNavigation() const
\property QAbstractItemView::showDropIndicator \property QAbstractItemView::showDropIndicator
\brief whether the drop indicator is shown when dragging items and dropping. \brief whether the drop indicator is shown when dragging items and dropping.
\sa dragEnabled DragDropMode dragDropOverwriteMode acceptDrops \sa dragEnabled, DragDropMode, dragDropOverwriteMode, acceptDrops
*/ */
void QAbstractItemView::setDropIndicatorShown(bool enable) void QAbstractItemView::setDropIndicatorShown(bool enable)
@ -1402,7 +1402,7 @@ bool QAbstractItemView::showDropIndicator() const
\property QAbstractItemView::dragEnabled \property QAbstractItemView::dragEnabled
\brief whether the view supports dragging of its own items \brief whether the view supports dragging of its own items
\sa showDropIndicator DragDropMode dragDropOverwriteMode acceptDrops \sa showDropIndicator, DragDropMode, dragDropOverwriteMode, acceptDrops
*/ */
void QAbstractItemView::setDragEnabled(bool enable) void QAbstractItemView::setDragEnabled(bool enable)
@ -1434,7 +1434,7 @@ bool QAbstractItemView::dragEnabled() const
Note that the model used needs to provide support for drag and drop operations. Note that the model used needs to provide support for drag and drop operations.
\sa setDragDropMode() {Using drag and drop with item views} \sa setDragDropMode(), {Using drag and drop with item views}
*/ */
/*! /*!
@ -1442,7 +1442,7 @@ bool QAbstractItemView::dragEnabled() const
\brief the drag and drop event the view will act upon \brief the drag and drop event the view will act upon
\since 4.2 \since 4.2
\sa showDropIndicator dragDropOverwriteMode \sa showDropIndicator, dragDropOverwriteMode
*/ */
void QAbstractItemView::setDragDropMode(DragDropMode behavior) void QAbstractItemView::setDragDropMode(DragDropMode behavior)
{ {
@ -1483,7 +1483,7 @@ QAbstractItemView::DragDropMode QAbstractItemView::dragDropMode() const
actions support CopyAction. actions support CopyAction.
\since 4.6 \since 4.6
\sa showDropIndicator dragDropOverwriteMode \sa showDropIndicator, dragDropOverwriteMode
*/ */
void QAbstractItemView::setDefaultDropAction(Qt::DropAction dropAction) void QAbstractItemView::setDefaultDropAction(Qt::DropAction dropAction)
{ {
@ -1905,7 +1905,7 @@ void QAbstractItemView::mouseDoubleClickEvent(QMouseEvent *event)
the widget. If the drag is over a valid dropping place (e.g. over an item that the widget. If the drag is over a valid dropping place (e.g. over an item that
accepts drops), the event is accepted; otherwise it is ignored. accepts drops), the event is accepted; otherwise it is ignored.
\sa dropEvent() startDrag() \sa dropEvent(), startDrag()
*/ */
void QAbstractItemView::dragEnterEvent(QDragEnterEvent *event) void QAbstractItemView::dragEnterEvent(QDragEnterEvent *event)
{ {
@ -1927,7 +1927,7 @@ void QAbstractItemView::dragEnterEvent(QDragEnterEvent *event)
the user drags a selection to view's right or bottom edge. In this case, the the user drags a selection to view's right or bottom edge. In this case, the
event will be accepted; otherwise it will be ignored. event will be accepted; otherwise it will be ignored.
\sa dropEvent() startDrag() \sa dropEvent(), startDrag()
*/ */
void QAbstractItemView::dragMoveEvent(QDragMoveEvent *event) void QAbstractItemView::dragMoveEvent(QDragMoveEvent *event)
{ {
@ -2863,7 +2863,7 @@ void QAbstractItemView::editorDestroyed(QObject *editor)
Note that if the view has a horizontal header, the item steps Note that if the view has a horizontal header, the item steps
will be ignored and the header section size will be used instead. will be ignored and the header section size will be used instead.
\sa horizontalStepsPerItem() setVerticalStepsPerItem() \sa horizontalStepsPerItem(), setVerticalStepsPerItem()
*/ */
void QAbstractItemView::setHorizontalStepsPerItem(int steps) void QAbstractItemView::setHorizontalStepsPerItem(int steps)
{ {
@ -2875,7 +2875,7 @@ void QAbstractItemView::setHorizontalStepsPerItem(int steps)
\obsolete \obsolete
Returns the horizontal scroll bar's steps per item. Returns the horizontal scroll bar's steps per item.
\sa setHorizontalStepsPerItem() verticalStepsPerItem() \sa setHorizontalStepsPerItem(), verticalStepsPerItem()
*/ */
int QAbstractItemView::horizontalStepsPerItem() const int QAbstractItemView::horizontalStepsPerItem() const
{ {
@ -2892,7 +2892,7 @@ int QAbstractItemView::horizontalStepsPerItem() const
Note that if the view has a vertical header, the item steps Note that if the view has a vertical header, the item steps
will be ignored and the header section size will be used instead. will be ignored and the header section size will be used instead.
\sa verticalStepsPerItem() setHorizontalStepsPerItem() \sa verticalStepsPerItem(), setHorizontalStepsPerItem()
*/ */
void QAbstractItemView::setVerticalStepsPerItem(int steps) void QAbstractItemView::setVerticalStepsPerItem(int steps)
{ {
@ -2904,7 +2904,7 @@ void QAbstractItemView::setVerticalStepsPerItem(int steps)
\obsolete \obsolete
Returns the vertical scroll bar's steps per item. Returns the vertical scroll bar's steps per item.
\sa setVerticalStepsPerItem() horizontalStepsPerItem() \sa setVerticalStepsPerItem(), horizontalStepsPerItem()
*/ */
int QAbstractItemView::verticalStepsPerItem() const int QAbstractItemView::verticalStepsPerItem() const
{ {

2
src/widgets/itemviews/qcolumnview.cpp
View File

@ -663,7 +663,7 @@ void QColumnViewPrivate::_q_clicked(const QModelIndex &index)
Return the new view Return the new view
\sa createColumn() setPreviewWidget() \sa createColumn(), setPreviewWidget()
\sa doLayout() \sa doLayout()
*/ */
QAbstractItemView *QColumnViewPrivate::createColumn(const QModelIndex &index, bool show) QAbstractItemView *QColumnViewPrivate::createColumn(const QModelIndex &index, bool show)

3
src/widgets/itemviews/qdirmodel.cpp
View File

@ -734,7 +734,8 @@ void QDirModel::setSorting(QDir::SortFlags sort)
/*! /*!
Returns the sorting method used for the directory model. Returns the sorting method used for the directory model.
\sa QDir::SortFlags */ \sa QDir::SortFlags
*/
QDir::SortFlags QDirModel::sorting() const QDir::SortFlags QDirModel::sorting() const
{ {

12
src/widgets/itemviews/qheaderview.cpp
View File

@ -185,7 +185,7 @@ QDataStream &operator>>(QDataStream &in, QHeaderViewPrivate::SectionItem &sectio
The following values are obsolete: The following values are obsolete:
\value Custom Use Fixed instead. \value Custom Use Fixed instead.
\sa setResizeMode() setSectionResizeMode() stretchLastSection minimumSectionSize \sa setResizeMode(), setSectionResizeMode(), stretchLastSection, minimumSectionSize
*/ */
/*! /*!
@ -1334,7 +1334,7 @@ bool QHeaderView::isSortIndicatorShown() const
and the model will return to its natural, unsorted order. Note that not and the model will return to its natural, unsorted order. Note that not
all models support this and may even crash in this case. all models support this and may even crash in this case.
\sa sortIndicatorSection() sortIndicatorOrder() \sa sortIndicatorSection(), sortIndicatorOrder()
*/ */
void QHeaderView::setSortIndicator(int logicalIndex, Qt::SortOrder order) void QHeaderView::setSortIndicator(int logicalIndex, Qt::SortOrder order)
@ -1370,7 +1370,7 @@ void QHeaderView::setSortIndicator(int logicalIndex, Qt::SortOrder order)
Returns the logical index of the section that has a sort indicator. Returns the logical index of the section that has a sort indicator.
By default this is section 0. By default this is section 0.
\sa setSortIndicator() sortIndicatorOrder() setSortIndicatorShown() \sa setSortIndicator(), sortIndicatorOrder(), setSortIndicatorShown()
*/ */
int QHeaderView::sortIndicatorSection() const int QHeaderView::sortIndicatorSection() const
@ -1383,7 +1383,7 @@ int QHeaderView::sortIndicatorSection() const
Returns the order for the sort indicator. If no section has a sort Returns the order for the sort indicator. If no section has a sort
indicator the return value of this function is undefined. indicator the return value of this function is undefined.
\sa setSortIndicator() sortIndicatorSection() \sa setSortIndicator(), sortIndicatorSection()
*/ */
Qt::SortOrder QHeaderView::sortIndicatorOrder() const Qt::SortOrder QHeaderView::sortIndicatorOrder() const
@ -1458,7 +1458,7 @@ void QHeaderView::setCascadingSectionResizes(bool enable)
This property only affects sections that have \l Interactive or \l Fixed This property only affects sections that have \l Interactive or \l Fixed
as their resize mode. as their resize mode.
\sa setSectionResizeMode() minimumSectionSize \sa setSectionResizeMode(), minimumSectionSize
*/ */
int QHeaderView::defaultSectionSize() const int QHeaderView::defaultSectionSize() const
{ {
@ -1484,7 +1484,7 @@ void QHeaderView::setDefaultSectionSize(int size)
This property is honored by all \l{ResizeMode}{resize modes}. This property is honored by all \l{ResizeMode}{resize modes}.
\sa setSectionResizeMode() defaultSectionSize \sa setSectionResizeMode(), defaultSectionSize
*/ */
int QHeaderView::minimumSectionSize() const int QHeaderView::minimumSectionSize() const
{ {

12
src/widgets/itemviews/qlistwidget.cpp
View File

@ -853,7 +853,7 @@ QDataStream &operator>>(QDataStream &in, QListWidgetItem &item)
Returns the list item's tooltip. Returns the list item's tooltip.
\sa setToolTip() statusTip() whatsThis() \sa setToolTip(), statusTip(), whatsThis()
*/ */
/*! /*!
@ -861,7 +861,7 @@ QDataStream &operator>>(QDataStream &in, QListWidgetItem &item)
Returns the list item's "What's This?" help text. Returns the list item's "What's This?" help text.
\sa setWhatsThis() statusTip() toolTip() \sa setWhatsThis(), statusTip(), toolTip()
*/ */
/*! /*!
@ -891,7 +891,7 @@ QDataStream &operator>>(QDataStream &in, QListWidgetItem &item)
Returns the brush used to display the list item's background. Returns the brush used to display the list item's background.
\sa setBackground() foreground() \sa setBackground(), foreground()
*/ */
/*! /*!
@ -909,7 +909,7 @@ QDataStream &operator>>(QDataStream &in, QListWidgetItem &item)
Returns the brush used to display the list item's foreground (e.g. text). Returns the brush used to display the list item's foreground (e.g. text).
\sa setForeground() background() \sa setForeground(), background()
*/ */
/*! /*!
@ -1019,7 +1019,7 @@ void QListWidgetItem::setFlags(Qt::ItemFlags aflags) {
Sets the background brush of the list item to the given \a brush. Sets the background brush of the list item to the given \a brush.
\sa background() setForeground() \sa background(), setForeground()
*/ */
/*! /*!
@ -1035,7 +1035,7 @@ void QListWidgetItem::setFlags(Qt::ItemFlags aflags) {
Sets the foreground brush of the list item to the given \a brush. Sets the foreground brush of the list item to the given \a brush.
\sa foreground() setBackground() \sa foreground(), setBackground()
*/ */
/*! /*!

7
src/widgets/itemviews/qproxymodel.cpp
View File

@ -74,7 +74,7 @@ QT_BEGIN_NAMESPACE
representation, proxy models must create their own model indexes instead of representation, proxy models must create their own model indexes instead of
supplying model indexes from their underlying models. supplying model indexes from their underlying models.
\sa \link model-view-programming.html Model/View Programming\endlink QAbstractItemModel \sa {Model/View Programming}, QAbstractItemModel
*/ */
@ -204,7 +204,7 @@ QVariant QProxyModel::data(const QModelIndex &index, int role) const
The base class implementation returns false. This function and The base class implementation returns false. This function and
data() must be reimplemented for editable models. data() must be reimplemented for editable models.
\sa data() itemData() QAbstractItemModel::setData() \sa data(), itemData(), QAbstractItemModel::setData()
*/ */
bool QProxyModel::setData(const QModelIndex &index, const QVariant &value, int role) bool QProxyModel::setData(const QModelIndex &index, const QVariant &value, int role)
{ {
@ -295,7 +295,8 @@ Qt::DropActions QProxyModel::supportedDropActions() const
Returns true if the rows were successfully inserted; otherwise Returns true if the rows were successfully inserted; otherwise
returns false. returns false.
\sa QAbstractItemModel::insertRows()*/ \sa QAbstractItemModel::insertRows()
*/
bool QProxyModel::insertRows(int row, int count, const QModelIndex &parent) bool QProxyModel::insertRows(int row, int count, const QModelIndex &parent)
{ {
Q_D(const QProxyModel); Q_D(const QProxyModel);

10
src/widgets/itemviews/qstandarditemmodel.cpp
View File

@ -992,7 +992,7 @@ Qt::ItemFlags QStandardItem::flags() const
Sets the font used to display the item's text to the given \a font. Sets the font used to display the item's text to the given \a font.
\sa font() setText() setForeground() \sa font(), setText(), setForeground()
*/ */
/*! /*!
@ -1000,7 +1000,7 @@ Qt::ItemFlags QStandardItem::flags() const
Returns the brush used to render the item's background. Returns the brush used to render the item's background.
\sa foreground() setBackground() \sa foreground(), setBackground()
*/ */
/*! /*!
@ -1008,7 +1008,7 @@ Qt::ItemFlags QStandardItem::flags() const
Sets the item's background brush to the specified \a brush. Sets the item's background brush to the specified \a brush.
\sa background() setForeground() \sa background(), setForeground()
*/ */
/*! /*!
@ -1016,7 +1016,7 @@ Qt::ItemFlags QStandardItem::flags() const
Returns the brush used to render the item's foreground (e.g. text). Returns the brush used to render the item's foreground (e.g. text).
\sa setForeground() background() \sa setForeground(), background()
*/ */
/*! /*!
@ -1025,7 +1025,7 @@ Qt::ItemFlags QStandardItem::flags() const
Sets the brush used to display the item's foreground (e.g. text) to the Sets the brush used to display the item's foreground (e.g. text) to the
given \a brush. given \a brush.
\sa foreground() setBackground() setFont() \sa foreground(), setBackground(), setFont()
*/ */
/*! /*!

12
src/widgets/itemviews/qtableview.cpp
View File

@ -1169,7 +1169,7 @@ QHeaderView *QTableView::verticalHeader() const
/*! /*!
Sets the widget to use for the horizontal header to \a header. Sets the widget to use for the horizontal header to \a header.
\sa horizontalHeader() setVerticalHeader() \sa horizontalHeader(), setVerticalHeader()
*/ */
void QTableView::setHorizontalHeader(QHeaderView *header) void QTableView::setHorizontalHeader(QHeaderView *header)
{ {
@ -1206,7 +1206,7 @@ void QTableView::setHorizontalHeader(QHeaderView *header)
/*! /*!
Sets the widget to use for the vertical header to \a header. Sets the widget to use for the vertical header to \a header.
\sa verticalHeader() setHorizontalHeader() \sa verticalHeader(), setHorizontalHeader()
*/ */
void QTableView::setVerticalHeader(QHeaderView *header) void QTableView::setVerticalHeader(QHeaderView *header)
{ {
@ -2876,7 +2876,7 @@ void QTableView::selectColumn(int column)
/*! /*!
Hide the given \a row. Hide the given \a row.
\sa showRow() hideColumn() \sa showRow(), hideColumn()
*/ */
void QTableView::hideRow(int row) void QTableView::hideRow(int row)
{ {
@ -2887,7 +2887,7 @@ void QTableView::hideRow(int row)
/*! /*!
Hide the given \a column. Hide the given \a column.
\sa showColumn() hideRow() \sa showColumn(), hideRow()
*/ */
void QTableView::hideColumn(int column) void QTableView::hideColumn(int column)
{ {
@ -2898,7 +2898,7 @@ void QTableView::hideColumn(int column)
/*! /*!
Show the given \a row. Show the given \a row.
\sa hideRow() showColumn() \sa hideRow(), showColumn()
*/ */
void QTableView::showRow(int row) void QTableView::showRow(int row)
{ {
@ -2909,7 +2909,7 @@ void QTableView::showRow(int row)
/*! /*!
Show the given \a column. Show the given \a column.
\sa hideColumn() showRow() \sa hideColumn(), showRow()
*/ */
void QTableView::showColumn(int column) void QTableView::showColumn(int column)
{ {

14
src/widgets/itemviews/qtablewidget.cpp
View File

@ -1118,7 +1118,7 @@ void QTableWidgetItem::setFlags(Qt::ItemFlags aflags)
Sets the item's text to the \a text specified. Sets the item's text to the \a text specified.
\sa text() setFont() setForeground() \sa text(), setFont(), setForeground()
*/ */
/*! /*!
@ -1152,7 +1152,7 @@ void QTableWidgetItem::setFlags(Qt::ItemFlags aflags)
\a statusTip. QTableWidget mouse tracking needs to be enabled for this \a statusTip. QTableWidget mouse tracking needs to be enabled for this
feature to work. feature to work.
\sa statusTip() setToolTip() setWhatsThis() \sa statusTip(), setToolTip(), setWhatsThis()
*/ */
/*! /*!
@ -1168,7 +1168,7 @@ void QTableWidgetItem::setFlags(Qt::ItemFlags aflags)
Sets the item's tooltip to the string specified by \a toolTip. Sets the item's tooltip to the string specified by \a toolTip.
\sa toolTip() setStatusTip() setWhatsThis() \sa toolTip(), setStatusTip(), setWhatsThis()
*/ */
/*! /*!
@ -1184,7 +1184,7 @@ void QTableWidgetItem::setFlags(Qt::ItemFlags aflags)
Sets the item's "What's This?" help to the string specified by \a whatsThis. Sets the item's "What's This?" help to the string specified by \a whatsThis.
\sa whatsThis() setStatusTip() setToolTip() \sa whatsThis(), setStatusTip(), setToolTip()
*/ */
/*! /*!
@ -1200,7 +1200,7 @@ void QTableWidgetItem::setFlags(Qt::ItemFlags aflags)
Sets the font used to display the item's text to the given \a font. Sets the font used to display the item's text to the given \a font.
\sa font() setText() setForeground() \sa font(), setText(), setForeground()
*/ */
/*! /*!
@ -1724,7 +1724,7 @@ void QTableWidgetPrivate::_q_dataChanged(const QModelIndex &topLeft,
This signal is emitted whenever the selection changes. This signal is emitted whenever the selection changes.
\sa selectedItems() QTableWidgetItem::isSelected() \sa selectedItems(), QTableWidgetItem::isSelected()
*/ */
@ -1950,7 +1950,7 @@ QTableWidgetItem *QTableWidget::item(int row, int column) const
you to use the same \a row argument for all items in the same row you to use the same \a row argument for all items in the same row
(i.e. setItem() will not move the row). (i.e. setItem() will not move the row).
\sa item() takeItem() \sa item(), takeItem()
*/ */
void QTableWidget::setItem(int row, int column, QTableWidgetItem *item) void QTableWidget::setItem(int row, int column, QTableWidgetItem *item)
{ {

6
src/widgets/itemviews/qtreeview.cpp
View File

@ -2614,7 +2614,7 @@ void QTreeView::selectAll()
Warning: if the model contains a large number of items, Warning: if the model contains a large number of items,
this function will take some time to execute. this function will take some time to execute.
\sa collapseAll() expand() collapse() setExpanded() \sa collapseAll(), expand(), collapse(), setExpanded()
*/ */
void QTreeView::expandAll() void QTreeView::expandAll()
{ {
@ -2631,7 +2631,7 @@ void QTreeView::expandAll()
Collapses all expanded items. Collapses all expanded items.
\sa expandAll() expand() collapse() setExpanded() \sa expandAll(), expand(), collapse(), setExpanded()
*/ */
void QTreeView::collapseAll() void QTreeView::collapseAll()
{ {
@ -2644,7 +2644,7 @@ void QTreeView::collapseAll()
\since 4.3 \since 4.3
Expands all expandable items to the given \a depth. Expands all expandable items to the given \a depth.
\sa expandAll() collapseAll() expand() collapse() setExpanded() \sa expandAll(), collapseAll(), expand(), collapse(), setExpanded()
*/ */
void QTreeView::expandToDepth(int depth) void QTreeView::expandToDepth(int depth)
{ {

14
src/widgets/itemviews/qtreewidget.cpp
View File

@ -1067,7 +1067,7 @@ void QTreeModel::timerEvent(QTimerEvent *ev)
Sets the text to be displayed in the given \a column to the given \a text. Sets the text to be displayed in the given \a column to the given \a text.
\sa text() setFont() setForeground() \sa text(), setFont(), setForeground()
*/ */
/*! /*!
@ -1100,7 +1100,7 @@ void QTreeModel::timerEvent(QTimerEvent *ev)
Sets the status tip for the given \a column to the given \a statusTip. Sets the status tip for the given \a column to the given \a statusTip.
QTreeWidget mouse tracking needs to be enabled for this feature to work. QTreeWidget mouse tracking needs to be enabled for this feature to work.
\sa statusTip() setToolTip() setWhatsThis() \sa statusTip(), setToolTip(), setWhatsThis()
*/ */
/*! /*!
@ -1116,7 +1116,7 @@ void QTreeModel::timerEvent(QTimerEvent *ev)
Sets the tooltip for the given \a column to \a toolTip. Sets the tooltip for the given \a column to \a toolTip.
\sa toolTip() setStatusTip() setWhatsThis() \sa toolTip(), setStatusTip(), setWhatsThis()
*/ */
/*! /*!
@ -1132,7 +1132,7 @@ void QTreeModel::timerEvent(QTimerEvent *ev)
Sets the "What's This?" help for the given \a column to \a whatsThis. Sets the "What's This?" help for the given \a column to \a whatsThis.
\sa whatsThis() setStatusTip() setToolTip() \sa whatsThis(), setStatusTip(), setToolTip()
*/ */
/*! /*!
@ -1149,7 +1149,7 @@ void QTreeModel::timerEvent(QTimerEvent *ev)
Sets the font used to display the text in the given \a column to the given Sets the font used to display the text in the given \a column to the given
\a font. \a font.
\sa font() setText() setForeground() \sa font(), setText(), setForeground()
*/ */
/*! /*!
@ -1881,7 +1881,7 @@ QTreeWidgetItem &QTreeWidgetItem::operator=(const QTreeWidgetItem &other)
/*! /*!
Appends the \a child item to the list of children. Appends the \a child item to the list of children.
\sa insertChild() takeChild() \sa insertChild(), takeChild()
*/ */
void QTreeWidgetItem::addChild(QTreeWidgetItem *child) void QTreeWidgetItem::addChild(QTreeWidgetItem *child)
{ {
@ -1984,7 +1984,7 @@ QTreeWidgetItem *QTreeWidgetItem::takeChild(int index)
Appends the given list of \a children to the item. Appends the given list of \a children to the item.
\sa insertChildren() takeChildren() \sa insertChildren(), takeChildren()
*/ */
void QTreeWidgetItem::addChildren(const QList<QTreeWidgetItem*> &children) void QTreeWidgetItem::addChildren(const QList<QTreeWidgetItem*> &children)
{ {

8
src/widgets/kernel/qaction.cpp
View File

@ -571,7 +571,7 @@ bool QAction::autoRepeat() const
By default, this property contains the application's default font. By default, this property contains the application's default font.
\sa QAction::setText() QStyle \sa QAction::setText(), QStyle
*/ */
void QAction::setFont(const QFont &font) void QAction::setFont(const QFont &font)
{ {
@ -821,7 +821,7 @@ QString QAction::iconText() const
By default, this property contains the action's text. By default, this property contains the action's text.
\sa setStatusTip() setShortcut() \sa setStatusTip(), setShortcut()
*/ */
void QAction::setToolTip(const QString &tooltip) void QAction::setToolTip(const QString &tooltip)
{ {
@ -853,7 +853,7 @@ QString QAction::toolTip() const
By default, this property contains an empty string. By default, this property contains an empty string.
\sa setToolTip() showStatusText() \sa setToolTip(), showStatusText()
*/ */
void QAction::setStatusTip(const QString &statustip) void QAction::setStatusTip(const QString &statustip)
{ {
@ -1330,7 +1330,7 @@ QAction::SoftKeyRole QAction::softKeyRole() const
For example: For example:
\snippet code/src_gui_kernel_qaction.cpp 0 \snippet code/src_gui_kernel_qaction.cpp 0
\sa QAction::icon QApplication::setAttribute() \sa QAction::icon, QApplication::setAttribute()
*/ */
void QAction::setIconVisibleInMenu(bool visible) void QAction::setIconVisibleInMenu(bool visible)
{ {

2
src/widgets/kernel/qapplication.cpp
View File

@ -2872,7 +2872,7 @@ void QApplication::setStartDragDistance(int l)
The default value is 4 pixels. The default value is 4 pixels.
\sa startDragTime() QPoint::manhattanLength() {Drag and Drop} \sa startDragTime(), QPoint::manhattanLength(), {Drag and Drop}
*/ */
int QApplication::startDragDistance() int QApplication::startDragDistance()

2
src/widgets/kernel/qboxlayout.cpp
View File

@ -1218,7 +1218,7 @@ void QBoxLayout::setDirection(Direction direction)
Returns the direction of the box. addWidget() and addSpacing() Returns the direction of the box. addWidget() and addSpacing()
work in this direction; the stretch stretches in this direction. work in this direction; the stretch stretches in this direction.
\sa QBoxLayout::Direction addWidget() addSpacing() \sa QBoxLayout::Direction, addWidget(), addSpacing()
*/ */
QBoxLayout::Direction QBoxLayout::direction() const QBoxLayout::Direction QBoxLayout::direction() const

4
src/widgets/kernel/qwhatsthis.cpp
View File

@ -541,7 +541,7 @@ QWhatsThis::QWhatsThis()
When entering "What's This?" mode, a QEvent of type When entering "What's This?" mode, a QEvent of type
Qt::EnterWhatsThisMode is sent to all toplevel widgets. Qt::EnterWhatsThisMode is sent to all toplevel widgets.
\sa inWhatsThisMode() leaveWhatsThisMode() \sa inWhatsThisMode(), leaveWhatsThisMode()
*/ */
void QWhatsThis::enterWhatsThisMode() void QWhatsThis::enterWhatsThisMode()
{ {
@ -570,7 +570,7 @@ bool QWhatsThis::inWhatsThisMode()
When leaving "What's This?" mode, a QEvent of type When leaving "What's This?" mode, a QEvent of type
Qt::LeaveWhatsThisMode is sent to all toplevel widgets. Qt::LeaveWhatsThisMode is sent to all toplevel widgets.
\sa enterWhatsThisMode() inWhatsThisMode() \sa enterWhatsThisMode(), inWhatsThisMode()
*/ */
void QWhatsThis::leaveWhatsThisMode() void QWhatsThis::leaveWhatsThisMode()
{ {

62
src/widgets/kernel/qwidget.cpp
View File

@ -2704,7 +2704,7 @@ bool QWidget::isMaximized() const
combination of Qt::WindowState: Qt::WindowMinimized, combination of Qt::WindowState: Qt::WindowMinimized,
Qt::WindowMaximized, Qt::WindowFullScreen, and Qt::WindowActive. Qt::WindowMaximized, Qt::WindowFullScreen, and Qt::WindowActive.
\sa Qt::WindowState setWindowState() \sa Qt::WindowState, setWindowState()
*/ */
Qt::WindowStates QWidget::windowState() const Qt::WindowStates QWidget::windowState() const
{ {
@ -2753,7 +2753,7 @@ void QWidget::overrideWindowState(Qt::WindowStates newstate)
When the window state changes, the widget receives a changeEvent() When the window state changes, the widget receives a changeEvent()
of type QEvent::WindowStateChange. of type QEvent::WindowStateChange.
\sa Qt::WindowState windowState() \sa Qt::WindowState, windowState()
*/ */
/*! /*!
@ -2889,7 +2889,7 @@ void QWidget::showNormal()
isEnabledTo(0) is equivalent to isEnabled(). isEnabledTo(0) is equivalent to isEnabled().
\sa setEnabled() enabled \sa setEnabled(), enabled
*/ */
bool QWidget::isEnabledTo(const QWidget *ancestor) const bool QWidget::isEnabledTo(const QWidget *ancestor) const
@ -3160,7 +3160,7 @@ void QWidget::setDisabled(bool disable)
By default, this property contains a value that depends on the user's By default, this property contains a value that depends on the user's
platform and screen geometry. platform and screen geometry.
\sa geometry() x() y() pos() \sa geometry(), x(), y(), pos()
*/ */
QRect QWidget::frameGeometry() const QRect QWidget::frameGeometry() const
{ {
@ -3237,7 +3237,7 @@ int QWidget::y() const
See the \l{Window Geometry} documentation for an overview of geometry See the \l{Window Geometry} documentation for an overview of geometry
issues with windows. issues with windows.
\sa frameGeometry, size x(), y() \sa frameGeometry, size, x(), y()
*/ */
QPoint QWidget::pos() const QPoint QWidget::pos() const
{ {
@ -3384,7 +3384,7 @@ QRect QWidget::normalGeometry() const
By default, for a widget with no children, this property contains a By default, for a widget with no children, this property contains a
rectangle with zero width and height located at the origin. rectangle with zero width and height located at the origin.
\sa childrenRegion() geometry() \sa childrenRegion(), geometry()
*/ */
QRect QWidget::childrenRect() const QRect QWidget::childrenRect() const
@ -3408,7 +3408,7 @@ QRect QWidget::childrenRect() const
By default, for a widget with no children, this property contains an By default, for a widget with no children, this property contains an
empty region. empty region.
\sa childrenRect() geometry() mask() \sa childrenRect(), geometry(), mask()
*/ */
QRegion QWidget::childrenRegion() const QRegion QWidget::childrenRegion() const
@ -3824,7 +3824,7 @@ void QWidget::setMaximumHeight(int h)
Sets both the minimum and maximum width of the widget to \a w Sets both the minimum and maximum width of the widget to \a w
without changing the heights. Provided for convenience. without changing the heights. Provided for convenience.
\sa sizeHint() minimumSize() maximumSize() setFixedSize() \sa sizeHint(), minimumSize(), maximumSize(), setFixedSize()
*/ */
void QWidget::setFixedWidth(int w) void QWidget::setFixedWidth(int w)
@ -3844,7 +3844,7 @@ void QWidget::setFixedWidth(int w)
Sets both the minimum and maximum heights of the widget to \a h Sets both the minimum and maximum heights of the widget to \a h
without changing the widths. Provided for convenience. without changing the widths. Provided for convenience.
\sa sizeHint() minimumSize() maximumSize() setFixedSize() \sa sizeHint(), minimumSize(), maximumSize(), setFixedSize()
*/ */
void QWidget::setFixedHeight(int h) void QWidget::setFixedHeight(int h)
@ -3865,7 +3865,7 @@ void QWidget::setFixedHeight(int h)
of \a parent. The \a parent must not be 0 and must be a parent of \a parent. The \a parent must not be 0 and must be a parent
of the calling widget. of the calling widget.
\sa mapFrom() mapToParent() mapToGlobal() underMouse() \sa mapFrom(), mapToParent(), mapToGlobal(), underMouse()
*/ */
QPoint QWidget::mapTo(const QWidget * parent, const QPoint & pos) const QPoint QWidget::mapTo(const QWidget * parent, const QPoint & pos) const
@ -3889,7 +3889,7 @@ QPoint QWidget::mapTo(const QWidget * parent, const QPoint & pos) const
of \a parent to this widget's coordinate system. The \a parent of \a parent to this widget's coordinate system. The \a parent
must not be 0 and must be a parent of the calling widget. must not be 0 and must be a parent of the calling widget.
\sa mapTo() mapFromParent() mapFromGlobal() underMouse() \sa mapTo(), mapFromParent(), mapFromGlobal(), underMouse()
*/ */
QPoint QWidget::mapFrom(const QWidget * parent, const QPoint & pos) const QPoint QWidget::mapFrom(const QWidget * parent, const QPoint & pos) const
@ -3915,7 +3915,7 @@ QPoint QWidget::mapFrom(const QWidget * parent, const QPoint & pos) const
Same as mapToGlobal() if the widget has no parent. Same as mapToGlobal() if the widget has no parent.
\sa mapFromParent() mapTo() mapToGlobal() underMouse() \sa mapFromParent(), mapTo(), mapToGlobal(), underMouse()
*/ */
QPoint QWidget::mapToParent(const QPoint &pos) const QPoint QWidget::mapToParent(const QPoint &pos) const
@ -3929,7 +3929,7 @@ QPoint QWidget::mapToParent(const QPoint &pos) const
Same as mapFromGlobal() if the widget has no parent. Same as mapFromGlobal() if the widget has no parent.
\sa mapToParent() mapFrom() mapFromGlobal() underMouse() \sa mapToParent(), mapFrom(), mapFromGlobal(), underMouse()
*/ */
QPoint QWidget::mapFromParent(const QPoint &pos) const QPoint QWidget::mapFromParent(const QPoint &pos) const
@ -5420,7 +5420,7 @@ QGraphicsProxyWidget * QWidgetPrivate::nearestGraphicsProxyWidget(const QWidget
If the widget displays dates or numbers, these should be formatted If the widget displays dates or numbers, these should be formatted
using the widget's locale. using the widget's locale.
\sa QLocale QLocale::setDefault() \sa QLocale, QLocale::setDefault()
*/ */
void QWidgetPrivate::setLocale_helper(const QLocale &loc, bool forceUpdate) void QWidgetPrivate::setLocale_helper(const QLocale &loc, bool forceUpdate)
@ -6839,7 +6839,7 @@ QRect QWidget::contentsRect() const
\link QAbstractScrollArea::viewport() viewport() \endlink . \link QAbstractScrollArea::viewport() viewport() \endlink .
\sa mapToGlobal() QMenu contextMenuPolicy \sa mapToGlobal(), QMenu, contextMenuPolicy
*/ */
@ -7572,7 +7572,7 @@ bool QWidget::close()
isVisibleTo(0) is identical to isVisible(). isVisibleTo(0) is identical to isVisible().
\sa show() hide() isVisible() \sa show(), hide(), isVisible()
*/ */
bool QWidget::isVisibleTo(const QWidget *ancestor) const bool QWidget::isVisibleTo(const QWidget *ancestor) const
@ -8436,7 +8436,7 @@ void QWidget::mouseReleaseEvent(QMouseEvent *event)
developer to ensure that the application interprets these events developer to ensure that the application interprets these events
correctly. correctly.
\sa mousePressEvent(), mouseReleaseEvent() mouseMoveEvent(), \sa mousePressEvent(), mouseReleaseEvent(), mouseMoveEvent(),
event(), QMouseEvent event(), QMouseEvent
*/ */
@ -8776,7 +8776,7 @@ void QWidget::closeEvent(QCloseEvent *event)
The default implementation ignores the context event. The default implementation ignores the context event.
See the \l QContextMenuEvent documentation for more details. See the \l QContextMenuEvent documentation for more details.
\sa event(), QContextMenuEvent customContextMenuRequested() \sa event(), QContextMenuEvent, customContextMenuRequested()
*/ */
void QWidget::contextMenuEvent(QContextMenuEvent *event) void QWidget::contextMenuEvent(QContextMenuEvent *event)
@ -9211,7 +9211,7 @@ QLayout *QWidget::takeLayout()
use additional space, and that they can make do with less than use additional space, and that they can make do with less than
sizeHint(). sizeHint().
\sa sizeHint() QLayout QSizePolicy updateGeometry() \sa sizeHint(), QLayout, QSizePolicy, updateGeometry()
*/ */
QSizePolicy QWidget::sizePolicy() const QSizePolicy QWidget::sizePolicy() const
{ {
@ -9844,7 +9844,7 @@ void QWidget::repaint(const QRegion &rgn)
If the Qt::WA_OpaquePaintEvent widget attribute is set, the widget is If the Qt::WA_OpaquePaintEvent widget attribute is set, the widget is
responsible for painting all its pixels with an opaque color. responsible for painting all its pixels with an opaque color.
\sa repaint() paintEvent(), setUpdatesEnabled(), {Analog Clock Example} \sa repaint(), paintEvent(), setUpdatesEnabled(), {Analog Clock Example}
*/ */
void QWidget::update() void QWidget::update()
{ {
@ -10357,7 +10357,7 @@ void QWidgetPrivate::setWindowModified_helper()
By default, this property contains an empty string. By default, this property contains an empty string.
\sa QToolTip statusTip whatsThis \sa QToolTip, statusTip, whatsThis
*/ */
void QWidget::setToolTip(const QString &s) void QWidget::setToolTip(const QString &s)
{ {
@ -10383,7 +10383,7 @@ QString QWidget::toolTip() const
By default, this property contains an empty string. By default, this property contains an empty string.
\sa toolTip whatsThis \sa toolTip, whatsThis
*/ */
void QWidget::setStatusTip(const QString &s) void QWidget::setStatusTip(const QString &s)
{ {
@ -10406,7 +10406,7 @@ QString QWidget::statusTip() const
By default, this property contains an empty string. By default, this property contains an empty string.
\sa QWhatsThis QWidget::toolTip QWidget::statusTip \sa QWhatsThis, QWidget::toolTip, QWidget::statusTip
*/ */
void QWidget::setWhatsThis(const QString &s) void QWidget::setWhatsThis(const QString &s)
{ {
@ -10494,7 +10494,7 @@ QString QWidget::accessibleDescription() const
key sequence, so are much easier to use than this low-level key sequence, so are much easier to use than this low-level
function. function.
\sa releaseShortcut() setShortcutEnabled() \sa releaseShortcut(), setShortcutEnabled()
*/ */
int QWidget::grabShortcut(const QKeySequence &key, Qt::ShortcutContext context) int QWidget::grabShortcut(const QKeySequence &key, Qt::ShortcutContext context)
{ {
@ -10518,7 +10518,7 @@ int QWidget::grabShortcut(const QKeySequence &key, Qt::ShortcutContext context)
this low-level function. Note also that this is an expensive this low-level function. Note also that this is an expensive
operation. operation.
\sa grabShortcut() setShortcutEnabled() \sa grabShortcut(), setShortcutEnabled()
*/ */
void QWidget::releaseShortcut(int id) void QWidget::releaseShortcut(int id)
{ {
@ -10537,7 +10537,7 @@ void QWidget::releaseShortcut(int id)
to use QAction or QShortcut to handle shortcuts, since they are to use QAction or QShortcut to handle shortcuts, since they are
easier to use than this low-level function. easier to use than this low-level function.
\sa grabShortcut() releaseShortcut() \sa grabShortcut(), releaseShortcut()
*/ */
void QWidget::setShortcutEnabled(int id, bool enable) void QWidget::setShortcutEnabled(int id, bool enable)
{ {
@ -10552,7 +10552,7 @@ void QWidget::setShortcutEnabled(int id, bool enable)
If \a enable is true, auto repeat of the shortcut with the If \a enable is true, auto repeat of the shortcut with the
given \a id is enabled; otherwise it is disabled. given \a id is enabled; otherwise it is disabled.
\sa grabShortcut() releaseShortcut() \sa grabShortcut(), releaseShortcut()
*/ */
void QWidget::setShortcutAutoRepeat(int id, bool enable) void QWidget::setShortcutAutoRepeat(int id, bool enable)
{ {
@ -11093,7 +11093,7 @@ void QWidget::ungrabGesture(Qt::GestureType gesture)
coordinates. For example, \c{mapToGlobal(QPoint(0,0))} would give coordinates. For example, \c{mapToGlobal(QPoint(0,0))} would give
the global coordinates of the top-left pixel of the widget. the global coordinates of the top-left pixel of the widget.
\sa mapFromGlobal() mapTo() mapToParent() \sa mapFromGlobal(), mapTo(), mapToParent()
*/ */
/*! /*!
@ -11102,7 +11102,7 @@ void QWidget::ungrabGesture(Qt::GestureType gesture)
Translates the global screen coordinate \a pos to widget Translates the global screen coordinate \a pos to widget
coordinates. coordinates.
\sa mapToGlobal() mapFrom() mapFromParent() \sa mapToGlobal(), mapFrom(), mapFromParent()
*/ */
/*! /*!
@ -11132,7 +11132,7 @@ void QWidget::ungrabGesture(Qt::GestureType gesture)
frame of that widget. For \e Carbon, it works outside the widget's frame of that widget. For \e Carbon, it works outside the widget's
frame as well, like for Windows and X11. frame as well, like for Windows and X11.
\sa releaseMouse() grabKeyboard() releaseKeyboard() \sa releaseMouse(), grabKeyboard(), releaseKeyboard()
*/ */
/*! /*!
@ -11177,7 +11177,7 @@ void QWidget::ungrabGesture(Qt::GestureType gesture)
If a different widget is currently grabbing keyboard input, that If a different widget is currently grabbing keyboard input, that
widget's grab is released first. widget's grab is released first.
\sa releaseKeyboard() grabMouse() releaseMouse() focusWidget() \sa releaseKeyboard(), grabMouse(), releaseMouse(), focusWidget()
*/ */
/*! /*!

2
src/widgets/styles/qmacstyle.qdoc
View File

@ -167,7 +167,7 @@
to its default value, you must save the old value of the attribute before to its default value, you must save the old value of the attribute before
you change it. you change it.
\sa focusRectPolicy() QWidget::setAttribute() \sa focusRectPolicy(), QWidget::setAttribute()
*/ */
/*! \fn QMacStyle::FocusRectPolicy QMacStyle::focusRectPolicy(const QWidget *w) /*! \fn QMacStyle::FocusRectPolicy QMacStyle::focusRectPolicy(const QWidget *w)

4
src/widgets/styles/qstyle.cpp
View File

@ -1088,7 +1088,7 @@ void QStyle::drawItemPixmap(QPainter *painter, const QRect &rect, int alignment,
\value CC_CustomBase Base value for custom complex controls. Custom \value CC_CustomBase Base value for custom complex controls. Custom
values must be greater than this value. values must be greater than this value.
\sa SubControl drawComplexControl() \sa SubControl, drawComplexControl()
*/ */
/*! /*!
@ -1536,7 +1536,7 @@ void QStyle::drawItemPixmap(QPainter *painter, const QRect &rect, int alignment,
\row \li \l CT_MenuItem \li \l QStyleOptionMenuItem \row \li \l CT_MenuItem \li \l QStyleOptionMenuItem
\endtable \endtable
\sa ContentsType QStyleOption \sa ContentsType, QStyleOption
*/ */
/*! /*!

2
src/widgets/styles/qstyleoption.cpp
View File

@ -2098,7 +2098,7 @@ QStyleOptionSlider::QStyleOptionSlider(int version)
The default value is 0. The default value is 0.
\sa QAbstractSlider::tracking sliderPosition \sa QAbstractSlider::tracking, sliderPosition
*/ */
/*! /*!

2
src/widgets/util/qsystemtrayicon.cpp
View File

@ -381,7 +381,7 @@ bool QSystemTrayIcon::supportsMessages()
On Mac OS X, the Growl notification system must be installed for this function to On Mac OS X, the Growl notification system must be installed for this function to
display messages. display messages.
\sa show() supportsMessages() \sa show(), supportsMessages()
*/ */
void QSystemTrayIcon::showMessage(const QString& title, const QString& msg, void QSystemTrayIcon::showMessage(const QString& title, const QString& msg,
QSystemTrayIcon::MessageIcon icon, int msecs) QSystemTrayIcon::MessageIcon icon, int msecs)

40
src/widgets/util/qundogroup.cpp
View File

@ -128,7 +128,7 @@ QUndoGroup::~QUndoGroup()
QObject in QUndoStack::QUndoStack(). In this case, the stack is deleted when the QObject in QUndoStack::QUndoStack(). In this case, the stack is deleted when the
group is deleted, in the usual manner of QObjects. group is deleted, in the usual manner of QObjects.
\sa removeStack() stacks() QUndoStack::QUndoStack() \sa removeStack(), stacks(), QUndoStack::QUndoStack()
*/ */
void QUndoGroup::addStack(QUndoStack *stack) void QUndoGroup::addStack(QUndoStack *stack)
@ -148,7 +148,7 @@ void QUndoGroup::addStack(QUndoStack *stack)
Removes \a stack from this group. If the stack was the active stack in the group, Removes \a stack from this group. If the stack was the active stack in the group,
the active stack becomes 0. the active stack becomes 0.
\sa addStack() stacks() QUndoStack::~QUndoStack() \sa addStack(), stacks(), QUndoStack::~QUndoStack()
*/ */
void QUndoGroup::removeStack(QUndoStack *stack) void QUndoGroup::removeStack(QUndoStack *stack)
@ -165,7 +165,7 @@ void QUndoGroup::removeStack(QUndoStack *stack)
/*! /*!
Returns a list of stacks in this group. Returns a list of stacks in this group.
\sa addStack() removeStack() \sa addStack(), removeStack()
*/ */
QList<QUndoStack*> QUndoGroup::stacks() const QList<QUndoStack*> QUndoGroup::stacks() const
@ -185,7 +185,7 @@ QList<QUndoStack*> QUndoGroup::stacks() const
in the same way as those returned by \a stack's QUndoStack::createUndoAction() in the same way as those returned by \a stack's QUndoStack::createUndoAction()
and QUndoStack::createRedoAction(). and QUndoStack::createRedoAction().
\sa QUndoStack::setActive() activeStack() \sa QUndoStack::setActive(), activeStack()
*/ */
void QUndoGroup::setActiveStack(QUndoStack *stack) void QUndoGroup::setActiveStack(QUndoStack *stack)
@ -248,7 +248,7 @@ void QUndoGroup::setActiveStack(QUndoStack *stack)
If none of the stacks are active, or if the group is empty, this function If none of the stacks are active, or if the group is empty, this function
returns 0. returns 0.
\sa setActiveStack() QUndoStack::setActive() \sa setActiveStack(), QUndoStack::setActive()
*/ */
QUndoStack *QUndoGroup::activeStack() const QUndoStack *QUndoGroup::activeStack() const
@ -263,7 +263,7 @@ QUndoStack *QUndoGroup::activeStack() const
If none of the stacks are active, or if the group is empty, this function If none of the stacks are active, or if the group is empty, this function
does nothing. does nothing.
\sa redo() canUndo() setActiveStack() \sa redo(), canUndo(), setActiveStack()
*/ */
void QUndoGroup::undo() void QUndoGroup::undo()
@ -279,7 +279,7 @@ void QUndoGroup::undo()
If none of the stacks are active, or if the group is empty, this function If none of the stacks are active, or if the group is empty, this function
does nothing. does nothing.
\sa undo() canRedo() setActiveStack() \sa undo(), canRedo(), setActiveStack()
*/ */
@ -296,7 +296,7 @@ void QUndoGroup::redo()
If none of the stacks are active, or if the group is empty, this function If none of the stacks are active, or if the group is empty, this function
returns false. returns false.
\sa canRedo() setActiveStack() \sa canRedo(), setActiveStack()
*/ */
bool QUndoGroup::canUndo() const bool QUndoGroup::canUndo() const
@ -311,7 +311,7 @@ bool QUndoGroup::canUndo() const
If none of the stacks are active, or if the group is empty, this function If none of the stacks are active, or if the group is empty, this function
returns false. returns false.
\sa canUndo() setActiveStack() \sa canUndo(), setActiveStack()
*/ */
bool QUndoGroup::canRedo() const bool QUndoGroup::canRedo() const
@ -326,7 +326,7 @@ bool QUndoGroup::canRedo() const
If none of the stacks are active, or if the group is empty, this function If none of the stacks are active, or if the group is empty, this function
returns an empty string. returns an empty string.
\sa redoText() setActiveStack() \sa redoText(), setActiveStack()
*/ */
QString QUndoGroup::undoText() const QString QUndoGroup::undoText() const
@ -341,7 +341,7 @@ QString QUndoGroup::undoText() const
If none of the stacks are active, or if the group is empty, this function If none of the stacks are active, or if the group is empty, this function
returns an empty string. returns an empty string.
\sa undoText() setActiveStack() \sa undoText(), setActiveStack()
*/ */
QString QUndoGroup::redoText() const QString QUndoGroup::redoText() const
@ -379,7 +379,7 @@ bool QUndoGroup::isClean() const
If \a prefix is empty, the default template "Undo %1" is used instead of prefix. If \a prefix is empty, the default template "Undo %1" is used instead of prefix.
Before Qt 4.8, the prefix "Undo" was used by default. Before Qt 4.8, the prefix "Undo" was used by default.
\sa createRedoAction() canUndo() QUndoCommand::text() \sa createRedoAction(), canUndo(), QUndoCommand::text()
*/ */
QAction *QUndoGroup::createUndoAction(QObject *parent, const QString &prefix) const QAction *QUndoGroup::createUndoAction(QObject *parent, const QString &prefix) const
@ -410,7 +410,7 @@ QAction *QUndoGroup::createUndoAction(QObject *parent, const QString &prefix) co
If \a prefix is empty, the default template "Redo %1" is used instead of prefix. If \a prefix is empty, the default template "Redo %1" is used instead of prefix.
Before Qt 4.8, the prefix "Redo" was used by default. Before Qt 4.8, the prefix "Redo" was used by default.
\sa createUndoAction() canRedo() QUndoCommand::text() \sa createUndoAction(), canRedo(), QUndoCommand::text()
*/ */
QAction *QUndoGroup::createRedoAction(QObject *parent, const QString &prefix) const QAction *QUndoGroup::createRedoAction(QObject *parent, const QString &prefix) const
@ -438,7 +438,7 @@ QAction *QUndoGroup::createRedoAction(QObject *parent, const QString &prefix) co
is removed form the group. \a stack is the new active stack. If no stack is active, is removed form the group. \a stack is the new active stack. If no stack is active,
\a stack is 0. \a stack is 0.
\sa setActiveStack() QUndoStack::setActive() \sa setActiveStack(), QUndoStack::setActive()
*/ */
/*! \fn void QUndoGroup::indexChanged(int idx) /*! \fn void QUndoGroup::indexChanged(int idx)
@ -448,7 +448,7 @@ QAction *QUndoGroup::createRedoAction(QObject *parent, const QString &prefix) co
\a idx is the new current index, or 0 if the active stack is 0. \a idx is the new current index, or 0 if the active stack is 0.
\sa QUndoStack::indexChanged() setActiveStack() \sa QUndoStack::indexChanged(), setActiveStack()
*/ */
/*! \fn void QUndoGroup::cleanChanged(bool clean) /*! \fn void QUndoGroup::cleanChanged(bool clean)
@ -458,7 +458,7 @@ QAction *QUndoGroup::createRedoAction(QObject *parent, const QString &prefix) co
\a clean is the new state, or true if the active stack is 0. \a clean is the new state, or true if the active stack is 0.
\sa QUndoStack::cleanChanged() setActiveStack() \sa QUndoStack::cleanChanged(), setActiveStack()
*/ */
/*! \fn void QUndoGroup::canUndoChanged(bool canUndo) /*! \fn void QUndoGroup::canUndoChanged(bool canUndo)
@ -468,7 +468,7 @@ QAction *QUndoGroup::createRedoAction(QObject *parent, const QString &prefix) co
\a canUndo is the new state, or false if the active stack is 0. \a canUndo is the new state, or false if the active stack is 0.
\sa QUndoStack::canUndoChanged() setActiveStack() \sa QUndoStack::canUndoChanged(), setActiveStack()
*/ */
/*! \fn void QUndoGroup::canRedoChanged(bool canRedo) /*! \fn void QUndoGroup::canRedoChanged(bool canRedo)
@ -478,7 +478,7 @@ QAction *QUndoGroup::createRedoAction(QObject *parent, const QString &prefix) co
\a canRedo is the new state, or false if the active stack is 0. \a canRedo is the new state, or false if the active stack is 0.
\sa QUndoStack::canRedoChanged() setActiveStack() \sa QUndoStack::canRedoChanged(), setActiveStack()
*/ */
/*! \fn void QUndoGroup::undoTextChanged(const QString &undoText) /*! \fn void QUndoGroup::undoTextChanged(const QString &undoText)
@ -488,7 +488,7 @@ QAction *QUndoGroup::createRedoAction(QObject *parent, const QString &prefix) co
\a undoText is the new state, or an empty string if the active stack is 0. \a undoText is the new state, or an empty string if the active stack is 0.
\sa QUndoStack::undoTextChanged() setActiveStack() \sa QUndoStack::undoTextChanged(), setActiveStack()
*/ */
/*! \fn void QUndoGroup::redoTextChanged(const QString &redoText) /*! \fn void QUndoGroup::redoTextChanged(const QString &redoText)
@ -498,7 +498,7 @@ QAction *QUndoGroup::createRedoAction(QObject *parent, const QString &prefix) co
\a redoText is the new state, or an empty string if the active stack is 0. \a redoText is the new state, or an empty string if the active stack is 0.
\sa QUndoStack::redoTextChanged() setActiveStack() \sa QUndoStack::redoTextChanged(), setActiveStack()
*/ */
QT_END_NAMESPACE QT_END_NAMESPACE

32
src/widgets/util/qundostack.cpp
View File

@ -184,7 +184,7 @@ int QUndoCommand::id() const
\snippet code/src_gui_util_qundostack.cpp 3 \snippet code/src_gui_util_qundostack.cpp 3
\sa id() QUndoStack::push() \sa id(), QUndoStack::push()
*/ */
bool QUndoCommand::mergeWith(const QUndoCommand *command) bool QUndoCommand::mergeWith(const QUndoCommand *command)
@ -271,7 +271,7 @@ QString QUndoCommand::actionText() const
different strings in order to match specific languages' needs. different strings in order to match specific languages' needs.
The described feature and the function actionText() are available since Qt 4.8. The described feature and the function actionText() are available since Qt 4.8.
\sa text() actionText() QUndoStack::createUndoAction() QUndoStack::createRedoAction() \sa text(), actionText(), QUndoStack::createUndoAction(), QUndoStack::createRedoAction()
*/ */
void QUndoCommand::setText(const QString &text) void QUndoCommand::setText(const QString &text)
@ -578,7 +578,7 @@ void QUndoStack::clear()
been executed will almost always lead to corruption of the document's been executed will almost always lead to corruption of the document's
state. state.
\sa QUndoCommand::id() QUndoCommand::mergeWith() \sa QUndoCommand::id(), QUndoCommand::mergeWith()
*/ */
void QUndoStack::push(QUndoCommand *cmd) void QUndoStack::push(QUndoCommand *cmd)
@ -652,7 +652,7 @@ void QUndoStack::setClean()
/*! /*!
If the stack is in the clean state, returns true; otherwise returns false. If the stack is in the clean state, returns true; otherwise returns false.
\sa setClean() cleanIndex() \sa setClean(), cleanIndex()
*/ */
bool QUndoStack::isClean() const bool QUndoStack::isClean() const
@ -671,7 +671,7 @@ bool QUndoStack::isClean() const
push() deletes all the undone commands before pushing the new command, the stack push() deletes all the undone commands before pushing the new command, the stack
can't return to the clean state again. In this case, this function returns -1. can't return to the clean state again. In this case, this function returns -1.
\sa isClean() setClean() \sa isClean(), setClean()
*/ */
int QUndoStack::cleanIndex() const int QUndoStack::cleanIndex() const
@ -687,7 +687,7 @@ int QUndoStack::cleanIndex() const
If the stack is empty, or if the bottom command on the stack has already been If the stack is empty, or if the bottom command on the stack has already been
undone, this function does nothing. undone, this function does nothing.
\sa redo() index() \sa redo(), index()
*/ */
void QUndoStack::undo() void QUndoStack::undo()
@ -713,7 +713,7 @@ void QUndoStack::undo()
If the stack is empty, or if the top command on the stack has already been If the stack is empty, or if the top command on the stack has already been
redone, this function does nothing. redone, this function does nothing.
\sa undo() index() \sa undo(), index()
*/ */
void QUndoStack::redo() void QUndoStack::redo()
@ -735,7 +735,7 @@ void QUndoStack::redo()
Returns the number of commands on the stack. Macro commands are counted as Returns the number of commands on the stack. Macro commands are counted as
one command. one command.
\sa index() setIndex() command() \sa index(), setIndex(), command()
*/ */
int QUndoStack::count() const int QUndoStack::count() const
@ -749,7 +749,7 @@ int QUndoStack::count() const
executed on the next call to redo(). It is not always the top-most command executed on the next call to redo(). It is not always the top-most command
on the stack, since a number of commands may have been undone. on the stack, since a number of commands may have been undone.
\sa undo() redo() count() \sa undo(), redo(), count()
*/ */
int QUndoStack::index() const int QUndoStack::index() const
@ -763,7 +763,7 @@ int QUndoStack::index() const
\a idx. This function can be used to roll the state of the document forwards \a idx. This function can be used to roll the state of the document forwards
of backwards. indexChanged() is emitted only once. of backwards. indexChanged() is emitted only once.
\sa index() count() undo() redo() \sa index(), count(), undo(), redo()
*/ */
void QUndoStack::setIndex(int idx) void QUndoStack::setIndex(int idx)
@ -796,7 +796,7 @@ void QUndoStack::setIndex(int idx)
Synonymous with index() == 0. Synonymous with index() == 0.
\sa index() canRedo() \sa index(), canRedo()
*/ */
bool QUndoStack::canUndo() const bool QUndoStack::canUndo() const
@ -815,7 +815,7 @@ bool QUndoStack::canUndo() const
Synonymous with index() == count(). Synonymous with index() == count().
\sa index() canUndo() \sa index(), canUndo()
*/ */
bool QUndoStack::canRedo() const bool QUndoStack::canRedo() const
@ -829,7 +829,7 @@ bool QUndoStack::canRedo() const
/*! /*!
Returns the text of the command which will be undone in the next call to undo(). Returns the text of the command which will be undone in the next call to undo().
\sa QUndoCommand::actionText() redoText() \sa QUndoCommand::actionText(), redoText()
*/ */
QString QUndoStack::undoText() const QString QUndoStack::undoText() const
@ -845,7 +845,7 @@ QString QUndoStack::undoText() const
/*! /*!
Returns the text of the command which will be redone in the next call to redo(). Returns the text of the command which will be redone in the next call to redo().
\sa QUndoCommand::actionText() undoText() \sa QUndoCommand::actionText(), undoText()
*/ */
QString QUndoStack::redoText() const QString QUndoStack::redoText() const
@ -1129,7 +1129,7 @@ bool QUndoStack::isActive() const
\a idx specifies the index of the current command, ie. the command which will be \a idx specifies the index of the current command, ie. the command which will be
executed on the next call to redo(). executed on the next call to redo().
\sa index() setIndex() \sa index(), setIndex()
*/ */
/*! /*!
@ -1139,7 +1139,7 @@ bool QUndoStack::isActive() const
If \a clean is true, the stack is in a clean state; otherwise this signal If \a clean is true, the stack is in a clean state; otherwise this signal
indicates that it has left the clean state. indicates that it has left the clean state.
\sa isClean() setClean() \sa isClean(), setClean()
*/ */
/*! /*!

8
src/widgets/util/qundoview.cpp
View File

@ -350,7 +350,7 @@ QUndoView::~QUndoView()
Returns the stack currently displayed by this view. If the view is looking at a Returns the stack currently displayed by this view. If the view is looking at a
QUndoGroup, this the group's active stack. QUndoGroup, this the group's active stack.
\sa setStack() setGroup() \sa setStack(), setGroup()
*/ */
QUndoStack *QUndoView::stack() const QUndoStack *QUndoView::stack() const
@ -365,7 +365,7 @@ QUndoStack *QUndoView::stack() const
If the view was previously looking at a QUndoGroup, the group is set to 0. If the view was previously looking at a QUndoGroup, the group is set to 0.
\sa stack() setGroup() \sa stack(), setGroup()
*/ */
void QUndoView::setStack(QUndoStack *stack) void QUndoView::setStack(QUndoStack *stack)
@ -385,7 +385,7 @@ void QUndoView::setStack(QUndoStack *stack)
The view will update itself autmiatically whenever the active stack of the group changes. The view will update itself autmiatically whenever the active stack of the group changes.
\sa group() setStack() \sa group(), setStack()
*/ */
void QUndoView::setGroup(QUndoGroup *group) void QUndoView::setGroup(QUndoGroup *group)
@ -416,7 +416,7 @@ void QUndoView::setGroup(QUndoGroup *group)
If the view is not looking at group, this function returns 0. If the view is not looking at group, this function returns 0.
\sa setGroup() setStack() \sa setGroup(), setStack()
*/ */
QUndoGroup *QUndoView::group() const QUndoGroup *QUndoView::group() const

4
src/widgets/widgets/qabstractslider.cpp
View File

@ -171,7 +171,7 @@ QT_BEGIN_NAMESPACE
This signal is emitted when the user releases the slider with the This signal is emitted when the user releases the slider with the
mouse, or programmatically when setSliderDown(false) is called. mouse, or programmatically when setSliderDown(false) is called.
\sa sliderPressed() sliderMoved() sliderDown \sa sliderPressed(), sliderMoved(), sliderDown
*/ */
/*! /*!
@ -238,7 +238,7 @@ QAbstractSliderPrivate::~QAbstractSliderPrivate()
If \a max is smaller than \a min, \a min becomes the only legal If \a max is smaller than \a min, \a min becomes the only legal
value. value.
\sa minimum maximum \sa minimum, maximum
*/ */
void QAbstractSlider::setRange(int min, int max) void QAbstractSlider::setRange(int min, int max)
{ {

8
src/widgets/widgets/qbuttongroup.cpp
View File

@ -82,7 +82,7 @@
of the mapping mechanism is to simplify the representation of enum of the mapping mechanism is to simplify the representation of enum
values in a user interface. values in a user interface.
\sa QGroupBox QPushButton, QCheckBox, QRadioButton \sa QGroupBox, QPushButton, QCheckBox, QRadioButton
*/ */
/*! /*!
@ -90,7 +90,7 @@
Constructs a new, empty button group with the given \a parent. Constructs a new, empty button group with the given \a parent.
\sa addButton() setExclusive() \sa addButton(), setExclusive()
*/ */
/*! /*!
@ -183,7 +183,7 @@
starting with -2. If you are assigning your own ids, use starting with -2. If you are assigning your own ids, use
positive values to avoid conflicts. positive values to avoid conflicts.
\sa removeButton() buttons() \sa removeButton(), buttons()
*/ */
/*! /*!
@ -191,7 +191,7 @@
Removes the given \a button from the button group. Removes the given \a button from the button group.
\sa addButton() buttons() \sa addButton(), buttons()
*/ */
/*! /*!

4
src/widgets/widgets/qcheckbox.cpp
View File

@ -233,7 +233,7 @@ bool QCheckBox::isTristate() const
Returns the check box's check state. If you do not need tristate support, Returns the check box's check state. If you do not need tristate support,
you can also use \l QAbstractButton::isChecked() which returns a boolean. you can also use \l QAbstractButton::isChecked() which returns a boolean.
\sa setCheckState() Qt::CheckState \sa setCheckState(), Qt::CheckState
*/ */
Qt::CheckState QCheckBox::checkState() const Qt::CheckState QCheckBox::checkState() const
{ {
@ -248,7 +248,7 @@ Qt::CheckState QCheckBox::checkState() const
support, you can also use \l QAbstractButton::setChecked() which takes a support, you can also use \l QAbstractButton::setChecked() which takes a
boolean. boolean.
\sa checkState() Qt::CheckState \sa checkState(), Qt::CheckState
*/ */
void QCheckBox::setCheckState(Qt::CheckState state) void QCheckBox::setCheckState(Qt::CheckState state)
{ {

2
src/widgets/widgets/qcommandlinkbutton.cpp
View File

@ -70,7 +70,7 @@ QT_BEGIN_NAMESPACE
By default it will also carry an arrow icon, indicating that pressing the By default it will also carry an arrow icon, indicating that pressing the
control will open another window or page. control will open another window or page.
\sa QPushButton QRadioButton \sa QPushButton, QRadioButton
*/ */
/*! /*!

6
src/widgets/widgets/qdialogbuttonbox.cpp
View File

@ -874,7 +874,7 @@ QDialogButtonBox::~QDialogButtonBox()
This signal is emitted when a button inside the button box is clicked, as long This signal is emitted when a button inside the button box is clicked, as long
as it was defined with the \l AcceptRole or \l YesRole. as it was defined with the \l AcceptRole or \l YesRole.
\sa rejected(), clicked() helpRequested() \sa rejected(), clicked(), helpRequested()
*/ */
/*! /*!
@ -883,7 +883,7 @@ QDialogButtonBox::~QDialogButtonBox()
This signal is emitted when a button inside the button box is clicked, as long This signal is emitted when a button inside the button box is clicked, as long
as it was defined with the \l RejectRole or \l NoRole. as it was defined with the \l RejectRole or \l NoRole.
\sa accepted() helpRequested() clicked() \sa accepted(), helpRequested(), clicked()
*/ */
/*! /*!
@ -892,7 +892,7 @@ QDialogButtonBox::~QDialogButtonBox()
This signal is emitted when a button inside the button box is clicked, as long This signal is emitted when a button inside the button box is clicked, as long
as it was defined with the \l HelpRole. as it was defined with the \l HelpRole.
\sa accepted() rejected() clicked() \sa accepted(), rejected(), clicked()
*/ */
/*! /*!

4
src/widgets/widgets/qdockwidget.cpp
View File

@ -1471,7 +1471,7 @@ bool QDockWidget::event(QEvent *event)
The action's text is set to the dock widget's window title. The action's text is set to the dock widget's window title.
\sa QAction::text QWidget::windowTitle \sa QAction::text, QWidget::windowTitle
*/ */
QAction * QDockWidget::toggleViewAction() const QAction * QDockWidget::toggleViewAction() const
{ {
@ -1562,7 +1562,7 @@ QAction * QDockWidget::toggleViewAction() const
to its parent QDockWidget. Hence it can perform such operations as docking to its parent QDockWidget. Hence it can perform such operations as docking
and hiding in response to user actions. and hiding in response to user actions.
\sa titleBarWidget() DockWidgetVerticalTitleBar \sa titleBarWidget(), DockWidgetVerticalTitleBar
*/ */
void QDockWidget::setTitleBarWidget(QWidget *widget) void QDockWidget::setTitleBarWidget(QWidget *widget)

4
src/widgets/widgets/qframe.cpp
View File

@ -150,7 +150,7 @@ inline void QFramePrivate::init()
the lineWidth() and the midLineWidth() to create the total result. the lineWidth() and the midLineWidth() to create the total result.
See the picture of the frames in the main class documentation. See the picture of the frames in the main class documentation.
\sa QFrame::Shadow QFrame::style() QStyle::drawPrimitive() \sa QFrame::Shadow, QFrame::style(), QStyle::drawPrimitive()
*/ */
@ -175,7 +175,7 @@ inline void QFramePrivate::init()
midLineWidth(). See the picture of the frames in the main class midLineWidth(). See the picture of the frames in the main class
documentation. documentation.
\sa QFrame::Shape lineWidth() midLineWidth() \sa QFrame::Shape, lineWidth(), midLineWidth()
*/ */
/*! /*!

20
src/widgets/widgets/qlineedit.cpp
View File

@ -366,7 +366,7 @@ void QLineEdit::setPlaceholderText(const QString& placeholderText)
By default, this property contains an empty string. By default, this property contains an empty string.
\sa setEchoMode() text() EchoMode \sa setEchoMode(), text(), EchoMode
*/ */
QString QLineEdit::displayText() const QString QLineEdit::displayText() const
@ -445,7 +445,7 @@ void QLineEdit::setFrame(bool enable)
\value PasswordEchoOnEdit Display characters as they are entered \value PasswordEchoOnEdit Display characters as they are entered
while editing otherwise display asterisks. while editing otherwise display asterisks.
\sa setEchoMode() echoMode() \sa setEchoMode(), echoMode()
*/ */
@ -466,7 +466,7 @@ void QLineEdit::setFrame(bool enable)
By default, this property is set to \l Normal. By default, this property is set to \l Normal.
\sa EchoMode displayText() \sa EchoMode, displayText()
*/ */
QLineEdit::EchoMode QLineEdit::echoMode() const QLineEdit::EchoMode QLineEdit::echoMode() const
@ -524,7 +524,7 @@ const QValidator * QLineEdit::validator() const
The initial setting is to have no input validator (i.e. any input The initial setting is to have no input validator (i.e. any input
is accepted up to maxLength()). is accepted up to maxLength()).
\sa validator() QIntValidator QDoubleValidator QRegExpValidator \sa validator(), QIntValidator, QDoubleValidator, QRegExpValidator
*/ */
void QLineEdit::setValidator(const QValidator *v) void QLineEdit::setValidator(const QValidator *v)
@ -901,7 +901,7 @@ int QLineEdit::selectionStart() const
Selects text from position \a start and for \a length characters. Selects text from position \a start and for \a length characters.
Negative lengths are allowed. Negative lengths are allowed.
\sa deselect() selectAll() selectedText() \sa deselect(), selectAll(), selectedText()
*/ */
void QLineEdit::setSelection(int start, int length) void QLineEdit::setSelection(int start, int length)
@ -1159,7 +1159,7 @@ void QLineEdit::setInputMask(const QString &inputMask)
because if the user types before clicking on the widget, the because if the user types before clicking on the widget, the
selected text will be deleted. selected text will be deleted.
\sa setSelection() deselect() \sa setSelection(), deselect()
*/ */
void QLineEdit::selectAll() void QLineEdit::selectAll()
@ -1171,7 +1171,7 @@ void QLineEdit::selectAll()
/*! /*!
Deselects any selected text. Deselects any selected text.
\sa setSelection() selectAll() \sa setSelection(), selectAll()
*/ */
void QLineEdit::deselect() void QLineEdit::deselect()
@ -1276,7 +1276,7 @@ void QLineEdit::setReadOnly(bool enable)
If the current validator disallows deleting the selected text, If the current validator disallows deleting the selected text,
cut() will copy without deleting. cut() will copy without deleting.
\sa copy() paste() setValidator() \sa copy(), paste(), setValidator()
*/ */
void QLineEdit::cut() void QLineEdit::cut()
@ -1292,7 +1292,7 @@ void QLineEdit::cut()
Copies the selected text to the clipboard, if there is any, and if Copies the selected text to the clipboard, if there is any, and if
echoMode() is \l Normal. echoMode() is \l Normal.
\sa cut() paste() \sa cut(), paste()
*/ */
void QLineEdit::copy() const void QLineEdit::copy() const
@ -1309,7 +1309,7 @@ void QLineEdit::copy() const
If the end result would not be acceptable to the current If the end result would not be acceptable to the current
\link setValidator() validator\endlink, nothing happens. \link setValidator() validator\endlink, nothing happens.
\sa copy() cut() \sa copy(), cut()
*/ */
void QLineEdit::paste() void QLineEdit::paste()

8
src/widgets/widgets/qmainwindow.cpp
View File

@ -718,7 +718,7 @@ void QMainWindow::removeToolBarBreak(QToolBar *before)
bar block (i.e. line). If the main window already manages \a toolbar bar block (i.e. line). If the main window already manages \a toolbar
then it will only move the toolbar to \a area. then it will only move the toolbar to \a area.
\sa insertToolBar() addToolBarBreak() insertToolBarBreak() \sa insertToolBar(), addToolBarBreak(), insertToolBarBreak()
*/ */
void QMainWindow::addToolBar(Qt::ToolBarArea area, QToolBar *toolbar) void QMainWindow::addToolBar(Qt::ToolBarArea area, QToolBar *toolbar)
{ {
@ -788,7 +788,7 @@ QToolBar *QMainWindow::addToolBar(const QString &title)
layout operation, this means that \a toolbar will appear to the left layout operation, this means that \a toolbar will appear to the left
of the toolbar specified by \a before in a horizontal toolbar area. of the toolbar specified by \a before in a horizontal toolbar area.
\sa insertToolBarBreak() addToolBar() addToolBarBreak() \sa insertToolBarBreak(), addToolBar(), addToolBarBreak()
*/ */
void QMainWindow::insertToolBar(QToolBar *before, QToolBar *toolbar) void QMainWindow::insertToolBar(QToolBar *before, QToolBar *toolbar)
{ {
@ -823,7 +823,7 @@ void QMainWindow::removeToolBar(QToolBar *toolbar)
been added to the main window, this function returns \c been added to the main window, this function returns \c
Qt::NoToolBarArea. Qt::NoToolBarArea.
\sa addToolBar() addToolBarBreak() Qt::ToolBarArea \sa addToolBar(), addToolBarBreak(), Qt::ToolBarArea
*/ */
Qt::ToolBarArea QMainWindow::toolBarArea(QToolBar *toolbar) const Qt::ToolBarArea QMainWindow::toolBarArea(QToolBar *toolbar) const
{ return d_func()->layout->toolBarArea(toolbar); } { return d_func()->layout->toolBarArea(toolbar); }
@ -1191,7 +1191,7 @@ void QMainWindow::removeDockWidget(QDockWidget *dockwidget)
has not been added to the main window, this function returns \c has not been added to the main window, this function returns \c
Qt::NoDockWidgetArea. Qt::NoDockWidgetArea.
\sa addDockWidget() splitDockWidget() Qt::DockWidgetArea \sa addDockWidget(), splitDockWidget(), Qt::DockWidgetArea
*/ */
Qt::DockWidgetArea QMainWindow::dockWidgetArea(QDockWidget *dockwidget) const Qt::DockWidgetArea QMainWindow::dockWidgetArea(QDockWidget *dockwidget) const
{ return d_func()->layout->dockWidgetArea(dockwidget); } { return d_func()->layout->dockWidgetArea(dockwidget); }

12
src/widgets/widgets/qmenu.cpp
View File

@ -1140,7 +1140,7 @@ bool QMenuPrivate::hasMouseMoved(const QPoint &globalPos)
is useful for subclasses when they need a QStyleOptionMenuItem, but don't want is useful for subclasses when they need a QStyleOptionMenuItem, but don't want
to fill in all the information themselves. to fill in all the information themselves.
\sa QStyleOption::initFrom() QMenuBar::initStyleOption() \sa QStyleOption::initFrom(), QMenuBar::initStyleOption()
*/ */
void QMenu::initStyleOption(QStyleOptionMenuItem *option, const QAction *action) const void QMenu::initStyleOption(QStyleOptionMenuItem *option, const QAction *action) const
{ {
@ -1444,7 +1444,7 @@ QAction *QMenu::addAction(const QIcon &icon, const QString &text, const QObject
It returns \a menu's menuAction(). This menu does not take It returns \a menu's menuAction(). This menu does not take
ownership of \a menu. ownership of \a menu.
\sa QWidget::addAction() QMenu::menuAction() \sa QWidget::addAction(), QMenu::menuAction()
*/ */
QAction *QMenu::addMenu(QMenu *menu) QAction *QMenu::addMenu(QMenu *menu)
{ {
@ -1457,7 +1457,7 @@ QAction *QMenu::addMenu(QMenu *menu)
Appends a new QMenu with \a title to the menu. The menu Appends a new QMenu with \a title to the menu. The menu
takes ownership of the menu. Returns the new menu. takes ownership of the menu. Returns the new menu.
\sa QWidget::addAction() QMenu::menuAction() \sa QWidget::addAction(), QMenu::menuAction()
*/ */
QMenu *QMenu::addMenu(const QString &title) QMenu *QMenu::addMenu(const QString &title)
{ {
@ -1470,7 +1470,7 @@ QMenu *QMenu::addMenu(const QString &title)
Appends a new QMenu with \a icon and \a title to the menu. The menu Appends a new QMenu with \a icon and \a title to the menu. The menu
takes ownership of the menu. Returns the new menu. takes ownership of the menu. Returns the new menu.
\sa QWidget::addAction() QMenu::menuAction() \sa QWidget::addAction(), QMenu::menuAction()
*/ */
QMenu *QMenu::addMenu(const QIcon &icon, const QString &title) QMenu *QMenu::addMenu(const QIcon &icon, const QString &title)
{ {
@ -1584,7 +1584,7 @@ bool QMenu::isTearOffEnabled() const
contents in a new window. When the menu is in this mode and the menu contents in a new window. When the menu is in this mode and the menu
is visible returns true; otherwise false. is visible returns true; otherwise false.
\sa hideTearOffMenu() isTearOffEnabled() \sa hideTearOffMenu(), isTearOffEnabled()
*/ */
bool QMenu::isTearOffMenuVisible() const bool QMenu::isTearOffMenuVisible() const
{ {
@ -1597,7 +1597,7 @@ bool QMenu::isTearOffMenuVisible() const
This function will forcibly hide the torn off menu making it This function will forcibly hide the torn off menu making it
disappear from the users desktop. disappear from the users desktop.
\sa isTearOffMenuVisible() isTearOffEnabled() \sa isTearOffMenuVisible(), isTearOffEnabled()
*/ */
void QMenu::hideTearOffMenu() void QMenu::hideTearOffMenu()
{ {

10
src/widgets/widgets/qmenubar.cpp
View File

@ -547,7 +547,7 @@ void QMenuBarPrivate::_q_actionHovered()
is useful for subclasses when they need a QStyleOptionMenuItem, but don't want is useful for subclasses when they need a QStyleOptionMenuItem, but don't want
to fill in all the information themselves. to fill in all the information themselves.
\sa QStyleOption::initFrom() QMenu::initStyleOption() \sa QStyleOption::initFrom(), QMenu::initStyleOption()
*/ */
void QMenuBar::initStyleOption(QStyleOptionMenuItem *option, const QAction *action) const void QMenuBar::initStyleOption(QStyleOptionMenuItem *option, const QAction *action) const
{ {
@ -831,7 +831,7 @@ QAction *QMenuBar::addAction(const QString &text, const QObject *receiver, const
Appends a new QMenu with \a title to the menu bar. The menu bar Appends a new QMenu with \a title to the menu bar. The menu bar
takes ownership of the menu. Returns the new menu. takes ownership of the menu. Returns the new menu.
\sa QWidget::addAction() QMenu::menuAction() \sa QWidget::addAction(), QMenu::menuAction()
*/ */
QMenu *QMenuBar::addMenu(const QString &title) QMenu *QMenuBar::addMenu(const QString &title)
{ {
@ -844,7 +844,7 @@ QMenu *QMenuBar::addMenu(const QString &title)
Appends a new QMenu with \a icon and \a title to the menu bar. The menu bar Appends a new QMenu with \a icon and \a title to the menu bar. The menu bar
takes ownership of the menu. Returns the new menu. takes ownership of the menu. Returns the new menu.
\sa QWidget::addAction() QMenu::menuAction() \sa QWidget::addAction(), QMenu::menuAction()
*/ */
QMenu *QMenuBar::addMenu(const QIcon &icon, const QString &title) QMenu *QMenuBar::addMenu(const QIcon &icon, const QString &title)
{ {
@ -860,7 +860,7 @@ QMenu *QMenuBar::addMenu(const QIcon &icon, const QString &title)
\note The returned QAction object can be used to hide the corresponding \note The returned QAction object can be used to hide the corresponding
menu. menu.
\sa QWidget::addAction() QMenu::menuAction() \sa QWidget::addAction(), QMenu::menuAction()
*/ */
QAction *QMenuBar::addMenu(QMenu *menu) QAction *QMenuBar::addMenu(QMenu *menu)
{ {
@ -900,7 +900,7 @@ QAction *QMenuBar::insertSeparator(QAction *before)
This convenience function inserts \a menu before action \a before This convenience function inserts \a menu before action \a before
and returns the menus menuAction(). and returns the menus menuAction().
\sa QWidget::insertAction() addMenu() \sa QWidget::insertAction(), addMenu()
*/ */
QAction *QMenuBar::insertMenu(QAction *before, QMenu *menu) QAction *QMenuBar::insertMenu(QAction *before, QMenu *menu)
{ {

8
src/widgets/widgets/qplaintextedit.cpp
View File

@ -1383,7 +1383,7 @@ void QPlainTextEdit::redo()
If there is no selected text nothing happens. If there is no selected text nothing happens.
\sa copy() paste() \sa copy(), paste()
*/ */
void QPlainTextEdit::cut() void QPlainTextEdit::cut()
@ -1415,7 +1415,7 @@ void QPlainTextEdit::copy()
virtual canInsertFromMimeData() and insertFromMimeData() virtual canInsertFromMimeData() and insertFromMimeData()
functions. functions.
\sa cut() copy() \sa cut(), copy()
*/ */
void QPlainTextEdit::paste() void QPlainTextEdit::paste()
@ -1430,7 +1430,7 @@ void QPlainTextEdit::paste()
Note that the undo/redo history is cleared by this function. Note that the undo/redo history is cleared by this function.
\sa cut() setPlainText() \sa cut(), setPlainText()
*/ */
void QPlainTextEdit::clear() void QPlainTextEdit::clear()
{ {
@ -1444,7 +1444,7 @@ void QPlainTextEdit::clear()
/*! /*!
Selects all text. Selects all text.
\sa copy() cut() textCursor() \sa copy(), cut(), textCursor()
*/ */
void QPlainTextEdit::selectAll() void QPlainTextEdit::selectAll()
{ {

2
src/widgets/widgets/qprogressbar.cpp
View File

@ -338,7 +338,7 @@ int QProgressBar::value() const
If the current value falls outside the new range, the progress bar is reset If the current value falls outside the new range, the progress bar is reset
with reset(). with reset().
\sa minimum maximum \sa minimum, maximum
*/ */
void QProgressBar::setRange(int minimum, int maximum) void QProgressBar::setRange(int minimum, int maximum)
{ {

2
src/widgets/widgets/qsizegrip.cpp
View File

@ -207,7 +207,7 @@ Qt::Corner QSizeGripPrivate::corner() const
{QWidget::paintEvent()}{paintEvent()} function to render the {QWidget::paintEvent()}{paintEvent()} function to render the
size grip widget. size grip widget.
\sa QStatusBar QWidget::windowState() \sa QStatusBar, QWidget::windowState()
*/ */

10
src/widgets/widgets/qspinbox.cpp
View File

@ -356,7 +356,7 @@ void QSpinBox::setSingleStep(int value)
The default minimum value is 0. The default minimum value is 0.
\sa setRange() specialValueText \sa setRange(), specialValueText
*/ */
int QSpinBox::minimum() const int QSpinBox::minimum() const
@ -383,7 +383,7 @@ void QSpinBox::setMinimum(int minimum)
The default maximum value is 99. The default maximum value is 99.
\sa setRange() specialValueText \sa setRange(), specialValueText
*/ */
@ -409,7 +409,7 @@ void QSpinBox::setMaximum(int maximum)
is equivalent to: is equivalent to:
\snippet code/src_gui_widgets_qspinbox.cpp 3 \snippet code/src_gui_widgets_qspinbox.cpp 3
\sa minimum maximum \sa minimum, maximum
*/ */
void QSpinBox::setRange(int minimum, int maximum) void QSpinBox::setRange(int minimum, int maximum)
@ -728,7 +728,7 @@ void QDoubleSpinBox::setSingleStep(double value)
Note: The minimum value will be rounded to match the decimals Note: The minimum value will be rounded to match the decimals
property. property.
\sa decimals, setRange() specialValueText \sa decimals, setRange(), specialValueText
*/ */
double QDoubleSpinBox::minimum() const double QDoubleSpinBox::minimum() const
@ -788,7 +788,7 @@ void QDoubleSpinBox::setMaximum(double maximum)
is equivalent to: is equivalent to:
\snippet code/src_gui_widgets_qspinbox.cpp 7 \snippet code/src_gui_widgets_qspinbox.cpp 7
\sa minimum maximum \sa minimum, maximum
*/ */
void QDoubleSpinBox::setRange(double minimum, double maximum) void QDoubleSpinBox::setRange(double minimum, double maximum)

8
src/widgets/widgets/qsplitter.cpp
View File

@ -182,7 +182,7 @@ QSplitter *QSplitterHandle::splitter() const
right-to-left languages. This function will map \a pos to the right-to-left languages. This function will map \a pos to the
appropriate position before calling QSplitter::moveSplitter(). appropriate position before calling QSplitter::moveSplitter().
\sa QSplitter::moveSplitter() closestLegalPosition() \sa QSplitter::moveSplitter(), closestLegalPosition()
*/ */
void QSplitterHandle::moveSplitter(int pos) void QSplitterHandle::moveSplitter(int pos)
{ {
@ -1086,7 +1086,7 @@ void QSplitter::resizeEvent(QResizeEvent *)
If \a widget is already in the splitter, it will be moved to the new position. If \a widget is already in the splitter, it will be moved to the new position.
\sa insertWidget() widget() indexOf() \sa insertWidget(), widget(), indexOf()
*/ */
void QSplitter::addWidget(QWidget *widget) void QSplitter::addWidget(QWidget *widget)
{ {
@ -1102,7 +1102,7 @@ void QSplitter::addWidget(QWidget *widget)
if \a index is an invalid index, then the widget will be inserted at the end. if \a index is an invalid index, then the widget will be inserted at the end.
\sa addWidget() indexOf() widget() \sa addWidget(), indexOf(), widget()
*/ */
void QSplitter::insertWidget(int index, QWidget *widget) void QSplitter::insertWidget(int index, QWidget *widget)
{ {
@ -1201,7 +1201,7 @@ int QSplitter::count() const
putting widgets into a splitter in new code. Please use insertWidget() or putting widgets into a splitter in new code. Please use insertWidget() or
addWidget() in new code. addWidget() in new code.
\sa addWidget() insertWidget() \sa addWidget(), insertWidget()
*/ */
void QSplitter::childEvent(QChildEvent *c) void QSplitter::childEvent(QChildEvent *c)

8
src/widgets/widgets/qtabbar.cpp
View File

@ -119,7 +119,7 @@ void QTabBarPrivate::updateMacBorderMetrics()
This function will check the version of the QStyleOptionTab and fill in the This function will check the version of the QStyleOptionTab and fill in the
additional values for a QStyleOptionTabV2 and QStyleOptionTabV3. additional values for a QStyleOptionTabV2 and QStyleOptionTabV3.
\sa QStyleOption::initFrom() QTabWidget::initStyleOption() \sa QStyleOption::initFrom(), QTabWidget::initStyleOption()
*/ */
void QTabBar::initStyleOption(QStyleOptionTab *option, int tabIndex) const void QTabBar::initStyleOption(QStyleOptionTab *option, int tabIndex) const
{ {
@ -739,7 +739,7 @@ void QTabBar::setShape(Shape shape)
If true then QTabBar draws a base in relation to the styles overlab. If true then QTabBar draws a base in relation to the styles overlab.
Otherwise only the tabs are drawn. Otherwise only the tabs are drawn.
\sa QStyle::pixelMetric() QStyle::PM_TabBarBaseOverlap QStyleOptionTabBarBaseV2 \sa QStyle::pixelMetric(), QStyle::PM_TabBarBaseOverlap, QStyleOptionTabBarBaseV2
*/ */
void QTabBar::setDrawBase(bool drawBase) void QTabBar::setDrawBase(bool drawBase)
@ -1992,7 +1992,7 @@ void QTabBar::changeEvent(QEvent *event)
By default the value is style dependent. By default the value is style dependent.
\sa QTabWidget::elideMode usesScrollButtons QStyle::SH_TabBar_ElideMode \sa QTabWidget::elideMode, usesScrollButtons, QStyle::SH_TabBar_ElideMode
*/ */
Qt::TextElideMode QTabBar::elideMode() const Qt::TextElideMode QTabBar::elideMode() const
@ -2020,7 +2020,7 @@ void QTabBar::setElideMode(Qt::TextElideMode mode)
By default the value is style dependant. By default the value is style dependant.
\sa elideMode QTabWidget::usesScrollButtons QStyle::SH_TabBar_PreferNoArrows \sa elideMode, QTabWidget::usesScrollButtons, QStyle::SH_TabBar_PreferNoArrows
*/ */
bool QTabBar::usesScrollButtons() const bool QTabBar::usesScrollButtons() const
{ {

8
src/widgets/widgets/qtabwidget.cpp
View File

@ -161,7 +161,7 @@ QT_BEGIN_NAMESPACE
if there isn't a new one (for example, if there are no widgets if there isn't a new one (for example, if there are no widgets
in the QTabWidget) in the QTabWidget)
\sa currentWidget() currentIndex \sa currentWidget(), currentIndex
*/ */
/*! /*!
@ -256,7 +256,7 @@ bool QTabWidget::hasHeightForWidth() const
for subclasses when they need a QStyleOptionTabWidgetFrame, but don't want to fill for subclasses when they need a QStyleOptionTabWidgetFrame, but don't want to fill
in all the information themselves. in all the information themselves.
\sa QStyleOption::initFrom() QTabBar::initStyleOption() \sa QStyleOption::initFrom(), QTabBar::initStyleOption()
*/ */
void QTabWidget::initStyleOption(QStyleOptionTabWidgetFrame *option) const void QTabWidget::initStyleOption(QStyleOptionTabWidgetFrame *option) const
{ {
@ -1267,7 +1267,7 @@ void QTabWidget::setIconSize(const QSize &size)
By default the value is style dependant. By default the value is style dependant.
\sa QTabBar::elideMode usesScrollButtons QStyle::SH_TabBar_ElideMode \sa QTabBar::elideMode, usesScrollButtons, QStyle::SH_TabBar_ElideMode
*/ */
Qt::TextElideMode QTabWidget::elideMode() const Qt::TextElideMode QTabWidget::elideMode() const
{ {
@ -1290,7 +1290,7 @@ void QTabWidget::setElideMode(Qt::TextElideMode mode)
By default the value is style dependant. By default the value is style dependant.
\sa elideMode QTabBar::usesScrollButtons QStyle::SH_TabBar_PreferNoArrows \sa elideMode, QTabBar::usesScrollButtons, QStyle::SH_TabBar_PreferNoArrows
*/ */
bool QTabWidget::usesScrollButtons() const bool QTabWidget::usesScrollButtons() const
{ {

22
src/widgets/widgets/qtextedit.cpp
View File

@ -613,7 +613,7 @@ QTextEdit::~QTextEdit()
/*! /*!
Returns the point size of the font of the current format. Returns the point size of the font of the current format.
\sa setFontFamily() setCurrentFont() setFontPointSize() \sa setFontFamily(), setCurrentFont(), setFontPointSize()
*/ */
qreal QTextEdit::fontPointSize() const qreal QTextEdit::fontPointSize() const
{ {
@ -624,7 +624,7 @@ qreal QTextEdit::fontPointSize() const
/*! /*!
Returns the font family of the current format. Returns the font family of the current format.
\sa setFontFamily() setCurrentFont() setFontPointSize() \sa setFontFamily(), setCurrentFont(), setFontPointSize()
*/ */
QString QTextEdit::fontFamily() const QString QTextEdit::fontFamily() const
{ {
@ -635,7 +635,7 @@ QString QTextEdit::fontFamily() const
/*! /*!
Returns the font weight of the current format. Returns the font weight of the current format.
\sa setFontWeight() setCurrentFont() setFontPointSize() QFont::Weight \sa setFontWeight(), setCurrentFont(), setFontPointSize(), QFont::Weight
*/ */
int QTextEdit::fontWeight() const int QTextEdit::fontWeight() const
{ {
@ -694,7 +694,7 @@ QColor QTextEdit::textBackgroundColor() const
/*! /*!
Returns the font of the current format. Returns the font of the current format.
\sa setCurrentFont() setFontFamily() setFontPointSize() \sa setCurrentFont(), setFontFamily(), setFontPointSize()
*/ */
QFont QTextEdit::currentFont() const QFont QTextEdit::currentFont() const
{ {
@ -782,7 +782,7 @@ QTextCursor QTextEdit::textCursor() const
/*! /*!
Sets the font family of the current format to \a fontFamily. Sets the font family of the current format to \a fontFamily.
\sa fontFamily() setCurrentFont() \sa fontFamily(), setCurrentFont()
*/ */
void QTextEdit::setFontFamily(const QString &fontFamily) void QTextEdit::setFontFamily(const QString &fontFamily)
{ {
@ -797,7 +797,7 @@ void QTextEdit::setFontFamily(const QString &fontFamily)
Note that if \a s is zero or negative, the behavior of this Note that if \a s is zero or negative, the behavior of this
function is not defined. function is not defined.
\sa fontPointSize() setCurrentFont() setFontFamily() \sa fontPointSize(), setCurrentFont(), setFontFamily()
*/ */
void QTextEdit::setFontPointSize(qreal s) void QTextEdit::setFontPointSize(qreal s)
{ {
@ -877,7 +877,7 @@ void QTextEdit::setTextBackgroundColor(const QColor &c)
/*! /*!
Sets the font of the current format to \a f. Sets the font of the current format to \a f.
\sa currentFont() setFontPointSize() setFontFamily() \sa currentFont(), setFontPointSize(), setFontFamily()
*/ */
void QTextEdit::setCurrentFont(const QFont &f) void QTextEdit::setCurrentFont(const QFont &f)
{ {
@ -935,7 +935,7 @@ void QTextEdit::redo()
If there is no selected text nothing happens. If there is no selected text nothing happens.
\sa copy() paste() \sa copy(), paste()
*/ */
void QTextEdit::cut() void QTextEdit::cut()
@ -967,7 +967,7 @@ void QTextEdit::copy()
virtual canInsertFromMimeData() and insertFromMimeData() virtual canInsertFromMimeData() and insertFromMimeData()
functions. functions.
\sa cut() copy() \sa cut(), copy()
*/ */
void QTextEdit::paste() void QTextEdit::paste()
@ -982,7 +982,7 @@ void QTextEdit::paste()
Note that the undo/redo history is cleared by this function. Note that the undo/redo history is cleared by this function.
\sa cut() setPlainText() setHtml() \sa cut(), setPlainText(), setHtml()
*/ */
void QTextEdit::clear() void QTextEdit::clear()
{ {
@ -995,7 +995,7 @@ void QTextEdit::clear()
/*! /*!
Selects all text. Selects all text.
\sa copy() cut() textCursor() \sa copy(), cut(), textCursor()
*/ */
void QTextEdit::selectAll() void QTextEdit::selectAll()
{ {

6
src/widgets/widgets/qtoolbar.cpp
View File

@ -484,7 +484,7 @@ void QToolBarPrivate::plug(const QRect &r)
This signal is emitted when the icon size is changed. The \a This signal is emitted when the icon size is changed. The \a
iconSize parameter holds the toolbar's new icon size. iconSize parameter holds the toolbar's new icon size.
\sa iconSize QMainWindow::iconSize \sa iconSize, QMainWindow::iconSize
*/ */
/*! /*!
@ -513,7 +513,7 @@ void QToolBarPrivate::plug(const QRect &r)
\a toolButtonStyle parameter holds the toolbar's new tool button \a toolButtonStyle parameter holds the toolbar's new tool button
style. style.
\sa toolButtonStyle QMainWindow::toolButtonStyle \sa toolButtonStyle, QMainWindow::toolButtonStyle
*/ */
/*! /*!
@ -1209,7 +1209,7 @@ bool QToolBar::event(QEvent *event)
The action's text is set to the toolbar's window title. The action's text is set to the toolbar's window title.
\sa QAction::text QWidget::windowTitle \sa QAction::text, QWidget::windowTitle
*/ */
QAction *QToolBar::toggleViewAction() const QAction *QToolBar::toggleViewAction() const
{ Q_D(const QToolBar); return d->toggleViewAction; } { Q_D(const QToolBar); return d->toggleViewAction; }