diff options
author | Casper van Donderen <casper.vandonderen@nokia.com> | 2012-03-01 15:28:31 +0100 |
---|---|---|
committer | Qt by Nokia <qt-info@nokia.com> | 2012-03-02 23:16:25 +0100 |
commit | 95d83cb1b68cc4a415d5d80859b4e74472ad7112 (patch) | |
tree | 9f6fa892ee78f584224320a195f03419c0fdbc21 /doc/src/widgets/modelview.qdoc | |
parent | 15e136d4e116c1513c106dfbb75e1953a7f3463c (diff) |
Remove the usage of deprecated qdoc macros.
QDoc now has support for Doxygen style commands for italics, bold
and list items. This change applies that change in QDoc to the
actual documentation.
Task-number: QTBUG-24578
Change-Id: I519bf9c29b14092e3ab6067612f42bf749eeedf5
Reviewed-by: Shane Kearns <shane.kearns@accenture.com>
Reviewed-by: Lars Knoll <lars.knoll@nokia.com>
Diffstat (limited to 'doc/src/widgets/modelview.qdoc')
-rw-r--r-- | doc/src/widgets/modelview.qdoc | 580 |
1 files changed, 290 insertions, 290 deletions
diff --git a/doc/src/widgets/modelview.qdoc b/doc/src/widgets/modelview.qdoc index 536b521100..fdd25def31 100644 --- a/doc/src/widgets/modelview.qdoc +++ b/doc/src/widgets/modelview.qdoc @@ -55,16 +55,16 @@ such as: \list - \o The difference between standard and model/view widgets - \o Adapters between forms and models - \o Developing a simple model/view application - \o Predefined models - \o Intermediate topics such as: + \li The difference between standard and model/view widgets + \li Adapters between forms and models + \li Developing a simple model/view application + \li Predefined models + \li Intermediate topics such as: \list - \o Tree views - \o Selection - \o Delegates - \o Debugging with model test + \li Tree views + \li Selection + \li Delegates + \li Debugging with model test \endlist \endlist @@ -91,11 +91,11 @@ \table \row - \o Standard widgets use data that is part of the widget. - \o \image standardwidget.png + \li Standard widgets use data that is part of the widget. + \li \image standardwidget.png \row - \o View classes operate on external data (the model) - \o \image modelview.png + \li View classes operate on external data (the model) + \li \image modelview.png \endtable \section2 1.1 Standard Widgets @@ -133,30 +133,30 @@ \table \header - \o Widget - \o Standard Widget\br + \li Widget + \li Standard Widget\br (an item based convenience class) - \o Model/View View Class\br + \li Model/View View Class\br (for use with external data) \row - \o \inlineimage listview.png - \o \l QListWidget - \o \l QListView + \li \inlineimage listview.png + \li \l QListWidget + \li \l QListView \row - \o \inlineimage tableview.png - \o \l QTableWidget - \o \l QTableView + \li \inlineimage tableview.png + \li \l QTableWidget + \li \l QTableView \row - \o \inlineimage treeview.png - \o \l QTreeWidget - \o \l QTreeView + \li \inlineimage treeview.png + \li \l QTreeWidget + \li \l QTreeView \row - \o \inlineimage columnview.png - \o - \o \l QColumnView shows a tree as a hierarchy of lists + \li \inlineimage columnview.png + \li + \li \l QColumnView shows a tree as a hierarchy of lists \row - \o \inlineimage modelview-combobox.png - \o {2, 1} \l QComboBox can work as both a view class and also + \li \inlineimage modelview-combobox.png + \li {2, 1} \l QComboBox can work as both a view class and also as a traditional widget \endtable @@ -212,8 +212,8 @@ things: \list - \o How many rows and columns should be displayed. - \o What content should be printed into each cell. + \li How many rows and columns should be displayed. + \li What content should be printed into each cell. \endlist The model needs some code to respond to this. @@ -271,33 +271,33 @@ \table \header - \o \l{Qt::ItemDataRole}{enum Qt::ItemDataRole} - \o Meaning - \o Type + \li \l{Qt::ItemDataRole}{enum Qt::ItemDataRole} + \li Meaning + \li Type \row - \o \l{Qt::ItemDataRole}{}Qt::DisplayRole - \o text - \o QString + \li \l{Qt::ItemDataRole}{}Qt::DisplayRole + \li text + \li QString \row - \o \l{Qt::ItemDataRole}{Qt::FontRole} - \o font - \o QFont + \li \l{Qt::ItemDataRole}{Qt::FontRole} + \li font + \li QFont \row - \o \l{Qt::ItemDataRole}{BackgroundRole} - \o brush for the background of the cell - \o QBrush + \li \l{Qt::ItemDataRole}{BackgroundRole} + \li brush for the background of the cell + \li QBrush \row - \o \l{Qt::ItemDataRole}{Qt::TextAlignmentRole} - \o text alignment - \o \l{Qt::AlignmentFlag}{enum Qt::AlignmentFlag} + \li \l{Qt::ItemDataRole}{Qt::TextAlignmentRole} + \li text alignment + \li \l{Qt::AlignmentFlag}{enum Qt::AlignmentFlag} \row - \o {1, 3} \l{Qt::ItemDataRole}{Qt::CheckStateRole} - \o {1, 3} suppresses checkboxes with \l{QVariant}{QVariant()}, + \li {1, 3} \l{Qt::ItemDataRole}{Qt::CheckStateRole} + \li {1, 3} suppresses checkboxes with \l{QVariant}{QVariant()}, sets checkboxes with \l{Qt::CheckState}{Qt::Checked} or \l{Qt::CheckState}{Qt::Unchecked} - \o {1, 3} \l{Qt::ItemDataRole}{enum Qt::ItemDataRole} + \li {1, 3} \l{Qt::ItemDataRole}{enum Qt::ItemDataRole} \endtable Refer to the Qt namespace documentation to learn more about the @@ -490,27 +490,27 @@ \table \row - \o QStringListModel - \o Stores a list of strings + \li QStringListModel + \li Stores a list of strings \row - \o QStandardItemModel - \o Stores arbitrary hierarchical items + \li QStandardItemModel + \li Stores arbitrary hierarchical items \row - \o QFileSystemModel\br + \li QFileSystemModel\br QDirModel - \o Encapsulate the local file system + \li Encapsulate the local file system \row - \o QSqlQueryModel - \o Encapsulate an SQL result set + \li QSqlQueryModel + \li Encapsulate an SQL result set \row - \o QSqlTableModel - \o Encapsulates an SQL table + \li QSqlTableModel + \li Encapsulates an SQL table \row - \o QSqlRelationalTableModel - \o Encapsulates an SQL table with foreign keys + \li QSqlRelationalTableModel + \li Encapsulates an SQL table with foreign keys \row - \o QSortFilterProxyModel - \o Sorts and/or filters another model + \li QSortFilterProxyModel + \li Sorts and/or filters another model \endtable @@ -562,11 +562,11 @@ Other references to delegates in Qt Documentation: \list - \o \l{Spin Box Delegate Example} - \o \l{QAbstractItemDelegate}{QAbstractItemDelegate Class Reference} - \o \l{QSqlRelationalDelegate}{QSqlRelationalDelegate Class Reference} - \o \l{QStyledItemDelegate}{QStyledItemDelegate Class Reference} - \o \l{QItemDelegate}{QItemDelegate Class Reference} + \li \l{Spin Box Delegate Example} + \li \l{QAbstractItemDelegate}{QAbstractItemDelegate Class Reference} + \li \l{QSqlRelationalDelegate}{QSqlRelationalDelegate Class Reference} + \li \l{QStyledItemDelegate}{QStyledItemDelegate Class Reference} + \li \l{QItemDelegate}{QItemDelegate Class Reference} \endlist @@ -599,16 +599,16 @@ Qt but also in several good books. \list 1 - \o \bold{C++ GUI Programming with Qt 4} / Jasmin Blanchette, Mark Summerfield, + \li \b{C++ GUI Programming with Qt 4} / Jasmin Blanchette, Mark Summerfield, \e{Prentice Hall, 2nd edition}, ISBN 0-13-235416-0. Also available in - German: \bold{C++ GUI Programmierung mit Qt 4: Die offizielle Einführung}, + German: \b{C++ GUI Programmierung mit Qt 4: Die offizielle Einführung}, \e{Addison-Wesley}, ISBN 3-827327-29-6 - \o \bold{The Book of Qt4, The Art of Building Qt Applications} / Daniel Molkentin, + \li \b{The Book of Qt4, The Art of Building Qt Applications} / Daniel Molkentin, \e{Open Source Press}, ISBN 1-59327-147-6. - Translated from \bold{Qt 4, Einführung in die Applikationsentwicklung}, + Translated from \b{Qt 4, Einführung in die Applikationsentwicklung}, \e{Open Source Press}, ISBN 3-937514-12-0. - \o \bold{Foundations of Qt Development} / Johan Thelin, \e{Apress}, ISBN 1-59059-831-8. - \o \bold{Advanced Qt Programming} / Mark Summerfield, \e{Prentice Hall}, ISBN 0-321-63590-6. + \li \b{Foundations of Qt Development} / Johan Thelin, \e{Apress}, ISBN 1-59059-831-8. + \li \b{Advanced Qt Programming} / Mark Summerfield, \e{Prentice Hall}, ISBN 0-321-63590-6. This book covers Model/View programming on more than 150 pages. \endlist @@ -621,157 +621,157 @@ \table \header - \o Example name - \o View class used - \o Model used - \o Aspects covered - \o - \row - \o Team Leaders - \o QListview - \o QStringListModel - \o - \o Book 1, Chapter 10, Figure 10.6 - \row - \o Directory Viewer - \o QTreeView - \o QDirModel - \o - \o Book 1, Chapter 10, Figure 10.7 - \row - \o Color Names - \o QListView - \o QSortFilterProxyModel + \li Example name + \li View class used + \li Model used + \li Aspects covered + \li + \row + \li Team Leaders + \li QListview + \li QStringListModel + \li + \li Book 1, Chapter 10, Figure 10.6 + \row + \li Directory Viewer + \li QTreeView + \li QDirModel + \li + \li Book 1, Chapter 10, Figure 10.7 + \row + \li Color Names + \li QListView + \li QSortFilterProxyModel applied to QStringListModel - \o - \o Book 1, Chapter 10, Figure 10.8 + \li + \li Book 1, Chapter 10, Figure 10.8 \row - \o Currencies - \o QTableView - \o custom model based on + \li Currencies + \li QTableView + \li custom model based on QAbstractTableModel - \o Read only - \o Book 1, Chapter 10, Figure 10.10 + \li Read only + \li Book 1, Chapter 10, Figure 10.10 \row - \o Cities - \o QTableView - \o Custom model based on + \li Cities + \li QTableView + \li Custom model based on QAbstractTableModel - \o Read / write - \o Book 1, Chapter 10, Figure 10.12 + \li Read / write + \li Book 1, Chapter 10, Figure 10.12 \row - \o Boolean Parser - \o QTreeView - \o Custom model based on + \li Boolean Parser + \li QTreeView + \li Custom model based on QAbstractItemModel - \o Read only - \o Book 1, Chapter 10, Figure 10.14 + \li Read only + \li Book 1, Chapter 10, Figure 10.14 \row - \o Track Editor - \o {2, 1} QTableWidget - \o Custom delegate providing a custom editor - \o Book 1, Chapter 10, Figure 10.15 + \li Track Editor + \li {2, 1} QTableWidget + \li Custom delegate providing a custom editor + \li Book 1, Chapter 10, Figure 10.15 \row - \o Four directory views - \o QListView + \li Four directory views + \li QListView QTableView QTreeView - \o QDirModel - \o Demonstrates the use of multiple views - \o Book2, Chapter 8.2 + \li QDirModel + \li Demonstrates the use of multiple views + \li Book2, Chapter 8.2 \row - \o Address Book - \o QListView + \li Address Book + \li QListView QTableView QTreeView - \o Custom model based on + \li Custom model based on QAbstractTableModel - \o Read / write - \o Book2, Chapter 8.4 + \li Read / write + \li Book2, Chapter 8.4 \row - \o Address Book with sorting - \o - \o QProxyModel - \o Introducing sort and filter capabilities - \o Book2, Chapter 8.5 + \li Address Book with sorting + \li + \li QProxyModel + \li Introducing sort and filter capabilities + \li Book2, Chapter 8.5 \row - \o Address Book + \li Address Book with checkboxes - \o - \o - \o Introducing checkboxes in model/view - \o Book2, Chapter 8.6 - \row - \o Address Book with transposed grid - \o - \o Custom proxy Model based on QAbstractProxyModel - \o Introducing a custom model - \o Book2, Chapter 8.7 - \row - \o Address Book with drag and drop - \o - \o - \o Introducing drag and drop support - \o Book2, Chapter 8.8 - \row - \o Address Book with custom editor - \o - \o - \o Introducing custom delegates - \o Book2, Chapter 8.9 - \row - \o Views - \o QListView + \li + \li + \li Introducing checkboxes in model/view + \li Book2, Chapter 8.6 + \row + \li Address Book with transposed grid + \li + \li Custom proxy Model based on QAbstractProxyModel + \li Introducing a custom model + \li Book2, Chapter 8.7 + \row + \li Address Book with drag and drop + \li + \li + \li Introducing drag and drop support + \li Book2, Chapter 8.8 + \row + \li Address Book with custom editor + \li + \li + \li Introducing custom delegates + \li Book2, Chapter 8.9 + \row + \li Views + \li QListView QTableView QTreeView - \o QStandardItemModel - \o Read only - \o Book 3, Chapter 5, figure 5-3 - \row - \o Bardelegate - \o QTableView - \o - \o Custom delegate for presentation based on QAbstractItemDelegate - \o Book 3, Chapter 5, figure 5-5 - \row - \o Editdelegate - \o QTableView - \o - \o Custom delegate for editing based on QAbstractItemDelegate - \o Book 3, Chapter 5, figure 5-6 - \row - \o Singleitemview - \o Custom view based on QAbstractItemView - \o - \o Custom view - \o Book 3, + \li QStandardItemModel + \li Read only + \li Book 3, Chapter 5, figure 5-3 + \row + \li Bardelegate + \li QTableView + \li + \li Custom delegate for presentation based on QAbstractItemDelegate + \li Book 3, Chapter 5, figure 5-5 + \row + \li Editdelegate + \li QTableView + \li + \li Custom delegate for editing based on QAbstractItemDelegate + \li Book 3, Chapter 5, figure 5-6 + \row + \li Singleitemview + \li Custom view based on QAbstractItemView + \li + \li Custom view + \li Book 3, Chapter 5, figure 5-7 \row - \o listmodel - \o QTableView - \o Custom Model based on QAbstractTableModel - \o Read only - \o Book 3, Chapter 5, Figure 5-8 - \row - \o treemodel - \o QTreeView - \o Custom Model based on QAbstractItemModel - \o Read only - \o Book 3, Chapter 5, Figure 5-10 - \row - \o edit integers - \o QListView - \o Custom Model based on QAbstractListModel - \o Read / write - \o Book 3, Chapter 5, Listing 5-37, Figure 5-11 - \row - \o sorting - \o QTableView - \o QSortFilterProxyModel applied to QStringListModel - \o Demonstrates sorting - \o Book 3, Chapter 5, Figure 5-12 + \li listmodel + \li QTableView + \li Custom Model based on QAbstractTableModel + \li Read only + \li Book 3, Chapter 5, Figure 5-8 + \row + \li treemodel + \li QTreeView + \li Custom Model based on QAbstractItemModel + \li Read only + \li Book 3, Chapter 5, Figure 5-10 + \row + \li edit integers + \li QListView + \li Custom Model based on QAbstractListModel + \li Read / write + \li Book 3, Chapter 5, Listing 5-37, Figure 5-11 + \row + \li sorting + \li QTableView + \li QSortFilterProxyModel applied to QStringListModel + \li Demonstrates sorting + \li Book 3, Chapter 5, Figure 5-12 \endtable @@ -782,108 +782,108 @@ \table \header - \o Example name - \o View class used - \o Model used - \o Aspects covered - \row - \o Address Book - \o QTableView - \o QAbstractTableModel + \li Example name + \li View class used + \li Model used + \li Aspects covered + \row + \li Address Book + \li QTableView + \li QAbstractTableModel QSortFilterProxyModel - \o Usage of QSortFilterProxyModel to generate different + \li Usage of QSortFilterProxyModel to generate different subsets from one data pool \row - \o Basic Sort/Filter Model - \o QTreeView - \o QStandardItemModel + \li Basic Sort/Filter Model + \li QTreeView + \li QStandardItemModel QSortFilterProxyModel - \o + \li \row - \o Chart - \o Custom view - \o QStandardItemModel - \o Designing custom views that cooperate with selection models + \li Chart + \li Custom view + \li QStandardItemModel + \li Designing custom views that cooperate with selection models \row - \o Color Editor Factory - \o {2, 1} QTableWidget - \o Enhancing the standard delegate with a new custom editor to choose colours + \li Color Editor Factory + \li {2, 1} QTableWidget + \li Enhancing the standard delegate with a new custom editor to choose colours \row - \o Combo Widget Mapper - \o QDataWidgetMapper to map QLineEdit, QTextEdit and QComboBox - \o QStandardItemModel - \o Shows how a QComboBox can serve as a view class + \li Combo Widget Mapper + \li QDataWidgetMapper to map QLineEdit, QTextEdit and QComboBox + \li QStandardItemModel + \li Shows how a QComboBox can serve as a view class \row - \o Custom Sort/Filter Model - \o QTreeView - \o QStandardItemModel + \li Custom Sort/Filter Model + \li QTreeView + \li QStandardItemModel QSortFilterProxyModel - \o Subclass QSortFilterProxyModel for advanced sorting and filtering + \li Subclass QSortFilterProxyModel for advanced sorting and filtering \row - \o Dir View - \o QTreeView - \o QDirModel - \o Very small example to demonstrate how to assign a model to a view + \li Dir View + \li QTreeView + \li QDirModel + \li Very small example to demonstrate how to assign a model to a view \row - \o Editable Tree Model - \o QTreeView - \o Custom tree model - \o Comprehensive example for working with trees, demonstrates + \li Editable Tree Model + \li QTreeView + \li Custom tree model + \li Comprehensive example for working with trees, demonstrates editing cells and tree structure with an underlying custom model \row - \o Fetch More - \o QListView - \o Custom list model - \o Dynamically changing model - \row - \o Frozen Column - \o QTableView - \o QStandardItemModel - \o - \row - \o Interview - \o Multiple - \o Custom item model - \o Multiple views - \row - \o Pixelator - \o QTableView - \o Custom table model - \o Implementation of a custom delegate - \row - \o Puzzle - \o QListView - \o Custom list model - \o Model/view with drag and drop - \row - \o Simple DOM Model - \o QTreeView - \o Custom tree model - \o Read only example for a custom tree model - \row - \o Simple Tree Model - \o QTreeView - \o Custom tree model - \o Read only example for a custom tree model - \row - \o Simple Widget Mapper - \o QDataWidgetMapper to map QLineEdit, QTextEdit and QSpinBox - \o QStandardItemModel - \o Basic QDataWidgetMapper usage - \row - \o Spin Box Delegate - \o QTableView - \o QStandardItemModel - \o Custom delegate that uses a spin box as a cell editor - \row - \o Spreadsheet - \o {2, 1} QTableView - \o Custom delegates - \row - \o Star Delegate - \o {2, 1} QTableWidget - \o Comprehensive custom delegate example. + \li Fetch More + \li QListView + \li Custom list model + \li Dynamically changing model + \row + \li Frozen Column + \li QTableView + \li QStandardItemModel + \li + \row + \li Interview + \li Multiple + \li Custom item model + \li Multiple views + \row + \li Pixelator + \li QTableView + \li Custom table model + \li Implementation of a custom delegate + \row + \li Puzzle + \li QListView + \li Custom list model + \li Model/view with drag and drop + \row + \li Simple DOM Model + \li QTreeView + \li Custom tree model + \li Read only example for a custom tree model + \row + \li Simple Tree Model + \li QTreeView + \li Custom tree model + \li Read only example for a custom tree model + \row + \li Simple Widget Mapper + \li QDataWidgetMapper to map QLineEdit, QTextEdit and QSpinBox + \li QStandardItemModel + \li Basic QDataWidgetMapper usage + \row + \li Spin Box Delegate + \li QTableView + \li QStandardItemModel + \li Custom delegate that uses a spin box as a cell editor + \row + \li Spreadsheet + \li {2, 1} QTableView + \li Custom delegates + \row + \li Star Delegate + \li {2, 1} QTableWidget + \li Comprehensive custom delegate example. \endtable A \l{Model/View Programming}{reference document} for model/view technology |