summaryrefslogtreecommitdiffstats
path: root/examples/widgets/doc/editabletreemodel.qdoc
diff options
context:
space:
mode:
authorFrederik Gladhorn <frederik.gladhorn@nokia.com>2012-09-05 16:53:23 +0200
committerQt by Nokia <qt-info@nokia.com>2012-09-11 12:09:47 +0200
commite92c1976a6bc1a73b45f182a72b75d1617f677ca (patch)
tree70c699843b769917c81911b88f0523952be88eb6 /examples/widgets/doc/editabletreemodel.qdoc
parentb5c0e0122ca427058f2faea4e196a95bf5457189 (diff)
Fix example includes for qdoc.
Change-Id: Ifa6a99db27ce51529489bf077a839a3107b524d2 Reviewed-by: Qt Doc Bot <qt_docbot@qt-project.org> Reviewed-by: Paul Olav Tvete <paul.tvete@nokia.com>
Diffstat (limited to 'examples/widgets/doc/editabletreemodel.qdoc')
-rw-r--r--examples/widgets/doc/editabletreemodel.qdoc56
1 files changed, 28 insertions, 28 deletions
diff --git a/examples/widgets/doc/editabletreemodel.qdoc b/examples/widgets/doc/editabletreemodel.qdoc
index d471eef352..24745b77b8 100644
--- a/examples/widgets/doc/editabletreemodel.qdoc
+++ b/examples/widgets/doc/editabletreemodel.qdoc
@@ -26,7 +26,7 @@
****************************************************************************/
/*!
- \example widgets/itemviews/editabletreemodel
+ \example itemviews/editabletreemodel
\title Editable Tree Model Example
This example shows how to implement a simple item-based tree model that can
@@ -67,7 +67,7 @@
\section1 Design
- As with the \l{widgets/itemviews/simpletreemodel}{Simple Tree Model} example,
+ As with the \l{itemviews/simpletreemodel}{Simple Tree Model} example,
the model simply acts as a wrapper around a collection
of instances of a \c TreeItem class. Each \c TreeItem is designed to
hold data for a row of items in a tree view, so it contains a list of
@@ -209,7 +209,7 @@
\li \inlineimage itemviews-editabletreemodel-indexes.png
\li \b{Relating items using model indexes}
- As with the \l{widgets/itemviews/simpletreemodel}{Simple Tree Model} example,
+ As with the \l{itemviews/simpletreemodel}{Simple Tree Model} example,
the \c TreeModel needs to be able to take a model index, find the
corresponding \c TreeItem, and return model indexes that correspond to
its parents and children.
@@ -234,7 +234,7 @@
pieces of data, and which can provide information about their parent
and child items:
- \snippet widgets/itemviews/editabletreemodel/treeitem.h 0
+ \snippet itemviews/editabletreemodel/treeitem.h 0
We have designed the API to be similar to that provided by
QAbstractItemModel by giving each item functions to return the number
@@ -251,7 +251,7 @@
Each \c TreeItem is constructed with a list of data and an optional
parent item:
- \snippet widgets/itemviews/editabletreemodel/treeitem.cpp 0
+ \snippet itemviews/editabletreemodel/treeitem.cpp 0
Initially, each item has no children. These are added to the item's
internal \c childItems member using the \c insertChildren() function
@@ -260,29 +260,29 @@
The destructor ensures that each child added to the item is deleted
when the item itself is deleted:
- \snippet widgets/itemviews/editabletreemodel/treeitem.cpp 1
+ \snippet itemviews/editabletreemodel/treeitem.cpp 1
\target TreeItem::parent
Since each item stores a pointer to its parent, the \c parent() function
is trivial:
- \snippet widgets/itemviews/editabletreemodel/treeitem.cpp 9
+ \snippet itemviews/editabletreemodel/treeitem.cpp 9
\target TreeItem::child
Three functions provide information about the children of an item.
\c child() returns a specific child from the internal list of children:
- \snippet widgets/itemviews/editabletreemodel/treeitem.cpp 2
+ \snippet itemviews/editabletreemodel/treeitem.cpp 2
The \c childCount() function returns the total number of children:
- \snippet widgets/itemviews/editabletreemodel/treeitem.cpp 3
+ \snippet itemviews/editabletreemodel/treeitem.cpp 3
The \c childNumber() function is used to determine the index of the child
in its parent's list of children. It accesses the parent's \c childItems
member directly to obtain this information:
- \snippet widgets/itemviews/editabletreemodel/treeitem.cpp 4
+ \snippet itemviews/editabletreemodel/treeitem.cpp 4
The root item has no parent item; for this item, we return zero to be
consistent with the other items.
@@ -290,20 +290,20 @@
The \c columnCount() function simply returns the number of elements in
the internal \c itemData list of QVariant objects:
- \snippet widgets/itemviews/editabletreemodel/treeitem.cpp 5
+ \snippet itemviews/editabletreemodel/treeitem.cpp 5
\target TreeItem::data
Data is retrieved using the \c data() function, which accesses the
appropriate element in the \c itemData list:
- \snippet widgets/itemviews/editabletreemodel/treeitem.cpp 6
+ \snippet itemviews/editabletreemodel/treeitem.cpp 6
\target TreeItem::setData
Data is set using the \c setData() function, which only stores values
in the \c itemData list for valid list indexes, corresponding to column
values in the model:
- \snippet widgets/itemviews/editabletreemodel/treeitem.cpp 11
+ \snippet itemviews/editabletreemodel/treeitem.cpp 11
To make implementation of the model easier, we return true to indicate
whether the data was set successfully, or false if an invalid column
@@ -313,20 +313,20 @@
in the model leads to the insertion of new child items in the corresponding
item, handled by the \c insertChildren() function:
- \snippet widgets/itemviews/editabletreemodel/treeitem.cpp 7
+ \snippet itemviews/editabletreemodel/treeitem.cpp 7
This ensures that new items are created with the required number of columns
and inserted at a valid position in the internal \c childItems list.
Items are removed with the \c removeChildren() function:
- \snippet widgets/itemviews/editabletreemodel/treeitem.cpp 10
+ \snippet itemviews/editabletreemodel/treeitem.cpp 10
As discussed above, the functions for inserting and removing columns are
used differently to those for inserting and removing child items because
they are expected to be called on every item in the tree. We do this by
recursively calling this function on each child of the item:
- \snippet widgets/itemviews/editabletreemodel/treeitem.cpp 8
+ \snippet itemviews/editabletreemodel/treeitem.cpp 8
\section1 TreeModel Class Definition
@@ -334,16 +334,16 @@
class, exposing the necessary interface for a model that can be edited and
resized.
- \snippet widgets/itemviews/editabletreemodel/treemodel.h 0
+ \snippet itemviews/editabletreemodel/treemodel.h 0
The constructor and destructor are specific to this model.
- \snippet widgets/itemviews/editabletreemodel/treemodel.h 1
+ \snippet itemviews/editabletreemodel/treemodel.h 1
Read-only tree models only need to provide the above functions. The
following public functions provide support for editing and resizing:
- \snippet widgets/itemviews/editabletreemodel/treemodel.h 2
+ \snippet itemviews/editabletreemodel/treemodel.h 2
To simplify this example, the data exposed by the model is organized into
a data structure by the model's \l{TreeModel::setupModelData}{setupModelData()}
@@ -355,7 +355,7 @@
The constructor creates a root item and initializes it with the header
data supplied:
- \snippet widgets/itemviews/editabletreemodel/treemodel.cpp 0
+ \snippet itemviews/editabletreemodel/treemodel.cpp 0
We call the internal \l{TreeModel::setupModelData}{setupModelData()}
function to convert the textual data supplied to a data structure we can
@@ -365,7 +365,7 @@
The destructor only has to delete the root item; all child items will
be recursively deleted by the \c TreeItem destructor.
- \snippet widgets/itemviews/editabletreemodel/treemodel.cpp 1
+ \snippet itemviews/editabletreemodel/treemodel.cpp 1
\target TreeModel::getItem
Since the model's interface to the other model/view components is based
@@ -375,7 +375,7 @@
consistency, we have defined a \c getItem() function to perform this
repetitive task:
- \snippet widgets/itemviews/editabletreemodel/treemodel.cpp 4
+ \snippet itemviews/editabletreemodel/treemodel.cpp 4
This function assumes that each model index it is passed corresponds to
a valid item in memory. If the index is invalid, or its internal pointer
@@ -385,13 +385,13 @@
\c getItem() function to obtain the relevant item, then returns the
number of children it contains:
- \snippet widgets/itemviews/editabletreemodel/treemodel.cpp 8
+ \snippet itemviews/editabletreemodel/treemodel.cpp 8
By contrast, the \c columnCount() implementation does not need to look
for a particular item because all items are defined to have the same
number of columns associated with them.
- \snippet widgets/itemviews/editabletreemodel/treemodel.cpp 2
+ \snippet itemviews/editabletreemodel/treemodel.cpp 2
As a result, the number of columns can be obtained directly from the root
item.
@@ -401,7 +401,7 @@
the Qt::ItemIsEditable and Qt::ItemIsSelectable flags as well as
Qt::ItemIsEnabled:
- \snippet widgets/itemviews/editabletreemodel/treemodel.cpp 3
+ \snippet itemviews/editabletreemodel/treemodel.cpp 3
\target TreeModel::index
The model needs to be able to generate model indexes to allow other
@@ -409,7 +409,7 @@
is performed by the \c index() function, which is used to obtain model
indexes corresponding to children of a given parent item:
- \snippet widgets/itemviews/editabletreemodel/treemodel.cpp 5
+ \snippet itemviews/editabletreemodel/treemodel.cpp 5
In this model, we only return model indexes for child items if the parent
index is invalid (corresponding to the root item) or if it has a zero
@@ -419,7 +419,7 @@
a \c TreeItem instance that corresponds to the model index supplied, and
request its child item that corresponds to the specified row.
- \snippet widgets/itemviews/editabletreemodel/treemodel.cpp 6
+ \snippet itemviews/editabletreemodel/treemodel.cpp 6
Since each item contains information for an entire row of data, we create
a model index to uniquely identify it by calling
@@ -436,7 +436,7 @@
then creating a model index to represent the parent. (See
\l{Relating-items-using-model-indexes}{the above diagram}).
- \snippet widgets/itemviews/editabletreemodel/treemodel.cpp 7
+ \snippet itemviews/editabletreemodel/treemodel.cpp 7
Items without parents, including the root item, are handled by returning
a null model index. Otherwise, a model index is created and returned as