summaryrefslogtreecommitdiffstats
path: root/src/widgets/itemviews
diff options
context:
space:
mode:
Diffstat (limited to 'src/widgets/itemviews')
-rw-r--r--src/widgets/itemviews/qabstractitemdelegate.cpp4
-rw-r--r--src/widgets/itemviews/qabstractitemview.cpp14
-rw-r--r--src/widgets/itemviews/qdatawidgetmapper.cpp2
-rw-r--r--src/widgets/itemviews/qdirmodel.cpp18
-rw-r--r--src/widgets/itemviews/qheaderview.cpp16
-rw-r--r--src/widgets/itemviews/qitemdelegate.cpp4
-rw-r--r--src/widgets/itemviews/qlistview.cpp18
-rw-r--r--src/widgets/itemviews/qlistwidget.cpp18
-rw-r--r--src/widgets/itemviews/qstyleditemdelegate.cpp4
-rw-r--r--src/widgets/itemviews/qtableview.cpp24
-rw-r--r--src/widgets/itemviews/qtablewidget.cpp10
-rw-r--r--src/widgets/itemviews/qtreeview.cpp34
-rw-r--r--src/widgets/itemviews/qtreewidget.cpp36
13 files changed, 101 insertions, 101 deletions
diff --git a/src/widgets/itemviews/qabstractitemdelegate.cpp b/src/widgets/itemviews/qabstractitemdelegate.cpp
index 7786a74cc6..16a6e2ca38 100644
--- a/src/widgets/itemviews/qabstractitemdelegate.cpp
+++ b/src/widgets/itemviews/qabstractitemdelegate.cpp
@@ -316,7 +316,7 @@ void QAbstractItemDelegate::updateEditorGeometry(QWidget *,
to open a context menu when the right mouse button is pressed on
an item.
- The base implementation returns false (indicating that it has not
+ The base implementation returns \c false (indicating that it has not
handled the event).
*/
bool QAbstractItemDelegate::editorEvent(QEvent *,
@@ -354,7 +354,7 @@ QString QAbstractItemDelegate::elidedText(const QFontMetrics &fontMetrics, int w
\a view \a option and the \a index that corresponds to the item where the
event occurs.
- Returns true if the delegate can handle the event; otherwise returns false.
+ Returns \c true if the delegate can handle the event; otherwise returns \c false.
A return value of true indicates that the data obtained using the index had
the required role.
diff --git a/src/widgets/itemviews/qabstractitemview.cpp b/src/widgets/itemviews/qabstractitemview.cpp
index f4a98d2575..35ba1ed74e 100644
--- a/src/widgets/itemviews/qabstractitemview.cpp
+++ b/src/widgets/itemviews/qabstractitemview.cpp
@@ -566,8 +566,8 @@ void QAbstractItemViewPrivate::_q_scrollerStateChanged()
/*!
\fn bool QAbstractItemView::isIndexHidden(const QModelIndex &index) const
- Returns true if the item referred to by the given \a index is hidden in the view,
- otherwise returns false.
+ Returns \c true if the item referred to by the given \a index is hidden in the view,
+ otherwise returns \c false.
Hiding is a view specific feature. For example in TableView a column can be marked
as hidden or a row in the TreeView.
@@ -1495,11 +1495,11 @@ Qt::DropAction QAbstractItemView::defaultDropAction() const
\property QAbstractItemView::alternatingRowColors
\brief whether to draw the background using alternating colors
- If this property is true, the item background will be drawn using
+ If this property is \c true, the item background will be drawn using
QPalette::Base and QPalette::AlternateBase; otherwise the background
will be drawn using the QPalette::Base color.
- By default, this property is false.
+ By default, this property is \c false.
*/
void QAbstractItemView::setAlternatingRowColors(bool enable)
{
@@ -2061,7 +2061,7 @@ void QAbstractItemView::dropEvent(QDropEvent *event)
else
// place at row, col in drop index
- If it returns true a drop can be done, and dropRow, dropCol and dropIndex reflects the position of the drop.
+ If it returns \c true a drop can be done, and dropRow, dropCol and dropIndex reflects the position of the drop.
\internal
*/
bool QAbstractItemViewPrivate::dropOn(QDropEvent *event, int *dropRow, int *dropCol, QModelIndex *dropIndex)
@@ -2547,8 +2547,8 @@ QModelIndexList QAbstractItemView::selectedIndexes() const
/*!
Starts editing the item at \a index, creating an editor if
- necessary, and returns true if the view's \l{State} is now
- EditingState; otherwise returns false.
+ necessary, and returns \c true if the view's \l{State} is now
+ EditingState; otherwise returns \c false.
The action that caused the editing process is described by
\a trigger, and the associated event is specified by \a event.
diff --git a/src/widgets/itemviews/qdatawidgetmapper.cpp b/src/widgets/itemviews/qdatawidgetmapper.cpp
index e5b7e810fb..76d01dbb2b 100644
--- a/src/widgets/itemviews/qdatawidgetmapper.cpp
+++ b/src/widgets/itemviews/qdatawidgetmapper.cpp
@@ -610,7 +610,7 @@ void QDataWidgetMapper::revert()
value from the widget and sets it in the model. Finally, the
model's \l {QAbstractItemModel::}{submit()} method is invoked.
- Returns true if all the values were submitted, otherwise false.
+ Returns \c true if all the values were submitted, otherwise false.
Note: For database models, QSqlQueryModel::lastError() can be
used to retrieve the last error.
diff --git a/src/widgets/itemviews/qdirmodel.cpp b/src/widgets/itemviews/qdirmodel.cpp
index e1ba0ede57..1e51f4e073 100644
--- a/src/widgets/itemviews/qdirmodel.cpp
+++ b/src/widgets/itemviews/qdirmodel.cpp
@@ -395,8 +395,8 @@ QVariant QDirModel::data(const QModelIndex &index, int role) const
/*!
Sets the data for the model item \a index with the given \a role to
- the data referenced by the \a value. Returns true if successful;
- otherwise returns false.
+ the data referenced by the \a value. Returns \c true if successful;
+ otherwise returns \c false.
\sa Qt::ItemDataRole
*/
@@ -456,8 +456,8 @@ QVariant QDirModel::headerData(int section, Qt::Orientation orientation, int rol
}
/*!
- Returns true if the \a parent model item has children; otherwise
- returns false.
+ Returns \c true if the \a parent model item has children; otherwise
+ returns \c false.
*/
bool QDirModel::hasChildren(const QModelIndex &parent) const
@@ -566,7 +566,7 @@ QMimeData *QDirModel::mimeData(const QModelIndexList &indexes) const
the given \a action over the row in the model specified by the \a row and
\a column and by the \a parent index.
- Returns true if the drop was successful, and false otherwise.
+ Returns \c true if the drop was successful, and false otherwise.
\sa supportedDropActions()
*/
@@ -771,7 +771,7 @@ bool QDirModel::resolveSymlinks() const
If this property is set to false, the directory model will allow renaming, copying
and deleting of files and directories.
- This property is true by default
+ This property is \c true by default
*/
void QDirModel::setReadOnly(bool enable)
@@ -796,7 +796,7 @@ bool QDirModel::isReadOnly() const
Otherwise the directory model will report that an item has children if the item
is a directory.
- This property is false by default
+ This property is \c false by default
*/
void QDirModel::setLazyChildCount(bool enable)
@@ -966,8 +966,8 @@ QModelIndex QDirModel::index(const QString &path, int column) const
}
/*!
- Returns true if the model item \a index represents a directory;
- otherwise returns false.
+ Returns \c true if the model item \a index represents a directory;
+ otherwise returns \c false.
*/
bool QDirModel::isDir(const QModelIndex &index) const
diff --git a/src/widgets/itemviews/qheaderview.cpp b/src/widgets/itemviews/qheaderview.cpp
index 239cc84a0a..123594637a 100644
--- a/src/widgets/itemviews/qheaderview.cpp
+++ b/src/widgets/itemviews/qheaderview.cpp
@@ -294,7 +294,7 @@ static const int maxSizeSection = 1048575; // since section size is in a bitfiel
\property QHeaderView::highlightSections
\brief whether the sections containing selected items are highlighted
- By default, this property is false.
+ By default, this property is \c false.
*/
/*!
@@ -982,8 +982,8 @@ void QHeaderView::resizeSections(QHeaderView::ResizeMode mode)
*/
/*!
- Returns true if the section specified by \a logicalIndex is explicitly
- hidden from the user; otherwise returns false.
+ Returns \c true if the section specified by \a logicalIndex is explicitly
+ hidden from the user; otherwise returns \c false.
\sa hideSection(), showSection(), setSectionHidden(), hiddenSectionCount()
*/
@@ -1139,7 +1139,7 @@ void QHeaderView::setSectionsMovable(bool movable)
/*!
\since 5.0
- Returns true if the header can be moved by the user; otherwise returns
+ Returns \c true if the header can be moved by the user; otherwise returns
false.
\sa setSectionsMovable()
@@ -1189,7 +1189,7 @@ void QHeaderView::setSectionsClickable(bool clickable)
/*!
\since 5.0
- Returns true if the header is clickable; otherwise returns false. A
+ Returns \c true if the header is clickable; otherwise returns \c false. A
clickable header could be set up to allow the user to change the
representation of the data in the view related to the header.
@@ -1395,7 +1395,7 @@ int QHeaderView::stretchSectionCount() const
\property QHeaderView::showSortIndicator
\brief whether the sort indicator is shown
- By default, this property is false.
+ By default, this property is \c false.
\sa setSectionsClickable()
*/
@@ -1681,7 +1681,7 @@ void QHeaderView::doItemsLayout()
}
/*!
- Returns true if sections in the header has been moved; otherwise returns
+ Returns \c true if sections in the header has been moved; otherwise returns
false;
\sa moveSection()
@@ -1695,7 +1695,7 @@ bool QHeaderView::sectionsMoved() const
/*!
\since 4.1
- Returns true if sections in the header has been hidden; otherwise returns
+ Returns \c true if sections in the header has been hidden; otherwise returns
false;
\sa setSectionHidden()
diff --git a/src/widgets/itemviews/qitemdelegate.cpp b/src/widgets/itemviews/qitemdelegate.cpp
index 3e34568a12..0b654a7485 100644
--- a/src/widgets/itemviews/qitemdelegate.cpp
+++ b/src/widgets/itemviews/qitemdelegate.cpp
@@ -1146,8 +1146,8 @@ QRect QItemDelegate::textRectangle(QPainter * /*painter*/, const QRect &rect,
/*!
\fn bool QItemDelegate::eventFilter(QObject *editor, QEvent *event)
- Returns true if the given \a editor is a valid QWidget and the
- given \a event is handled; otherwise returns false. The following
+ Returns \c true if the given \a editor is a valid QWidget and the
+ given \a event is handled; otherwise returns \c false. The following
key press events are handled by default:
\list
diff --git a/src/widgets/itemviews/qlistview.cpp b/src/widgets/itemviews/qlistview.cpp
index 331748eedc..e5a8647f87 100644
--- a/src/widgets/itemviews/qlistview.cpp
+++ b/src/widgets/itemviews/qlistview.cpp
@@ -251,7 +251,7 @@ QListView::Movement QListView::movement() const
\brief which direction the items layout should flow.
If this property is \l LeftToRight, the items will be laid out left
- to right. If the \l isWrapping property is true, the layout will wrap
+ to right. If the \l isWrapping property is \c true, the layout will wrap
when it reaches the right side of the visible area. If this
property is \l TopToBottom, the items will be laid out from the top
of the visible area, wrapping when it reaches the bottom.
@@ -288,7 +288,7 @@ QListView::Flow QListView::flow() const
Setting this property when the view is visible will cause the
items to be laid out again.
- By default, this property is false.
+ By default, this property is \c false.
\sa viewMode
*/
@@ -527,7 +527,7 @@ void QListView::clearPropertyFlags()
}
/*!
- Returns true if the \a row is hidden; otherwise returns false.
+ Returns \c true if the \a row is hidden; otherwise returns \c false.
*/
bool QListView::isRowHidden(int row) const
{
@@ -1529,7 +1529,7 @@ int QListView::modelColumn() const
in the view have the same size. This enables the view to do some
optimizations for performance purposes.
- By default, this property is false.
+ By default, this property is \c false.
*/
void QListView::setUniformItemSizes(bool enable)
{
@@ -1548,9 +1548,9 @@ bool QListView::uniformItemSizes() const
\brief the item text word-wrapping policy
\since 4.2
- If this property is true then the item text is wrapped where
+ If this property is \c true then the item text is wrapped where
necessary at word-breaks; otherwise it is not wrapped at all.
- This property is false by default.
+ This property is \c false by default.
Please note that even if wrapping is enabled, the cell will not be
expanded to make room for the text. It will print ellipsis for
@@ -1577,7 +1577,7 @@ bool QListView::wordWrap() const
\brief if the selection rectangle should be visible
\since 4.3
- If this property is true then the selection rectangle is visible;
+ If this property is \c true then the selection rectangle is visible;
otherwise it will be hidden.
\note The selection rectangle will only be visible if the selection mode
@@ -1585,7 +1585,7 @@ bool QListView::wordWrap() const
draw a selection rectangle if the selection mode is
QAbstractItemView::SingleSelection.
- By default, this property is false.
+ By default, this property is \c false.
*/
void QListView::setSelectionRectVisible(bool show)
{
@@ -2013,7 +2013,7 @@ void QListModeViewBase::dragMoveEvent(QDragMoveEvent *event)
else
// place at row, col in drop index
- If it returns true a drop can be done, and dropRow, dropCol and dropIndex reflects the position of the drop.
+ If it returns \c true a drop can be done, and dropRow, dropCol and dropIndex reflects the position of the drop.
\internal
*/
bool QListModeViewBase::dropOn(QDropEvent *event, int *dropRow, int *dropCol, QModelIndex *dropIndex)
diff --git a/src/widgets/itemviews/qlistwidget.cpp b/src/widgets/itemviews/qlistwidget.cpp
index 27abfb8eb4..aa1dbf1de3 100644
--- a/src/widgets/itemviews/qlistwidget.cpp
+++ b/src/widgets/itemviews/qlistwidget.cpp
@@ -555,7 +555,7 @@ Qt::DropActions QListModel::supportedDropActions() const
\fn bool QListWidgetItem::isSelected() const
\since 4.2
- Returns true if the item is selected; otherwise returns false.
+ Returns \c true if the item is selected; otherwise returns \c false.
\sa setSelected()
*/
@@ -573,7 +573,7 @@ Qt::DropActions QListModel::supportedDropActions() const
\fn bool QListWidgetItem::isHidden() const
\since 4.2
- Returns true if the item is hidden; otherwise returns false.
+ Returns \c true if the item is hidden; otherwise returns \c false.
\sa setHidden()
*/
@@ -725,8 +725,8 @@ QVariant QListWidgetItem::data(int role) const
}
/*!
- Returns true if this item's text is less then \a other item's text;
- otherwise returns false.
+ Returns \c true if this item's text is less then \a other item's text;
+ otherwise returns \c false.
*/
bool QListWidgetItem::operator<(const QListWidgetItem &other) const
{
@@ -1555,7 +1555,7 @@ void QListWidget::sortItems(Qt::SortOrder order)
\property QListWidget::sortingEnabled
\brief whether sorting is enabled
- If this property is true, sorting is enabled for the list; if the property
+ If this property is \c true, sorting is enabled for the list; if the property
is false, sorting is not enabled.
The default value is false.
@@ -1648,7 +1648,7 @@ void QListWidget::setItemWidget(QListWidgetItem *item, QWidget *widget)
}
/*!
- Returns true if \a item is selected; otherwise returns false.
+ Returns \c true if \a item is selected; otherwise returns \c false.
\obsolete
@@ -1717,7 +1717,7 @@ QList<QListWidgetItem*> QListWidget::findItems(const QString &text, Qt::MatchFla
}
/*!
- Returns true if the \a item is explicitly hidden; otherwise returns false.
+ Returns \c true if the \a item is explicitly hidden; otherwise returns \c false.
\obsolete
@@ -1792,8 +1792,8 @@ QMimeData *QListWidget::mimeData(const QList<QListWidgetItem*>) const
#ifndef QT_NO_DRAGANDDROP
/*!
Handles \a data supplied by an external drag and drop operation that ended
- with the given \a action in the given \a index. Returns true if \a data and
- \a action can be handled by the model; otherwise returns false.
+ with the given \a action in the given \a index. Returns \c true if \a data and
+ \a action can be handled by the model; otherwise returns \c false.
\sa supportedDropActions()
*/
diff --git a/src/widgets/itemviews/qstyleditemdelegate.cpp b/src/widgets/itemviews/qstyleditemdelegate.cpp
index c1fa9fe28e..c2aa630918 100644
--- a/src/widgets/itemviews/qstyleditemdelegate.cpp
+++ b/src/widgets/itemviews/qstyleditemdelegate.cpp
@@ -615,8 +615,8 @@ void QStyledItemDelegate::setItemEditorFactory(QItemEditorFactory *factory)
/*!
\fn bool QStyledItemDelegate::eventFilter(QObject *editor, QEvent *event)
- Returns true if the given \a editor is a valid QWidget and the
- given \a event is handled; otherwise returns false. The following
+ Returns \c true if the given \a editor is a valid QWidget and the
+ given \a event is handled; otherwise returns \c false. The following
key press events are handled by default:
\list
diff --git a/src/widgets/itemviews/qtableview.cpp b/src/widgets/itemviews/qtableview.cpp
index 871ad656ea..34e881571e 100644
--- a/src/widgets/itemviews/qtableview.cpp
+++ b/src/widgets/itemviews/qtableview.cpp
@@ -747,9 +747,9 @@ int QTableViewPrivate::sectionSpanSize(const QHeaderView *header, int logical, i
/*!
\internal
- Returns true if the section at logical index \a logical is part of the span
+ Returns \c true if the section at logical index \a logical is part of the span
starting at logical index \a spanLogical and spanning \a span sections;
- otherwise, returns false.
+ otherwise, returns \c false.
*/
bool QTableViewPrivate::spanContainsSection(const QHeaderView *header, int logical, int spanLogical, int span) const
{
@@ -2482,7 +2482,7 @@ int QTableView::columnWidth(int column) const
}
/*!
- Returns true if the given \a row is hidden; otherwise returns false.
+ Returns \c true if the given \a row is hidden; otherwise returns \c false.
\sa isColumnHidden()
*/
@@ -2506,7 +2506,7 @@ void QTableView::setRowHidden(int row, bool hide)
}
/*!
- Returns true if the given \a column is hidden; otherwise returns false.
+ Returns \c true if the given \a column is hidden; otherwise returns \c false.
\sa isRowHidden()
*/
@@ -2535,8 +2535,8 @@ void QTableView::setColumnHidden(int column, bool hide)
\property QTableView::sortingEnabled
\brief whether sorting is enabled
- If this property is true, sorting is enabled for the table. If
- this property is false, sorting is not enabled. The default value
+ If this property is \c true, sorting is enabled for the table. If
+ this property is \c false, sorting is not enabled. The default value
is false.
\note. Setting the property to true with setSortingEnabled()
@@ -2585,8 +2585,8 @@ bool QTableView::isSortingEnabled() const
\property QTableView::showGrid
\brief whether the grid is shown
- If this property is true a grid is drawn for the table; if the
- property is false, no grid is drawn. The default value is true.
+ If this property is \c true a grid is drawn for the table; if the
+ property is \c false, no grid is drawn. The default value is true.
*/
bool QTableView::showGrid() const
{
@@ -2629,9 +2629,9 @@ void QTableView::setGridStyle(Qt::PenStyle style)
\brief the item text word-wrapping policy
\since 4.3
- If this property is true then the item text is wrapped where
+ If this property is \c true then the item text is wrapped where
necessary at word-breaks; otherwise it is not wrapped at all.
- This property is true by default.
+ This property is \c true by default.
Note that even of wrapping is enabled, the cell will not be
expanded to fit all text. Ellipsis will be inserted according to
@@ -2659,11 +2659,11 @@ bool QTableView::wordWrap() const
\brief whether the button in the top-left corner is enabled
\since 4.3
- If this property is true then button in the top-left corner
+ If this property is \c true then button in the top-left corner
of the table view is enabled. Clicking on this button will
select all the cells in the table view.
- This property is true by default.
+ This property is \c true by default.
*/
void QTableView::setCornerButtonEnabled(bool enable)
{
diff --git a/src/widgets/itemviews/qtablewidget.cpp b/src/widgets/itemviews/qtablewidget.cpp
index f15124605f..43b6b62cc1 100644
--- a/src/widgets/itemviews/qtablewidget.cpp
+++ b/src/widgets/itemviews/qtablewidget.cpp
@@ -1041,7 +1041,7 @@ QTableWidgetSelectionRange::~QTableWidgetSelectionRange()
\fn bool QTableWidgetItem::isSelected() const
\since 4.2
- Returns true if the item is selected, otherwise returns false.
+ Returns \c true if the item is selected, otherwise returns \c false.
\sa setSelected()
*/
@@ -1395,7 +1395,7 @@ QVariant QTableWidgetItem::data(int role) const
}
/*!
- Returns true if the item is less than the \a other item; otherwise returns
+ Returns \c true if the item is less than the \a other item; otherwise returns
false.
*/
bool QTableWidgetItem::operator<(const QTableWidgetItem &other) const
@@ -2280,7 +2280,7 @@ void QTableWidget::setCellWidget(int row, int column, QWidget *widget)
}
/*!
- Returns true if the \a item is selected, otherwise returns false.
+ Returns \c true if the \a item is selected, otherwise returns \c false.
\obsolete
@@ -2567,8 +2567,8 @@ QMimeData *QTableWidget::mimeData(const QList<QTableWidgetItem*>) const
/*!
Handles the \a data supplied by a drag and drop operation that ended with
the given \a action in the given \a row and \a column.
- Returns true if the data and action can be handled by the model;
- otherwise returns false.
+ Returns \c true if the data and action can be handled by the model;
+ otherwise returns \c false.
\sa supportedDropActions()
*/
diff --git a/src/widgets/itemviews/qtreeview.cpp b/src/widgets/itemviews/qtreeview.cpp
index 76e15faf2a..22cd9abc73 100644
--- a/src/widgets/itemviews/qtreeview.cpp
+++ b/src/widgets/itemviews/qtreeview.cpp
@@ -397,7 +397,7 @@ void QTreeView::setIndentation(int i)
false, these controls are not shown for top-level items. This can be used to
make a single level tree structure appear like a simple list of items.
- By default, this property is true.
+ By default, this property is \c true.
*/
bool QTreeView::rootIsDecorated() const
{
@@ -425,7 +425,7 @@ void QTreeView::setRootIsDecorated(bool show)
The height is obtained from the first item in the view. It is updated
when the data changes on that item.
- By default, this property is false.
+ By default, this property is \c false.
*/
bool QTreeView::uniformRowHeights() const
{
@@ -446,7 +446,7 @@ void QTreeView::setUniformRowHeights(bool uniform)
This property holds whether the user can expand and collapse items
interactively.
- By default, this property is true.
+ By default, this property is \c true.
*/
bool QTreeView::itemsExpandable() const
@@ -527,7 +527,7 @@ int QTreeView::columnAt(int x) const
}
/*!
- Returns true if the \a column is hidden; otherwise returns false.
+ Returns \c true if the \a column is hidden; otherwise returns \c false.
\sa hideColumn(), isRowHidden()
*/
@@ -555,7 +555,7 @@ void QTreeView::setColumnHidden(int column, bool hide)
\brief whether the header is shown or not.
\since 4.4
- If this property is true, the header is not shown otherwise it is.
+ If this property is \c true, the header is not shown otherwise it is.
The default value is false.
\sa header()
@@ -573,8 +573,8 @@ void QTreeView::setHeaderHidden(bool hide)
}
/*!
- Returns true if the item in the given \a row of the \a parent is hidden;
- otherwise returns false.
+ Returns \c true if the item in the given \a row of the \a parent is hidden;
+ otherwise returns \c false.
\sa setRowHidden(), isColumnHidden()
*/
@@ -612,8 +612,8 @@ void QTreeView::setRowHidden(int row, const QModelIndex &parent, bool hide)
/*!
\since 4.3
- Returns true if the item in first column in the given \a row
- of the \a parent is spanning all the columns; otherwise returns false.
+ Returns \c true if the item in first column in the given \a row
+ of the \a parent is spanning all the columns; otherwise returns \c false.
\sa setFirstColumnSpanned()
*/
@@ -810,7 +810,7 @@ void QTreeView::collapse(const QModelIndex &index)
/*!
\fn bool QTreeView::isExpanded(const QModelIndex &index) const
- Returns true if the model item \a index is expanded; otherwise returns
+ Returns \c true if the model item \a index is expanded; otherwise returns
false.
\sa expand(), expanded(), setExpanded()
@@ -840,7 +840,7 @@ void QTreeView::setExpanded(const QModelIndex &index, bool expanded)
\property QTreeView::sortingEnabled
\brief whether sorting is enabled
- If this property is true, sorting is enabled for the tree; if the property
+ If this property is \c true, sorting is enabled for the tree; if the property
is false, sorting is not enabled. The default value is false.
\note In order to avoid performance issues, it is recommended that
@@ -880,12 +880,12 @@ bool QTreeView::isSortingEnabled() const
\property QTreeView::animated
\brief whether animations are enabled
- If this property is true the treeview will animate expansion
- and collapsing of branches. If this property is false, the treeview
+ If this property is \c true the treeview will animate expansion
+ and collapsing of branches. If this property is \c false, the treeview
will expand or collapse branches immediately without showing
the animation.
- By default, this property is false.
+ By default, this property is \c false.
*/
void QTreeView::setAnimated(bool animate)
@@ -905,7 +905,7 @@ bool QTreeView::isAnimated() const
\property QTreeView::allColumnsShowFocus
\brief whether items should show keyboard focus using all columns
- If this property is true all columns will show focus, otherwise only
+ If this property is \c true all columns will show focus, otherwise only
one column will show focus.
The default is false.
@@ -931,9 +931,9 @@ bool QTreeView::allColumnsShowFocus() const
\brief the item text word-wrapping policy
\since 4.3
- If this property is true then the item text is wrapped where
+ If this property is \c true then the item text is wrapped where
necessary at word-breaks; otherwise it is not wrapped at all.
- This property is false by default.
+ This property is \c false by default.
Note that even if wrapping is enabled, the cell will not be
expanded to fit all text. Ellipsis will be inserted according to
diff --git a/src/widgets/itemviews/qtreewidget.cpp b/src/widgets/itemviews/qtreewidget.cpp
index f098236d5c..e75f602e90 100644
--- a/src/widgets/itemviews/qtreewidget.cpp
+++ b/src/widgets/itemviews/qtreewidget.cpp
@@ -103,7 +103,7 @@ public:
\fn bool QTreeWidgetItem::isDisabled() const
\since 4.3
- Returns true if the item is disabled; otherwise returns false.
+ Returns \c true if the item is disabled; otherwise returns \c false.
\sa setFlags()
*/
@@ -380,7 +380,7 @@ QVariant QTreeModel::data(const QModelIndex &index, int role) const
Sets the data for the item specified by the \a index and \a role
to that referred to by the \a value.
- Returns true if successful; otherwise returns false.
+ Returns \c true if successful; otherwise returns \c false.
*/
bool QTreeModel::setData(const QModelIndex &index, const QVariant &value, int role)
@@ -537,7 +537,7 @@ QVariant QTreeModel::headerData(int section, Qt::Orientation orientation, int ro
Sets the header data for the item specified by the header \a section,
\a orientation and data \a role to the given \a value.
- Returns true if successful; otherwise returns false.
+ Returns \c true if successful; otherwise returns \c false.
*/
bool QTreeModel::setHeaderData(int section, Qt::Orientation orientation,
@@ -681,7 +681,7 @@ void QTreeModel::ensureSorted(int column, Qt::SortOrder order,
/*!
\internal
- Returns true if the value of the \a left item is
+ Returns \c true if the value of the \a left item is
less than the value of the \a right item.
Used by the sorting functions.
@@ -696,7 +696,7 @@ bool QTreeModel::itemLessThan(const QPair<QTreeWidgetItem*,int> &left,
/*!
\internal
- Returns true if the value of the \a left item is
+ Returns \c true if the value of the \a left item is
greater than the value of the \a right item.
Used by the sorting functions.
@@ -1001,7 +1001,7 @@ void QTreeModel::timerEvent(QTimerEvent *ev)
\fn bool QTreeWidgetItem::isSelected() const
\since 4.2
- Returns true if the item is selected, otherwise returns false.
+ Returns \c true if the item is selected, otherwise returns \c false.
\sa setSelected()
*/
@@ -1019,7 +1019,7 @@ void QTreeModel::timerEvent(QTimerEvent *ev)
\fn bool QTreeWidgetItem::isHidden() const
\since 4.2
- Returns true if the item is hidden, otherwise returns false.
+ Returns \c true if the item is hidden, otherwise returns \c false.
\sa setHidden()
*/
@@ -1038,7 +1038,7 @@ void QTreeModel::timerEvent(QTimerEvent *ev)
\fn bool QTreeWidgetItem::isExpanded() const
\since 4.2
- Returns true if the item is expanded, otherwise returns false.
+ Returns \c true if the item is expanded, otherwise returns \c false.
\sa setExpanded()
*/
@@ -1057,7 +1057,7 @@ void QTreeModel::timerEvent(QTimerEvent *ev)
\fn bool QTreeWidgetItem::isFirstColumnSpanned() const
\since 4.3
- Returns true if the item is spanning all the columns in a row; otherwise returns false.
+ Returns \c true if the item is spanning all the columns in a row; otherwise returns \c false.
\sa setFirstColumnSpanned()
*/
@@ -1800,8 +1800,8 @@ QVariant QTreeWidgetItem::data(int column, int role) const
}
/*!
- Returns true if the text in the item is less than the text in the
- \a other item, otherwise returns false.
+ Returns \c true if the text in the item is less than the text in the
+ \a other item, otherwise returns \c false.
*/
bool QTreeWidgetItem::operator<(const QTreeWidgetItem &other) const
@@ -2979,7 +2979,7 @@ void QTreeWidget::setItemWidget(QTreeWidgetItem *item, int column, QWidget *widg
}
/*!
- Returns true if the \a item is selected; otherwise returns false.
+ Returns \c true if the \a item is selected; otherwise returns \c false.
\sa itemSelectionChanged()
@@ -3055,7 +3055,7 @@ QList<QTreeWidgetItem*> QTreeWidget::findItems(const QString &text, Qt::MatchFla
}
/*!
- Returns true if the \a item is explicitly hidden, otherwise returns false.
+ Returns \c true if the \a item is explicitly hidden, otherwise returns \c false.
\obsolete
@@ -3093,7 +3093,7 @@ void QTreeWidget::setItemHidden(const QTreeWidgetItem *item, bool hide)
}
/*!
- Returns true if the given \a item is open; otherwise returns false.
+ Returns \c true if the given \a item is open; otherwise returns \c false.
\sa itemExpanded()
@@ -3128,8 +3128,8 @@ void QTreeWidget::setItemExpanded(const QTreeWidgetItem *item, bool expand)
/*!
\since 4.3
- Returns true if the given \a item is set to show only one section over all columns;
- otherwise returns false.
+ Returns \c true if the given \a item is set to show only one section over all columns;
+ otherwise returns \c false.
\sa setFirstItemColumnSpanned()
*/
@@ -3294,9 +3294,9 @@ QMimeData *QTreeWidget::mimeData(const QList<QTreeWidgetItem*> items) const
Handles the \a data supplied by a drag and drop operation that ended with
the given \a action in the \a index in the given \a parent item.
- The default implementation returns true if the drop was
+ The default implementation returns \c true if the drop was
successfully handled by decoding the mime data and inserting it
- into the model; otherwise it returns false.
+ into the model; otherwise it returns \c false.
\sa supportedDropActions()
*/