diff options
Diffstat (limited to 'src/widgets/widgets')
29 files changed, 85 insertions, 85 deletions
diff --git a/src/widgets/widgets/qabstractbutton.cpp b/src/widgets/widgets/qabstractbutton.cpp index cdadde5cc1..acec526512 100644 --- a/src/widgets/widgets/qabstractbutton.cpp +++ b/src/widgets/widgets/qabstractbutton.cpp @@ -795,7 +795,7 @@ bool QAbstractButton::isChecked() const \property QAbstractButton::down \brief whether the button is pressed down - If this property is true, the button is pressed down. The signals + If this property is \c true, the button is pressed down. The signals pressed() and clicked() are not emitted if you set this property to true. The default is false. */ @@ -1038,8 +1038,8 @@ void QAbstractButton::nextCheckState() } /*! -Returns true if \a pos is inside the clickable button rectangle; -otherwise returns false. +Returns \c true if \a pos is inside the clickable button rectangle; +otherwise returns \c false. By default, the clickable area is the entire widget. Subclasses may reimplement this function to provide support for clickable diff --git a/src/widgets/widgets/qabstractscrollarea.cpp b/src/widgets/widgets/qabstractscrollarea.cpp index e7827055fb..d8ee923f7a 100644 --- a/src/widgets/widgets/qabstractscrollarea.cpp +++ b/src/widgets/widgets/qabstractscrollarea.cpp @@ -1146,8 +1146,8 @@ bool QAbstractScrollArea::event(QEvent *e) It handles the \a event specified, and can be called by subclasses to provide reasonable default behavior. - Returns true to indicate to the event system that the event has been - handled, and needs no further processing; otherwise returns false to + Returns \c true to indicate to the event system that the event has been + handled, and needs no further processing; otherwise returns \c false to indicate that the event should be propagated further. You can reimplement this function in a subclass, but we recommend diff --git a/src/widgets/widgets/qabstractslider.cpp b/src/widgets/widgets/qabstractslider.cpp index 8c3dedb84f..40d8c6b417 100644 --- a/src/widgets/widgets/qabstractslider.cpp +++ b/src/widgets/widgets/qabstractslider.cpp @@ -549,7 +549,7 @@ void QAbstractSlider::setValue(int value) \property QAbstractSlider::invertedAppearance \brief whether or not a slider shows its values inverted. - If this property is false (the default), the minimum and maximum will + If this property is \c false (the default), the minimum and maximum will be shown in its classic position for the inherited widget. If the value is true, the minimum and maximum appear at their opposite location. @@ -577,7 +577,7 @@ void QAbstractSlider::setInvertedAppearance(bool invert) \property QAbstractSlider::invertedControls \brief whether or not the slider inverts its wheel and key events. - If this property is false, scrolling the mouse wheel "up" and using keys + If this property is \c false, scrolling the mouse wheel "up" and using keys like page up will increase the slider's value towards its maximum. Otherwise pressing page up will move value towards the slider's minimum. */ diff --git a/src/widgets/widgets/qabstractspinbox.cpp b/src/widgets/widgets/qabstractspinbox.cpp index 0355578327..25369a01b6 100644 --- a/src/widgets/widgets/qabstractspinbox.cpp +++ b/src/widgets/widgets/qabstractspinbox.cpp @@ -1408,7 +1408,7 @@ void QAbstractSpinBoxPrivate::updateEditFieldGeometry() } /*! \internal - Returns true if a specialValueText has been set and the current value is minimum. + Returns \c true if a specialValueText has been set and the current value is minimum. */ bool QAbstractSpinBoxPrivate::specialValue() const diff --git a/src/widgets/widgets/qbuttongroup.cpp b/src/widgets/widgets/qbuttongroup.cpp index c484b154fd..1385ef590e 100644 --- a/src/widgets/widgets/qbuttongroup.cpp +++ b/src/widgets/widgets/qbuttongroup.cpp @@ -103,7 +103,7 @@ \property QButtonGroup::exclusive \brief whether the button group is exclusive - If this property is true, then only one button in the group can be checked + If this property is \c true, then only one button in the group can be checked at any given time. The user can click on any button to check it, and that button will replace the existing one as the checked button in the group. @@ -111,7 +111,7 @@ by clicking on it; instead, another button in the group must be clicked to set the new checked button for that group. - By default, this property is true. + By default, this property is \c true. */ /*! diff --git a/src/widgets/widgets/qcalendarwidget.cpp b/src/widgets/widgets/qcalendarwidget.cpp index 82c5a29497..8755f99288 100644 --- a/src/widgets/widgets/qcalendarwidget.cpp +++ b/src/widgets/widgets/qcalendarwidget.cpp @@ -2954,7 +2954,7 @@ void QCalendarWidget::updateCells() \since 4.3 - When this property is true (the default), the next month, + When this property is \c true (the default), the next month, previous month, month selection, year selection controls are shown on top. diff --git a/src/widgets/widgets/qcombobox.cpp b/src/widgets/widgets/qcombobox.cpp index 90310308c3..37a14d3eb3 100644 --- a/src/widgets/widgets/qcombobox.cpp +++ b/src/widgets/widgets/qcombobox.cpp @@ -1379,7 +1379,7 @@ int QComboBox::maxCount() const Use setCompleter() instead. - By default, this property is true. + By default, this property is \c true. \sa editable */ @@ -1473,7 +1473,7 @@ void QComboBox::setAutoCompletionCaseSensitivity(Qt::CaseSensitivity sensitivity Note that it is always possible to programmatically insert duplicate items into the combobox. - By default, this property is false (duplicates are not allowed). + By default, this property is \c false (duplicates are not allowed). */ bool QComboBox::duplicatesEnabled() const { @@ -1632,7 +1632,7 @@ void QComboBox::setIconSize(const QSize &size) \property QComboBox::editable \brief whether the combo box can be edited by the user - By default, this property is false. The effect of editing depends + By default, this property is \c false. The effect of editing depends on the insert policy. \sa InsertPolicy diff --git a/src/widgets/widgets/qdial.cpp b/src/widgets/widgets/qdial.cpp index b415b5254a..632e548e6f 100644 --- a/src/widgets/widgets/qdial.cpp +++ b/src/widgets/widgets/qdial.cpp @@ -369,7 +369,7 @@ void QDial::setWrapping(bool enable) into the space at the bottom of the dial, it will be clamped to the closest end of the valid range of values. - By default this property is false. + By default this property is \c false. */ bool QDial::wrapping() const @@ -450,7 +450,7 @@ void QDial::setNotchesVisible(bool visible) \property QDial::notchesVisible \brief whether the notches are shown - If the property is true, a series of notches are drawn around the dial + If the property is \c true, a series of notches are drawn around the dial to indicate the range of values available; otherwise no notches are shown. diff --git a/src/widgets/widgets/qdialogbuttonbox.cpp b/src/widgets/widgets/qdialogbuttonbox.cpp index 226969cdd1..9789c453f3 100644 --- a/src/widgets/widgets/qdialogbuttonbox.cpp +++ b/src/widgets/widgets/qdialogbuttonbox.cpp @@ -1075,7 +1075,7 @@ void QDialogButtonBoxPrivate::_q_handleButtonDestroyed() \property QDialogButtonBox::centerButtons \brief whether the buttons in the button box are centered - By default, this property is false. This behavior is appopriate + By default, this property is \c false. This behavior is appopriate for most types of dialogs. A notable exception is message boxes on most platforms (e.g. Windows), where the button box is centered horizontally. diff --git a/src/widgets/widgets/qdockwidget.cpp b/src/widgets/widgets/qdockwidget.cpp index 45e3f1b10b..a9b21cbc81 100644 --- a/src/widgets/widgets/qdockwidget.cpp +++ b/src/widgets/widgets/qdockwidget.cpp @@ -1247,7 +1247,7 @@ QDockWidget::DockWidgetFeatures QDockWidget::features() const window "on top" of its parent QMainWindow, instead of being docked in the QMainWindow. - By default, this property is true. + By default, this property is \c true. \sa isWindow() */ @@ -1301,8 +1301,8 @@ Qt::DockWidgetAreas QDockWidget::allowedAreas() const /*! \fn bool QDockWidget::isAreaAllowed(Qt::DockWidgetArea area) const - Returns true if this dock widget can be placed in the given \a area; - otherwise returns false. + Returns \c true if this dock widget can be placed in the given \a area; + otherwise returns \c false. */ /*! \reimp */ diff --git a/src/widgets/widgets/qgroupbox.cpp b/src/widgets/widgets/qgroupbox.cpp index d82f151165..14d434ec28 100644 --- a/src/widgets/widgets/qgroupbox.cpp +++ b/src/widgets/widgets/qgroupbox.cpp @@ -543,7 +543,7 @@ void QGroupBox::setFlat(bool b) \property QGroupBox::checkable \brief whether the group box has a checkbox in its title - If this property is true, the group box displays its title using + If this property is \c true, the group box displays its title using a checkbox in place of an ordinary label. If the checkbox is checked, the group box's children are enabled; otherwise, they are disabled and inaccessible. diff --git a/src/widgets/widgets/qlabel.cpp b/src/widgets/widgets/qlabel.cpp index 7f2a7684eb..919d7090e0 100644 --- a/src/widgets/widgets/qlabel.cpp +++ b/src/widgets/widgets/qlabel.cpp @@ -460,7 +460,7 @@ Qt::Alignment QLabel::alignment() const \property QLabel::wordWrap \brief the label's word-wrapping policy - If this property is true then label text is wrapped where + If this property is \c true then label text is wrapped where necessary at word-breaks; otherwise it is not wrapped at all. By default, word wrap is disabled. @@ -749,10 +749,10 @@ void QLabel::setSelection(int start, int length) \property QLabel::hasSelectedText \brief whether there is any text selected - hasSelectedText() returns true if some or all of the text has been - selected by the user; otherwise returns false. + hasSelectedText() returns \c true if some or all of the text has been + selected by the user; otherwise returns \c false. - By default, this property is false. + By default, this property is \c false. \sa selectedText() diff --git a/src/widgets/widgets/qlcdnumber.cpp b/src/widgets/widgets/qlcdnumber.cpp index 5104171fb1..11a456bc47 100644 --- a/src/widgets/widgets/qlcdnumber.cpp +++ b/src/widgets/widgets/qlcdnumber.cpp @@ -468,8 +468,8 @@ int QLCDNumber::digitCount() const /*! \overload - Returns true if \a num is too big to be displayed in its entirety; - otherwise returns false. + Returns \c true if \a num is too big to be displayed in its entirety; + otherwise returns \c false. \sa display(), digitCount(), smallDecimalPoint() */ @@ -484,8 +484,8 @@ bool QLCDNumber::checkOverflow(int num) const /*! - Returns true if \a num is too big to be displayed in its entirety; - otherwise returns false. + Returns \c true if \a num is too big to be displayed in its entirety; + otherwise returns \c false. \sa display(), digitCount(), smallDecimalPoint() */ diff --git a/src/widgets/widgets/qlineedit.cpp b/src/widgets/widgets/qlineedit.cpp index adf70fde66..d3c37ab612 100644 --- a/src/widgets/widgets/qlineedit.cpp +++ b/src/widgets/widgets/qlineedit.cpp @@ -908,7 +908,7 @@ void QLineEdit::end(bool mark) do not start out knowing what the default should be (perhaps it depends on other fields on the form). Start the line edit without the best default, and when the default is known, if modified() - returns false (the user hasn't entered any text), insert the + returns \c false (the user hasn't entered any text), insert the default value. Calling setText() resets the modified flag to false. @@ -930,10 +930,10 @@ void QLineEdit::setModified(bool modified) \property QLineEdit::hasSelectedText \brief whether there is any text selected - hasSelectedText() returns true if some or all of the text has been - selected by the user; otherwise returns false. + hasSelectedText() returns \c true if some or all of the text has been + selected by the user; otherwise returns \c false. - By default, this property is false. + By default, this property is \c false. \sa selectedText() */ @@ -1011,7 +1011,7 @@ void QLineEdit::setSelection(int start, int length) Undo becomes available once the user has modified the text in the line edit. - By default, this property is false. + By default, this property is \c false. */ bool QLineEdit::isUndoAvailable() const @@ -1027,7 +1027,7 @@ bool QLineEdit::isUndoAvailable() const Redo becomes available once the user has performed one or more undo operations on text in the line edit. - By default, this property is false. + By default, this property is \c false. */ bool QLineEdit::isRedoAvailable() const @@ -1089,7 +1089,7 @@ void QLineEdit::setCursorMoveStyle(Qt::CursorMoveStyle style) \brief whether the input satisfies the inputMask and the validator. - By default, this property is true. + By default, this property is \c true. \sa setInputMask(), setValidator() */ @@ -1320,7 +1320,7 @@ void QLineEdit::redo() QLineEdit does not show a cursor in read-only mode. - By default, this property is false. + By default, this property is \c false. \sa setEnabled() */ diff --git a/src/widgets/widgets/qmainwindow.cpp b/src/widgets/widgets/qmainwindow.cpp index 0df83189ba..0638981a9c 100644 --- a/src/widgets/widgets/qmainwindow.cpp +++ b/src/widgets/widgets/qmainwindow.cpp @@ -904,8 +904,8 @@ void QMainWindow::setAnimated(bool enabled) \brief whether docks can be nested \since 4.2 - If this property is false, dock areas can only contain a single row - (horizontal or vertical) of dock widgets. If this property is true, + If this property is \c false, dock areas can only contain a single row + (horizontal or vertical) of dock widgets. If this property is \c true, the area occupied by a dock widget can be split in either direction to contain more dock widgets. @@ -1092,8 +1092,8 @@ void QMainWindow::addDockWidget(Qt::DockWidgetArea area, QDockWidget *dockwidget /*! Restores the state of \a dockwidget if it is created after the call - to restoreState(). Returns true if the state was restored; otherwise - returns false. + to restoreState(). Returns \c true if the state was restored; otherwise + returns \c false. \sa restoreState(), saveState() */ diff --git a/src/widgets/widgets/qmdiarea.cpp b/src/widgets/widgets/qmdiarea.cpp index fd94dadac6..5c1d7a6c05 100644 --- a/src/widgets/widgets/qmdiarea.cpp +++ b/src/widgets/widgets/qmdiarea.cpp @@ -2090,7 +2090,7 @@ void QMdiArea::setOption(AreaOption option, bool on) } /*! - Returns true if \a option is enabled; otherwise returns false. + Returns \c true if \a option is enabled; otherwise returns \c false. \sa AreaOption, setOption() */ diff --git a/src/widgets/widgets/qmdisubwindow.cpp b/src/widgets/widgets/qmdisubwindow.cpp index 63d14f2301..b80eb069e2 100644 --- a/src/widgets/widgets/qmdisubwindow.cpp +++ b/src/widgets/widgets/qmdisubwindow.cpp @@ -2383,7 +2383,7 @@ QWidget *QMdiSubWindow::maximizedSystemMenuIconWidget() const } /*! - Returns true if this window is shaded; otherwise returns false. + Returns \c true if this window is shaded; otherwise returns \c false. A window is shaded if it is collapsed so that only the title bar is visible. @@ -2414,7 +2414,7 @@ void QMdiSubWindow::setOption(SubWindowOption option, bool on) } /*! - Returns true if \a option is enabled; otherwise returns false. + Returns \c true if \a option is enabled; otherwise returns \c false. \sa SubWindowOption, setOption() */ diff --git a/src/widgets/widgets/qmenu.cpp b/src/widgets/widgets/qmenu.cpp index c305748c7d..3a4fd449c8 100644 --- a/src/widgets/widgets/qmenu.cpp +++ b/src/widgets/widgets/qmenu.cpp @@ -1649,7 +1649,7 @@ QAction *QMenu::defaultAction() const This "torn-off" copy lives in a separate window. It contains the same menu items as the original menu, with the exception of the tear-off handle. - By default, this property is false. + By default, this property is \c false. */ void QMenu::setTearOffEnabled(bool b) { @@ -1673,7 +1673,7 @@ bool QMenu::isTearOffEnabled() const /*! When a menu is torn off a second menu is shown to display 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 \c true; otherwise false. \sa hideTearOffMenu(), isTearOffEnabled() */ @@ -1721,7 +1721,7 @@ QAction *QMenu::activeAction() const /*! \since 4.2 - Returns true if there are no visible actions inserted into the menu, false + Returns \c true if there are no visible actions inserted into the menu, false otherwise. \sa QWidget::actions() @@ -3164,7 +3164,7 @@ QPlatformMenu *QMenu::platformMenu() should be visually collapsed to a single one. Separators at the beginning or the end of the menu are also hidden. - By default, this property is true. + By default, this property is \c true. */ bool QMenu::separatorsCollapsible() const { @@ -3197,7 +3197,7 @@ void QMenu::setSeparatorsCollapsible(bool collapse) This property specifies whether action menu entries show their tooltip. - By default, this property is false. + By default, this property is \c false. */ bool QMenu::toolTipsVisible() const { diff --git a/src/widgets/widgets/qmenubar.cpp b/src/widgets/widgets/qmenubar.cpp index a7cad28df3..9c1e2f0516 100644 --- a/src/widgets/widgets/qmenubar.cpp +++ b/src/widgets/widgets/qmenubar.cpp @@ -1810,7 +1810,7 @@ QWidget *QMenuBar::cornerWidget(Qt::Corner corner) const This property specifies whether or not the menubar should be used as a native menubar on platforms that support it. The currently supported platforms are Mac OS X and Windows CE. On these platforms - if this property is true, the menubar is used in the native menubar and is not in the window of + if this property is \c true, the menubar is used in the native menubar and is not in the window of its parent, if false the menubar remains in the window. On other platforms the value of this attribute has no effect. diff --git a/src/widgets/widgets/qplaintextedit.cpp b/src/widgets/widgets/qplaintextedit.cpp index 5a8da45a88..90f2e47cd3 100644 --- a/src/widgets/widgets/qplaintextedit.cpp +++ b/src/widgets/widgets/qplaintextedit.cpp @@ -1211,7 +1211,7 @@ void QPlainTextEditPrivate::ensureViewportLayouted() Users are only able to undo or redo actions if this property is true, and if there is an action that can be undone (or redone). - By default, this property is true. + By default, this property is \c true. */ /*! @@ -2332,11 +2332,11 @@ QRect QPlainTextEdit::cursorRect() const As with many text editors, the plain text editor widget can be configured to insert or overwrite existing text with new text entered by the user. - If this property is true, existing text is overwritten, character-for-character + If this property is \c true, existing text is overwritten, character-for-character by new text; otherwise, text is inserted at the cursor position, displacing existing text. - By default, this property is false (new text does not overwrite existing text). + By default, this property is \c false (new text does not overwrite existing text). */ bool QPlainTextEdit::overwriteMode() const @@ -2435,7 +2435,7 @@ QMimeData *QPlainTextEdit::createMimeDataFromSelection() const } /*! - This function returns true if the contents of the MIME data object, specified + This function returns \c true if the contents of the MIME data object, specified by \a source, can be decoded and inserted into the document. It is called for example when during a drag operation the mouse enters this widget and it is necessary to determine whether it is possible to accept the drag. @@ -2747,8 +2747,8 @@ void QPlainTextEdit::setCenterOnScroll(bool enabled) /*! Finds the next occurrence of the string, \a exp, using the given - \a options. Returns true if \a exp was found and changes the - cursor to select the match; otherwise returns false. + \a options. Returns \c true if \a exp was found and changes the + cursor to select the match; otherwise returns \c false. */ bool QPlainTextEdit::find(const QString &exp, QTextDocument::FindFlags options) { diff --git a/src/widgets/widgets/qprogressbar.cpp b/src/widgets/widgets/qprogressbar.cpp index e317933e4d..123cb5bd6e 100644 --- a/src/widgets/widgets/qprogressbar.cpp +++ b/src/widgets/widgets/qprogressbar.cpp @@ -533,7 +533,7 @@ Qt::Orientation QProgressBar::orientation() const \property QProgressBar::invertedAppearance \brief whether or not a progress bar shows its progress inverted - If this property is false, the progress bar grows in the other + If this property is \c false, the progress bar grows in the other direction (e.g. from right to left). By default, the progress bar is not inverted. diff --git a/src/widgets/widgets/qsplitter.cpp b/src/widgets/widgets/qsplitter.cpp index 1f3646ea6e..f58881af0d 100644 --- a/src/widgets/widgets/qsplitter.cpp +++ b/src/widgets/widgets/qsplitter.cpp @@ -158,8 +158,8 @@ Qt::Orientation QSplitterHandle::orientation() const /*! - Returns true if widgets are resized dynamically (opaquely), otherwise - returns false. This value is controlled by the QSplitter. + Returns \c true if widgets are resized dynamically (opaquely), otherwise + returns \c false. This value is controlled by the QSplitter. \sa QSplitter::opaqueResize() @@ -1070,7 +1070,7 @@ void QSplitter::setCollapsible(int index, bool collapse) } /*! - Returns true if the widget at \a index is collapsible, otherwise returns false. + Returns \c true if the widget at \a index is collapsible, otherwise returns \c false. */ bool QSplitter::isCollapsible(int index) const { @@ -1616,7 +1616,7 @@ QByteArray QSplitter::saveState() const /*! Restores the splitter's layout to the \a state specified. - Returns true if the state is restored; otherwise returns false. + Returns \c true if the state is restored; otherwise returns \c false. Typically this is used in conjunction with QSettings to restore the size from a past session. Here is an example: diff --git a/src/widgets/widgets/qtabbar.cpp b/src/widgets/widgets/qtabbar.cpp index 94c85ff92b..094e9af0de 100644 --- a/src/widgets/widgets/qtabbar.cpp +++ b/src/widgets/widgets/qtabbar.cpp @@ -930,8 +930,8 @@ void QTabBar::removeTab(int index) /*! - Returns true if the tab at position \a index is enabled; otherwise - returns false. + Returns \c true if the tab at position \a index is enabled; otherwise + returns \c false. */ bool QTabBar::isTabEnabled(int index) const { @@ -2219,7 +2219,7 @@ void QTabBar::setExpanding(bool enabled) \since 4.5 - By default, this property is false; + By default, this property is \c false; */ bool QTabBar::isMovable() const diff --git a/src/widgets/widgets/qtabwidget.cpp b/src/widgets/widgets/qtabwidget.cpp index 9d14c01490..8c15b3e58e 100644 --- a/src/widgets/widgets/qtabwidget.cpp +++ b/src/widgets/widgets/qtabwidget.cpp @@ -523,7 +523,7 @@ QIcon QTabWidget::tabIcon(int index) const } /*! - Returns true if the page at position \a index is enabled; otherwise returns false. + Returns \c true if the page at position \a index is enabled; otherwise returns \c false. \sa setTabEnabled(), QWidget::isEnabled() */ @@ -1020,7 +1020,7 @@ void QTabWidget::setTabsClosable(bool closeable) \since 4.5 - By default, this property is false; + By default, this property is \c false; */ bool QTabWidget::isMovable() const diff --git a/src/widgets/widgets/qtextbrowser.cpp b/src/widgets/widgets/qtextbrowser.cpp index e05da51207..273a5dabeb 100644 --- a/src/widgets/widgets/qtextbrowser.cpp +++ b/src/widgets/widgets/qtextbrowser.cpp @@ -643,14 +643,14 @@ void QTextBrowserPrivate::restoreHistoryEntry(const HistoryEntry entry) \property QTextBrowser::readOnly \brief whether the text browser is read-only - By default, this property is true. + By default, this property is \c true. */ /*! \property QTextBrowser::undoRedoEnabled \brief whether the text browser supports undo/redo operations - By default, this property is false. + By default, this property is \c false. */ void QTextBrowserPrivate::init() @@ -1103,7 +1103,7 @@ QVariant QTextBrowser::loadResource(int /*type*/, const QUrl &name) /*! \since 4.2 - Returns true if the text browser can go backward in the document history + Returns \c true if the text browser can go backward in the document history using backward(). \sa backwardAvailable(), backward() @@ -1117,7 +1117,7 @@ bool QTextBrowser::isBackwardAvailable() const /*! \since 4.2 - Returns true if the text browser can go forward in the document history + Returns \c true if the text browser can go forward in the document history using forward(). \sa forwardAvailable(), forward() diff --git a/src/widgets/widgets/qtextedit.cpp b/src/widgets/widgets/qtextedit.cpp index 4e0c682493..0f61eb487f 100644 --- a/src/widgets/widgets/qtextedit.cpp +++ b/src/widgets/widgets/qtextedit.cpp @@ -664,7 +664,7 @@ int QTextEdit::fontWeight() const } /*! - Returns true if the font of the current format is underlined; otherwise returns + Returns \c true if the font of the current format is underlined; otherwise returns false. \sa setFontUnderline() @@ -676,7 +676,7 @@ bool QTextEdit::fontUnderline() const } /*! - Returns true if the font of the current format is italic; otherwise returns + Returns \c true if the font of the current format is italic; otherwise returns false. \sa setFontItalic() @@ -1906,11 +1906,11 @@ QString QTextEdit::anchorAt(const QPoint& pos) const As with many text editors, the text editor widget can be configured to insert or overwrite existing text with new text entered by the user. - If this property is true, existing text is overwritten, character-for-character + If this property is \c true, existing text is overwritten, character-for-character by new text; otherwise, text is inserted at the cursor position, displacing existing text. - By default, this property is false (new text does not overwrite existing text). + By default, this property is \c false (new text does not overwrite existing text). */ bool QTextEdit::overwriteMode() const @@ -2054,7 +2054,7 @@ QMimeData *QTextEdit::createMimeDataFromSelection() const } /*! - This function returns true if the contents of the MIME data object, specified + This function returns \c true if the contents of the MIME data object, specified by \a source, can be decoded and inserted into the document. It is called for example when during a drag operation the mouse enters this widget and it is necessary to determine whether it is possible to accept the drag and drop @@ -2445,8 +2445,8 @@ void QTextEdit::setWordWrapMode(QTextOption::WrapMode mode) /*! Finds the next occurrence of the string, \a exp, using the given - \a options. Returns true if \a exp was found and changes the - cursor to select the match; otherwise returns false. + \a options. Returns \c true if \a exp was found and changes the + cursor to select the match; otherwise returns \c false. */ bool QTextEdit::find(const QString &exp, QTextDocument::FindFlags options) { diff --git a/src/widgets/widgets/qtoolbar.cpp b/src/widgets/widgets/qtoolbar.cpp index 0c2dd20d77..5f80bbb1ca 100644 --- a/src/widgets/widgets/qtoolbar.cpp +++ b/src/widgets/widgets/qtoolbar.cpp @@ -446,8 +446,8 @@ void QToolBarPrivate::plug(const QRect &r) /*! \fn bool QToolBar::isAreaAllowed(Qt::ToolBarArea area) const - Returns true if this toolbar is dockable in the given \a area; - otherwise returns false. + Returns \c true if this toolbar is dockable in the given \a area; + otherwise returns \c false. */ /*! @@ -585,7 +585,7 @@ QToolBar::~QToolBar() \brief whether the user can move the toolbar within the toolbar area, or between toolbar areas. - By default, this property is true. + By default, this property is \c true. This property only makes sense if the toolbar is in a QMainWindow. @@ -631,7 +631,7 @@ void QToolBar::setFloatable(bool floatable) \property QToolBar::floating \brief whether the toolbar is an independent window. - By default, this property is true. + By default, this property is \c true. \sa QWidget::isWindow() */ diff --git a/src/widgets/widgets/qtoolbox.cpp b/src/widgets/widgets/qtoolbox.cpp index 1264a5b6f2..e29fa18e35 100644 --- a/src/widgets/widgets/qtoolbox.cpp +++ b/src/widgets/widgets/qtoolbox.cpp @@ -646,7 +646,7 @@ void QToolBox::setItemToolTip(int index, const QString &toolTip) #endif // QT_NO_TOOLTIP /*! - Returns true if the item at position \a index is enabled; otherwise returns false. + Returns \c true if the item at position \a index is enabled; otherwise returns \c false. */ bool QToolBox::isItemEnabled(int index) const diff --git a/src/widgets/widgets/qwidgetlinecontrol.cpp b/src/widgets/widgets/qwidgetlinecontrol.cpp index 6a41144cc1..b16477246f 100644 --- a/src/widgets/widgets/qwidgetlinecontrol.cpp +++ b/src/widgets/widgets/qwidgetlinecontrol.cpp @@ -416,7 +416,7 @@ QRect QWidgetLineControl::cursorRect() const Fixes the current text so that it is valid given any set validators. - Returns true if the text was changed. Otherwise returns false. + Returns \c true if the text was changed. Otherwise returns \c false. */ bool QWidgetLineControl::fixup() // this function assumes that validate currently returns != Acceptable { @@ -1090,10 +1090,10 @@ bool QWidgetLineControl::isValidInput(QChar key, QChar mask) const /*! \internal - Returns true if the given text \a str is valid for any + Returns \c true if the given text \a str is valid for any validator or input mask set for the line control. - Otherwise returns false + Otherwise returns \c false */ bool QWidgetLineControl::hasAcceptableInput(const QString &str) const { |