diff options
Diffstat (limited to 'doc/src/widgets')
20 files changed, 1869 insertions, 1869 deletions
diff --git a/doc/src/widgets/addressbook-fr.qdoc b/doc/src/widgets/addressbook-fr.qdoc index 4df19d015f..edd53239d0 100644 --- a/doc/src/widgets/addressbook-fr.qdoc +++ b/doc/src/widgets/addressbook-fr.qdoc @@ -40,10 +40,10 @@ par Qt, tel que: \list - \o Les Widgets et leur mise en page à l'aide des layouts - \o Les signaux et slots - \o Les structures de données de collections - \o Les entrées/sorties + \li Les Widgets et leur mise en page à l'aide des layouts + \li Les signaux et slots + \li Les structures de données de collections + \li Les entrées/sorties \endlist Si c'est votre premier contact avec Qt, lisez \l{How to Learn Qt}{Comment apprendre Qt} @@ -54,13 +54,13 @@ Les chapitres du tutoriel: \list 1 - \o \l{tutorials/addressbook-fr/part1}{Conception de l'interface utilisateur} - \o \l{tutorials/addressbook-fr/part2}{Ajouter des adresses} - \o \l{tutorials/addressbook-fr/part3}{Navigation entre les éléments} - \o \l{tutorials/addressbook-fr/part4}{éditer et supprimer des adresses} - \o \l{tutorials/addressbook-fr/part5}{Ajout d'une fonction de recherche} - \o \l{tutorials/addressbook-fr/part6}{Sauvegarde et chargement} - \o \l{tutorials/addressbook-fr/part7}{Fonctionnalités avancées} + \li \l{tutorials/addressbook-fr/part1}{Conception de l'interface utilisateur} + \li \l{tutorials/addressbook-fr/part2}{Ajouter des adresses} + \li \l{tutorials/addressbook-fr/part3}{Navigation entre les éléments} + \li \l{tutorials/addressbook-fr/part4}{éditer et supprimer des adresses} + \li \l{tutorials/addressbook-fr/part5}{Ajout d'une fonction de recherche} + \li \l{tutorials/addressbook-fr/part6}{Sauvegarde et chargement} + \li \l{tutorials/addressbook-fr/part7}{Fonctionnalités avancées} \endlist La petite application que nous développerons ici ne possède pas tous les éléments @@ -99,10 +99,10 @@ Trois fichiers sont nécessaires à l'implémentation de ce carnet d'adresses: \list - \o \c{addressbook.h} - le fichier de définition (header) pour la classe \c AddressBook, - \o \c{addressbook.cpp} - le fichier source, qui comprend l'implémentation de la classe + \li \c{addressbook.h} - le fichier de définition (header) pour la classe \c AddressBook, + \li \c{addressbook.cpp} - le fichier source, qui comprend l'implémentation de la classe \c AddressBook - \o \c{main.cpp} - le fichier qui contient la méthode \c main() , et + \li \c{main.cpp} - le fichier qui contient la méthode \c main() , et une instance de la classe \c AddressBook. \endlist @@ -116,13 +116,13 @@ ou modifier le comportement d'un widget présente les avantages suivants: \list - \o La possibilité d'implémenter des méthodes virtuelles et des méthodes + \li La possibilité d'implémenter des méthodes virtuelles et des méthodes virtuelles pures pour obtenir exactement ce que l'on souhaite, avec la possibilité d'utiliser l'implémentation de la classe mère si besoin est. - \o Cela permet l'encapsulation partielle de l'interface utilisateur dans une classe, + \li Cela permet l'encapsulation partielle de l'interface utilisateur dans une classe, afin que les autres parties de l'application n'aient pas à se soucier de chacun des widgets qui forment l'interface utilisateur. - \o La classe fille peut être utilisée pour créer de nombreux widgets personnalisés + \li La classe fille peut être utilisée pour créer de nombreux widgets personnalisés dans une même application ou bibliothèque, et le code de la classe fille peut être réutilisé dans d'autres projets \endlist @@ -343,7 +343,7 @@ La méthode \c submitContact() peut être divisée en trois parties: \list 1 - \o Nous extrayons les détails du contact depuis \c nameLine et \c addressText + \li Nous extrayons les détails du contact depuis \c nameLine et \c addressText et les stockons dans des objets QString. Nous les validons pour s'assurer que l'utilisateur n'a pas cliqué sur "Add" avec des champs de saisie vides; sinon un message est affiché avec QMessageBox pour rappeller à @@ -351,7 +351,7 @@ \snippet tutorials/addressbook/part2/addressbook.cpp submitContact part1 - \o Ensuite, nous vérifions si le contact existe déjà. Si aucun contacts + \li Ensuite, nous vérifions si le contact existe déjà. Si aucun contacts existant n'entre en conflit avec le nouveau, nous l'ajoutons à \c contacts et nous affichons un QMessageBox pour informer l'utilisateur que le contact a été ajouté. @@ -363,7 +363,7 @@ Notre objet \c contacts est basé sur des paires clé-valeur formés par le nom et l'adresse, nous voulons nous assurer que la \e clé est unique. - \o Une fois que les deux vérifications précédentes ont été traitées, + \li Une fois que les deux vérifications précédentes ont été traitées, nous restaurons les boutons à leur état normal à l'aide du code suivant: @@ -482,8 +482,8 @@ sur \c contact dans la méthode \c next(), et ensuite: \list - \o Si l'itérateur n'est pas à la fin de \c contacts, nous l'incrémentons - \o Si l'itérateur est à la fin de \c contacts, nous changeons sa position + \li Si l'itérateur n'est pas à la fin de \c contacts, nous l'incrémentons + \li Si l'itérateur est à la fin de \c contacts, nous changeons sa position jusqu'au début de \c contacts. Cela donne l'illusion que notre QMap fonctionne comme une liste circulaire. \endlist @@ -497,11 +497,11 @@ itérateur sur \c contacts et ensuite: \list - \o Si l'itérateur est à la fin de \c contacts, on réinitialise + \li Si l'itérateur est à la fin de \c contacts, on réinitialise l'affichage et on retourne. - \o Si l'itérateur est au début de \c contacts, on change sa + \li Si l'itérateur est au début de \c contacts, on change sa position jusqu'à la fin - \o Ensuite, on décrémente l'itérateur + \li Ensuite, on décrémente l'itérateur \endlist \snippet tutorials/addressbook/part3/addressbook.cpp previous() function @@ -538,9 +538,9 @@ Dans ce chapitre, on définit l'énumération \c Mode avec trois valeurs possibles. \list - \o \c{NavigationMode}, - \o \c{AddingMode}, et - \o \c{EditingMode}. + \li \c{NavigationMode}, + \li \c{AddingMode}, et + \li \c{EditingMode}. \endlist \section1 Définition de la classe AddressBook diff --git a/doc/src/widgets/addressbook.qdoc b/doc/src/widgets/addressbook.qdoc index 96c96df177..27bdb0fac4 100644 --- a/doc/src/widgets/addressbook.qdoc +++ b/doc/src/widgets/addressbook.qdoc @@ -47,10 +47,10 @@ components of Qt, including: \list - \o Widgets and layout managers - \o Container classes - \o Signals and slots - \o Input and output devices + \li Widgets and layout managers + \li Container classes + \li Signals and slots + \li Input and output devices \endlist If you are new to Qt, we recommend reading \l{How to Learn Qt} first. @@ -58,13 +58,13 @@ Tutorial contents: \list 1 - \o \l{tutorials/addressbook/part1}{Designing the User Interface} - \o \l{tutorials/addressbook/part2}{Adding Addresses} - \o \l{tutorials/addressbook/part3}{Navigating between Entries} - \o \l{tutorials/addressbook/part4}{Editing and Removing Addresses} - \o \l{tutorials/addressbook/part5}{Adding a Find Function} - \o \l{tutorials/addressbook/part6}{Loading and Saving} - \o \l{tutorials/addressbook/part7}{Additional Features} + \li \l{tutorials/addressbook/part1}{Designing the User Interface} + \li \l{tutorials/addressbook/part2}{Adding Addresses} + \li \l{tutorials/addressbook/part3}{Navigating between Entries} + \li \l{tutorials/addressbook/part4}{Editing and Removing Addresses} + \li \l{tutorials/addressbook/part5}{Adding a Find Function} + \li \l{tutorials/addressbook/part6}{Loading and Saving} + \li \l{tutorials/addressbook/part7}{Additional Features} \endlist The tutorial source code is located in \c{examples/tutorials/addressbook}. @@ -105,11 +105,11 @@ There are three files used to implement this address book: \list - \o \c{addressbook.h} - the definition file for the \c AddressBook + \li \c{addressbook.h} - the definition file for the \c AddressBook class, - \o \c{addressbook.cpp} - the implementation file for the + \li \c{addressbook.cpp} - the implementation file for the \c AddressBook class, and - \o \c{main.cpp} - the file containing a \c main() function, with + \li \c{main.cpp} - the file containing a \c main() function, with an instance of \c AddressBook. \endlist @@ -121,13 +121,13 @@ extend or change the behavior of a widget has the following advantages: \list - \o We can write implementations of virtual or pure virtual functions to + \li We can write implementations of virtual or pure virtual functions to obtain exactly what we need, falling back on the base class's implementation when necessary. - \o It allows us to encapsulate parts of the user interface within a class, + \li It allows us to encapsulate parts of the user interface within a class, so that the other parts of the application don't need to know about the individual widgets in the user interface. - \o The subclass can be used to create multiple custom widgets in the same + \li The subclass can be used to create multiple custom widgets in the same application or library, and the code for the subclass can be reused in other projects. \endlist @@ -340,14 +340,14 @@ The \c submitContact() function can be divided into three parts: \list 1 - \o We extract the contact's details from \c nameLine and \c addressText + \li We extract the contact's details from \c nameLine and \c addressText and store them in QString objects. We also validate to make sure that the user did not click \gui Submit with empty input fields; otherwise, a QMessageBox is displayed to remind the user for a name and address. \snippet tutorials/addressbook/part2/addressbook.cpp submitContact part1 - \o We then proceed to check if the contact already exists. If it does not + \li We then proceed to check if the contact already exists. If it does not exist, we add the contact to \c contacts and we display a QMessageBox to inform the user that the contact has been added. @@ -358,7 +358,7 @@ Our \c contacts object is based on key-value pairs of name and address, hence, we want to ensure that \e key is unique. - \o Once we have handled both cases mentioned above, we restore the push + \li Once we have handled both cases mentioned above, we restore the push buttons to their normal state with the following code: \snippet tutorials/addressbook/part2/addressbook.cpp submitContact part3 @@ -471,9 +471,9 @@ for \c contacts and then: \list - \o If the iterator is not at the end of \c contacts, we increment it + \li If the iterator is not at the end of \c contacts, we increment it by one. - \o If the iterator is at the end of \c contacts, we move it to the + \li If the iterator is at the end of \c contacts, we move it to the beginning of \c contacts. This gives us the illusion that our QMap is working like a circularly-linked list. \endlist @@ -487,11 +487,11 @@ \c contacts and then: \list - \o If the iterator is at the end of \c contacts, we clear the + \li If the iterator is at the end of \c contacts, we clear the display and return. - \o If the iterator is at the beginning of \c contacts, we move it to + \li If the iterator is at the beginning of \c contacts, we move it to the end. - \o We then decrement the iterator by one. + \li We then decrement the iterator by one. \endlist \snippet tutorials/addressbook/part3/addressbook.cpp previous() function @@ -524,9 +524,9 @@ Here we define the \c Mode enum with three different values: \list - \o \c{NavigationMode}, - \o \c{AddingMode}, and - \o \c{EditingMode}. + \li \c{NavigationMode}, + \li \c{AddingMode}, and + \li \c{EditingMode}. \endlist \section1 Defining the AddressBook Class 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 diff --git a/doc/src/widgets/widgets-and-layouts/focus.qdoc b/doc/src/widgets/widgets-and-layouts/focus.qdoc index 374d5781ee..60f05948b4 100644 --- a/doc/src/widgets/widgets-and-layouts/focus.qdoc +++ b/doc/src/widgets/widgets-and-layouts/focus.qdoc @@ -51,11 +51,11 @@ \list 1 - \o The user presses \key Tab (or \key Shift+Tab). - \o The user clicks a widget. - \o The user presses a keyboard shortcut. - \o The user uses the mouse wheel. - \o The user moves the focus to a window, and the application must + \li The user presses \key Tab (or \key Shift+Tab). + \li The user clicks a widget. + \li The user presses a keyboard shortcut. + \li The user uses the mouse wheel. + \li The user moves the focus to a window, and the application must determine which widget within the window should get the focus. \endlist @@ -93,14 +93,14 @@ \list 1 - \o If the program can determine whether the field is needed, it can + \li If the program can determine whether the field is needed, it can move focus there when the user finishes entry and presses \gui OK, or when the user presses Enter after finishing the other fields. Alternately, include the field in the tab order but disable it. Enable it if it becomes appropriate in view of what the user has set in the other fields. - \o The label for the field can include a keyboard shortcut that moves + \li The label for the field can include a keyboard shortcut that moves focus to this field. \endlist diff --git a/doc/src/widgets/widgets-and-layouts/gallery-cde.qdoc b/doc/src/widgets/widgets-and-layouts/gallery-cde.qdoc index 313757ebec..a74cab0509 100644 --- a/doc/src/widgets/widgets-and-layouts/gallery-cde.qdoc +++ b/doc/src/widgets/widgets-and-layouts/gallery-cde.qdoc @@ -38,11 +38,11 @@ \table 100% \row -\o \image cde-checkbox.png +\li \image cde-checkbox.png \caption The QCheckBox widget provides a checkbox with a text label. -\o \image cde-radiobutton.png +\li \image cde-radiobutton.png \caption The QRadioButton widget provides a radio button with a text or pixmap label. -\o \image cde-pushbutton.png +\li \image cde-pushbutton.png \image cde-toolbutton.png \caption The QPushButton widget provides a command button. \endtable @@ -51,13 +51,13 @@ \table 100% \row -\o \image cde-groupbox.png +\li \image cde-groupbox.png The The QGroupBox widget provides a group box frame with a title. -\o \image cde-tabwidget.png +\li \image cde-tabwidget.png The QTabWidget class provides a stack of tabbed widgets. -\o \image cde-frame.png +\li \image cde-frame.png The QFrame widget provides a simple decorated container for other widgets. -\o \image cde-toolbox.png +\li \image cde-toolbox.png The QToolBox class provides a column of tabbed widget items. \endtable @@ -65,24 +65,24 @@ \table 100% \row -\o \image cde-listview.png +\li \image cde-listview.png The QListView class provides a default model/view implementation of a list/icon view. The QListWidget class provides a classic item-based list/icon view. -\o \image cde-treeview.png +\li \image cde-treeview.png The QTreeView class provides a default model/view implementation of a tree view. The QTreeWidget class provides a classic item-based tree view. -\o \image cde-tableview.png - The QTableView class provides a default model/view implementation of a table view. The QTableWidget class provides a classic item-based table view.\o -\o +\li \image cde-tableview.png + The QTableView class provides a default model/view implementation of a table view. The QTableWidget class provides a classic item-based table view.\li +\li \endtable \section2 Display Widgets \table 100% \row -\o \image cde-progressbar.png +\li \image cde-progressbar.png The QProgressBar widget provides a horizontal progress bar. -\o \image cde-label.png +\li \image cde-label.png The QLabel widget provides a text or image display. -\o \image cde-lcdnumber.png +\li \image cde-lcdnumber.png The QLCDNumber widget displays a number with LCD-like digits. \endtable @@ -90,43 +90,43 @@ \table 100% \row -\o \image cde-lineedit.png +\li \image cde-lineedit.png The QLineEdit widget is a one-line text editor. -\o \image cde-dateedit.png +\li \image cde-dateedit.png The QDateEdit class provides a widget for editing dates. -\o \image cde-timeedit.png +\li \image cde-timeedit.png The QTimeEdit class provides a widget for editing times. -\o \image cde-datetimeedit.png +\li \image cde-datetimeedit.png The QDateTimeEdit class provides a widget for editing dates and times. \endtable \table 100% \row -\o \image cde-slider.png +\li \image cde-slider.png The QSlider widget provides a vertical or horizontal slider. -\o \image cde-combobox.png +\li \image cde-combobox.png The QComboBox widget is a combined button and pop-up list. -\o \image cde-spinbox.png +\li \image cde-spinbox.png The QSpinBox class provides a spin box widget. \endtable \table 100% \row -\o \image cde-fontcombobox.png +\li \image cde-fontcombobox.png The QFontComboBox widget is a specialized combobox that enables fonts to be selected from a pop-up list containing previews of available fonts. -\o \image cde-doublespinbox.png +\li \image cde-doublespinbox.png The QDoubleSpinBox class provides a spin box widget that allows double precision floating point numbers to be entered. -\o \image cde-horizontalscrollbar.png +\li \image cde-horizontalscrollbar.png The QScrollBar widget provides a vertical or horizontal scroll bar. Here, we show a scroll bar with horizontal orientation. \endtable \table 100% \row -\o \image cde-dial.png +\li \image cde-dial.png The QDial class provides a rounded range control (like a speedometer or potentiometer). -\o \image cde-textedit.png +\li \image cde-textedit.png The QTextEdit class provides a widget that is used to edit and display both plain and rich text. -\o \image cde-calendarwidget.png +\li \image cde-calendarwidget.png The QCalendarWidget class provides a monthly calendar widget that can be used to select dates. \endtable diff --git a/doc/src/widgets/widgets-and-layouts/gallery-cleanlooks.qdoc b/doc/src/widgets/widgets-and-layouts/gallery-cleanlooks.qdoc index 74cd4d4d42..bed6d0ca40 100644 --- a/doc/src/widgets/widgets-and-layouts/gallery-cleanlooks.qdoc +++ b/doc/src/widgets/widgets-and-layouts/gallery-cleanlooks.qdoc @@ -38,18 +38,18 @@ \table 100% \row -\o \image cleanlooks-pushbutton.png +\li \image cleanlooks-pushbutton.png \caption The QPushButton widget provides a command button. -\o \image cleanlooks-toolbutton.png +\li \image cleanlooks-toolbutton.png \caption The QToolButton class provides a quick-access button to commands or options, usually used inside a QToolBar. \endtable \table 100% \row -\o \image cleanlooks-checkbox.png +\li \image cleanlooks-checkbox.png \caption The QCheckBox widget provides a checkbox with a text label. -\o \image cleanlooks-radiobutton.png +\li \image cleanlooks-radiobutton.png \caption The QRadioButton widget provides a radio button with a text or pixmap label. \endtable @@ -57,13 +57,13 @@ \table 100% \row -\o \image cleanlooks-groupbox.png +\li \image cleanlooks-groupbox.png The The QGroupBox widget provides a group box frame with a title. -\o \image cleanlooks-tabwidget.png +\li \image cleanlooks-tabwidget.png The QTabWidget class provides a stack of tabbed widgets. -\o \image cleanlooks-frame.png +\li \image cleanlooks-frame.png The QFrame widget provides a simple decorated container for other widgets. -\o \image cleanlooks-toolbox.png +\li \image cleanlooks-toolbox.png The QToolBox class provides a column of tabbed widget items. \endtable @@ -71,24 +71,24 @@ \table 100% \row -\o \image cleanlooks-listview.png +\li \image cleanlooks-listview.png The QListView class provides a default model/view implementation of a list/icon view. The QListWidget class provides a classic item-based list/icon view. -\o \image cleanlooks-treeview.png +\li \image cleanlooks-treeview.png The QTreeView class provides a default model/view implementation of a tree view. The QTreeWidget class provides a classic item-based tree view. -\o \image cleanlooks-tableview.png - The QTableView class provides a default model/view implementation of a table view. The QTableWidget class provides a classic item-based table view.\o -\o +\li \image cleanlooks-tableview.png + The QTableView class provides a default model/view implementation of a table view. The QTableWidget class provides a classic item-based table view.\li +\li \endtable \section2 Display Widgets \table 100% \row -\o \image cleanlooks-progressbar.png +\li \image cleanlooks-progressbar.png The QProgressBar widget provides a horizontal progress bar. -\o \image cleanlooks-label.png +\li \image cleanlooks-label.png The QLabel widget provides a text or image display. -\o \image cleanlooks-lcdnumber.png +\li \image cleanlooks-lcdnumber.png The QLCDNumber widget displays a number with LCD-like digits. \endtable @@ -96,43 +96,43 @@ \table 100% \row -\o \image cleanlooks-lineedit.png +\li \image cleanlooks-lineedit.png The QLineEdit widget is a one-line text editor. -\o \image cleanlooks-dateedit.png +\li \image cleanlooks-dateedit.png The QDateEdit class provides a widget for editing dates. -\o \image cleanlooks-timeedit.png +\li \image cleanlooks-timeedit.png The QTimeEdit class provides a widget for editing times. -\o \image cleanlooks-datetimeedit.png +\li \image cleanlooks-datetimeedit.png The QDateTimeEdit class provides a widget for editing dates and times. \endtable \table 100% \row -\o \image cleanlooks-slider.png +\li \image cleanlooks-slider.png The QSlider widget provides a vertical or horizontal slider. -\o \image cleanlooks-combobox.png +\li \image cleanlooks-combobox.png The QComboBox widget is a combined button and pop-up list. -\o \image cleanlooks-spinbox.png +\li \image cleanlooks-spinbox.png The QSpinBox class provides a spin box widget. \endtable \table 100% \row -\o \image cleanlooks-fontcombobox.png +\li \image cleanlooks-fontcombobox.png The QFontComboBox widget is a specialized combobox that enables fonts to be selected from a pop-up list containing previews of available fonts. -\o \image cleanlooks-doublespinbox.png +\li \image cleanlooks-doublespinbox.png The QDoubleSpinBox class provides a spin box widget that allows double precision floating point numbers to be entered. -\o \image cleanlooks-horizontalscrollbar.png +\li \image cleanlooks-horizontalscrollbar.png The QScrollBar widget provides a vertical or horizontal scroll bar. Here, we show a scroll bar with horizontal orientation. \endtable \table 100% \row -\o \image cleanlooks-dial.png +\li \image cleanlooks-dial.png The QDial class provides a rounded range control (like a speedometer or potentiometer). -\o \image cleanlooks-textedit.png +\li \image cleanlooks-textedit.png The QTextEdit class provides a widget that is used to edit and display both plain and rich text. -\o \image cleanlooks-calendarwidget.png +\li \image cleanlooks-calendarwidget.png The QCalendarWidget class provides a monthly calendar widget that can be used to select dates. \endtable */ diff --git a/doc/src/widgets/widgets-and-layouts/gallery-gtk.qdoc b/doc/src/widgets/widgets-and-layouts/gallery-gtk.qdoc index 6a7fb5f3b5..820f0b4140 100644 --- a/doc/src/widgets/widgets-and-layouts/gallery-gtk.qdoc +++ b/doc/src/widgets/widgets-and-layouts/gallery-gtk.qdoc @@ -41,18 +41,18 @@ \table 100% \row -\o \image gtk-pushbutton.png +\li \image gtk-pushbutton.png \caption The QPushButton widget provides a command button. -\o \image gtk-toolbutton.png +\li \image gtk-toolbutton.png \caption The QToolButton class provides a quick-access button to commands or options, usually used inside a QToolBar. \endtable \table 100% \row -\o \image gtk-checkbox.png +\li \image gtk-checkbox.png \caption The QCheckBox widget provides a checkbox with a text label. -\o \image gtk-radiobutton.png +\li \image gtk-radiobutton.png \caption The QRadioButton widget provides a radio button with a text or pixmap label. \endtable @@ -60,13 +60,13 @@ \table 100% \row -\o \image gtk-groupbox.png +\li \image gtk-groupbox.png The The QGroupBox widget provides a group box frame with a title. -\o \image gtk-tabwidget.png +\li \image gtk-tabwidget.png The QTabWidget class provides a stack of tabbed widgets. -\o \image gtk-frame.png +\li \image gtk-frame.png The QFrame widget provides a simple decorated container for other widgets. -\o \image gtk-toolbox.png +\li \image gtk-toolbox.png The QToolBox class provides a column of tabbed widget items. \endtable @@ -74,24 +74,24 @@ \table 100% \row -\o \image gtk-listview.png +\li \image gtk-listview.png The QListView class provides a default model/view implementation of a list/icon view. The QListWidget class provides a classic item-based list/icon view. -\o \image gtk-treeview.png +\li \image gtk-treeview.png The QTreeView class provides a default model/view implementation of a tree view. The QTreeWidget class provides a classic item-based tree view. -\o \image gtk-tableview.png - The QTableView class provides a default model/view implementation of a table view. The QTableWidget class provides a classic item-based table view.\o -\o +\li \image gtk-tableview.png + The QTableView class provides a default model/view implementation of a table view. The QTableWidget class provides a classic item-based table view.\li +\li \endtable \section2 Display Widgets \table 100% \row -\o \image gtk-progressbar.png +\li \image gtk-progressbar.png The QProgressBar widget provides a horizontal progress bar. -\o \image gtk-label.png +\li \image gtk-label.png The QLabel widget provides a text or image display. -\o \image gtk-lcdnumber.png +\li \image gtk-lcdnumber.png The QLCDNumber widget displays a number with LCD-like digits. \endtable @@ -99,43 +99,43 @@ \table 100% \row -\o \image gtk-lineedit.png +\li \image gtk-lineedit.png The QLineEdit widget is a one-line text editor. -\o \image gtk-dateedit.png +\li \image gtk-dateedit.png The QDateEdit class provides a widget for editing dates. -\o \image gtk-timeedit.png +\li \image gtk-timeedit.png The QTimeEdit class provides a widget for editing times. -\o \image gtk-datetimeedit.png +\li \image gtk-datetimeedit.png The QDateTimeEdit class provides a widget for editing dates and times. \endtable \table 100% \row -\o \image gtk-slider.png +\li \image gtk-slider.png The QSlider widget provides a vertical or horizontal slider. -\o \image gtk-combobox.png +\li \image gtk-combobox.png The QComboBox widget is a combined button and pop-up list. -\o \image gtk-spinbox.png +\li \image gtk-spinbox.png The QSpinBox class provides a spin box widget. \endtable \table 100% \row -\o \image gtk-fontcombobox.png +\li \image gtk-fontcombobox.png The QFontComboBox widget is a specialized combobox that enables fonts to be selected from a pop-up list containing previews of available fonts. -\o \image gtk-doublespinbox.png +\li \image gtk-doublespinbox.png The QDoubleSpinBox class provides a spin box widget that allows double precision floating point numbers to be entered. -\o \image gtk-horizontalscrollbar.png +\li \image gtk-horizontalscrollbar.png The QScrollBar widget provides a vertical or horizontal scroll bar. Here, we show a scroll bar with horizontal orientation. \endtable \table 100% \row -\o \image gtk-dial.png +\li \image gtk-dial.png The QDial class provides a rounded range control (like a speedometer or potentiometer). -\o \image gtk-textedit.png +\li \image gtk-textedit.png The QTextEdit class provides a widget that is used to edit and display both plain and rich text. -\o \image gtk-calendarwidget.png +\li \image gtk-calendarwidget.png The QCalendarWidget class provides a monthly calendar widget that can be used to select dates. \endtable */ diff --git a/doc/src/widgets/widgets-and-layouts/gallery-macintosh.qdoc b/doc/src/widgets/widgets-and-layouts/gallery-macintosh.qdoc index 6eceea114f..488a3f7665 100644 --- a/doc/src/widgets/widgets-and-layouts/gallery-macintosh.qdoc +++ b/doc/src/widgets/widgets-and-layouts/gallery-macintosh.qdoc @@ -38,18 +38,18 @@ \table 100% \row -\o \image macintosh-pushbutton.png +\li \image macintosh-pushbutton.png \caption The QPushButton widget provides a command button. -\o \image macintosh-toolbutton.png +\li \image macintosh-toolbutton.png \caption The QToolButton class provides a quick-access button to commands or options, usually used inside a QToolBar. \endtable \table 100% \row -\o \image macintosh-checkbox.png +\li \image macintosh-checkbox.png \caption The QCheckBox widget provides a checkbox with a text label. -\o \image macintosh-radiobutton.png +\li \image macintosh-radiobutton.png \caption The QRadioButton widget provides a radio button with a text or pixmap label. \endtable @@ -57,13 +57,13 @@ \table 100% \row -\o \image macintosh-groupbox.png +\li \image macintosh-groupbox.png The The QGroupBox widget provides a group box frame with a title. -\o \image macintosh-tabwidget.png +\li \image macintosh-tabwidget.png The QTabWidget class provides a stack of tabbed widgets. -\o \image macintosh-frame.png +\li \image macintosh-frame.png The QFrame widget provides a simple decorated container for other widgets. -\o \image macintosh-toolbox.png +\li \image macintosh-toolbox.png The QToolBox class provides a column of tabbed widget items. \endtable @@ -71,24 +71,24 @@ \table 100% \row -\o \image macintosh-listview.png +\li \image macintosh-listview.png The QListView class provides a default model/view implementation of a list/icon view. The QListWidget class provides a classic item-based list/icon view. -\o \image macintosh-treeview.png +\li \image macintosh-treeview.png The QTreeView class provides a default model/view implementation of a tree view. The QTreeWidget class provides a classic item-based tree view. -\o \image macintosh-tableview.png - The QTableView class provides a default model/view implementation of a table view. The QTableWidget class provides a classic item-based table view.\o -\o +\li \image macintosh-tableview.png + The QTableView class provides a default model/view implementation of a table view. The QTableWidget class provides a classic item-based table view.\li +\li \endtable \section2 Display Widgets \table 100% \row -\o \image macintosh-progressbar.png +\li \image macintosh-progressbar.png The QProgressBar widget provides a horizontal progress bar. -\o \image macintosh-label.png +\li \image macintosh-label.png The QLabel widget provides a text or image display. -\o \image macintosh-lcdnumber.png +\li \image macintosh-lcdnumber.png The QLCDNumber widget displays a number with LCD-like digits. \endtable @@ -96,43 +96,43 @@ \table 100% \row -\o \image macintosh-lineedit.png +\li \image macintosh-lineedit.png The QLineEdit widget is a one-line text editor. -\o \image macintosh-dateedit.png +\li \image macintosh-dateedit.png The QDateEdit class provides a widget for editing dates. -\o \image macintosh-timeedit.png +\li \image macintosh-timeedit.png The QTimeEdit class provides a widget for editing times. -\o \image macintosh-datetimeedit.png +\li \image macintosh-datetimeedit.png The QDateTimeEdit class provides a widget for editing dates and times. \endtable \table 100% \row -\o \image macintosh-slider.png +\li \image macintosh-slider.png The QSlider widget provides a vertical or horizontal slider. -\o \image macintosh-combobox.png +\li \image macintosh-combobox.png The QComboBox widget is a combined button and pop-up list. -\o \image macintosh-spinbox.png +\li \image macintosh-spinbox.png The QSpinBox class provides a spin box widget. \endtable \table 100% \row -\o \image macintosh-fontcombobox.png +\li \image macintosh-fontcombobox.png The QFontComboBox widget is a specialized combobox that enables fonts to be selected from a pop-up list containing previews of available fonts. -\o \image macintosh-doublespinbox.png +\li \image macintosh-doublespinbox.png The QDoubleSpinBox class provides a spin box widget that allows double precision floating point numbers to be entered. -\o \image macintosh-horizontalscrollbar.png +\li \image macintosh-horizontalscrollbar.png The QScrollBar widget provides a vertical or horizontal scroll bar. Here, we show a scroll bar with horizontal orientation. \endtable \table 100% \row -\o \image macintosh-dial.png +\li \image macintosh-dial.png The QDial class provides a rounded range control (like a speedometer or potentiometer). -\o \image macintosh-textedit.png +\li \image macintosh-textedit.png The QTextEdit class provides a widget that is used to edit and display both plain and rich text. -\o \image macintosh-calendarwidget.png +\li \image macintosh-calendarwidget.png The QCalendarWidget class provides a monthly calendar widget that can be used to select dates. \endtable */ diff --git a/doc/src/widgets/widgets-and-layouts/gallery-motif.qdoc b/doc/src/widgets/widgets-and-layouts/gallery-motif.qdoc index d059d2282f..5cbffc5516 100644 --- a/doc/src/widgets/widgets-and-layouts/gallery-motif.qdoc +++ b/doc/src/widgets/widgets-and-layouts/gallery-motif.qdoc @@ -38,18 +38,18 @@ \table 100% \row -\o \image motif-pushbutton.png +\li \image motif-pushbutton.png \caption The QPushButton widget provides a command button. -\o \image motif-toolbutton.png +\li \image motif-toolbutton.png \caption The QToolButton class provides a quick-access button to commands or options, usually used inside a QToolBar. \endtable \table 100% \row -\o \image motif-checkbox.png +\li \image motif-checkbox.png \caption The QCheckBox widget provides a checkbox with a text label. -\o \image motif-radiobutton.png +\li \image motif-radiobutton.png \caption The QRadioButton widget provides a radio button with a text or pixmap label. \endtable @@ -57,13 +57,13 @@ \table 100% \row -\o \image motif-groupbox.png +\li \image motif-groupbox.png The The QGroupBox widget provides a group box frame with a title. -\o \image motif-tabwidget.png +\li \image motif-tabwidget.png The QTabWidget class provides a stack of tabbed widgets. -\o \image motif-frame.png +\li \image motif-frame.png The QFrame widget provides a simple decorated container for other widgets. -\o \image motif-toolbox.png +\li \image motif-toolbox.png The QToolBox class provides a column of tabbed widget items. \endtable @@ -71,24 +71,24 @@ \table 100% \row -\o \image motif-listview.png +\li \image motif-listview.png The QListView class provides a default model/view implementation of a list/icon view. The QListWidget class provides a classic item-based list/icon view. -\o \image motif-treeview.png +\li \image motif-treeview.png The QTreeView class provides a default model/view implementation of a tree view. The QTreeWidget class provides a classic item-based tree view. -\o \image motif-tableview.png - The QTableView class provides a default model/view implementation of a table view. The QTableWidget class provides a classic item-based table view.\o -\o +\li \image motif-tableview.png + The QTableView class provides a default model/view implementation of a table view. The QTableWidget class provides a classic item-based table view.\li +\li \endtable \section2 Display Widgets \table 100% \row -\o \image motif-progressbar.png +\li \image motif-progressbar.png The QProgressBar widget provides a horizontal progress bar. -\o \image motif-label.png +\li \image motif-label.png The QLabel widget provides a text or image display. -\o \image motif-lcdnumber.png +\li \image motif-lcdnumber.png The QLCDNumber widget displays a number with LCD-like digits. \endtable @@ -96,43 +96,43 @@ \table 100% \row -\o \image motif-lineedit.png +\li \image motif-lineedit.png The QLineEdit widget is a one-line text editor. -\o \image motif-dateedit.png +\li \image motif-dateedit.png The QDateEdit class provides a widget for editing dates. -\o \image motif-timeedit.png +\li \image motif-timeedit.png The QTimeEdit class provides a widget for editing times. -\o \image motif-datetimeedit.png +\li \image motif-datetimeedit.png The QDateTimeEdit class provides a widget for editing dates and times. \endtable \table 100% \row -\o \image motif-slider.png +\li \image motif-slider.png The QSlider widget provides a vertical or horizontal slider. -\o \image motif-combobox.png +\li \image motif-combobox.png The QComboBox widget is a combined button and pop-up list. -\o \image motif-spinbox.png +\li \image motif-spinbox.png The QSpinBox class provides a spin box widget. \endtable \table 100% \row -\o \image motif-fontcombobox.png +\li \image motif-fontcombobox.png The QFontComboBox widget is a specialized combobox that enables fonts to be selected from a pop-up list containing previews of available fonts. -\o \image motif-doublespinbox.png +\li \image motif-doublespinbox.png The QDoubleSpinBox class provides a spin box widget that allows double precision floating point numbers to be entered. -\o \image motif-horizontalscrollbar.png +\li \image motif-horizontalscrollbar.png The QScrollBar widget provides a vertical or horizontal scroll bar. Here, we show a scroll bar with horizontal orientation. \endtable \table 100% \row -\o \image motif-dial.png +\li \image motif-dial.png The QDial class provides a rounded range control (like a speedometer or potentiometer). -\o \image motif-textedit.png +\li \image motif-textedit.png The QTextEdit class provides a widget that is used to edit and display both plain and rich text. -\o \image motif-calendarwidget.png +\li \image motif-calendarwidget.png The QCalendarWidget class provides a monthly calendar widget that can be used to select dates. \endtable */ diff --git a/doc/src/widgets/widgets-and-layouts/gallery-plastique.qdoc b/doc/src/widgets/widgets-and-layouts/gallery-plastique.qdoc index 9a57bd6cbc..359fac8018 100644 --- a/doc/src/widgets/widgets-and-layouts/gallery-plastique.qdoc +++ b/doc/src/widgets/widgets-and-layouts/gallery-plastique.qdoc @@ -38,18 +38,18 @@ \table 100% \row -\o \image plastique-pushbutton.png +\li \image plastique-pushbutton.png \caption The QPushButton widget provides a command button. -\o \image plastique-toolbutton.png +\li \image plastique-toolbutton.png \caption The QToolButton class provides a quick-access button to commands or options, usually used inside a QToolBar. \endtable \table 100% \row -\o \image plastique-checkbox.png +\li \image plastique-checkbox.png \caption The QCheckBox widget provides a checkbox with a text label. -\o \image plastique-radiobutton.png +\li \image plastique-radiobutton.png \caption The QRadioButton widget provides a radio button with a text or pixmap label. \endtable @@ -57,13 +57,13 @@ \table 100% \row -\o \image plastique-groupbox.png +\li \image plastique-groupbox.png The The QGroupBox widget provides a group box frame with a title. -\o \image plastique-tabwidget.png +\li \image plastique-tabwidget.png The QTabWidget class provides a stack of tabbed widgets. -\o \image plastique-frame.png +\li \image plastique-frame.png The QFrame widget provides a simple decorated container for other widgets. -\o \image plastique-toolbox.png +\li \image plastique-toolbox.png The QToolBox class provides a column of tabbed widget items. \endtable @@ -71,24 +71,24 @@ \table 100% \row -\o \image plastique-listview.png +\li \image plastique-listview.png The QListView class provides a default model/view implementation of a list/icon view. The QListWidget class provides a classic item-based list/icon view. -\o \image plastique-treeview.png +\li \image plastique-treeview.png The QTreeView class provides a default model/view implementation of a tree view. The QTreeWidget class provides a classic item-based tree view. -\o \image plastique-tableview.png - The QTableView class provides a default model/view implementation of a table view. The QTableWidget class provides a classic item-based table view.\o -\o +\li \image plastique-tableview.png + The QTableView class provides a default model/view implementation of a table view. The QTableWidget class provides a classic item-based table view.\li +\li \endtable \section2 Display Widgets \table 100% \row -\o \image plastique-progressbar.png +\li \image plastique-progressbar.png The QProgressBar widget provides a horizontal progress bar. -\o \image plastique-label.png +\li \image plastique-label.png The QLabel widget provides a text or image display. -\o \image plastique-lcdnumber.png +\li \image plastique-lcdnumber.png The QLCDNumber widget displays a number with LCD-like digits. \endtable @@ -96,43 +96,43 @@ \table 100% \row -\o \image plastique-lineedit.png +\li \image plastique-lineedit.png The QLineEdit widget is a one-line text editor. -\o \image plastique-dateedit.png +\li \image plastique-dateedit.png The QDateEdit class provides a widget for editing dates. -\o \image plastique-timeedit.png +\li \image plastique-timeedit.png The QTimeEdit class provides a widget for editing times. -\o \image plastique-datetimeedit.png +\li \image plastique-datetimeedit.png The QDateTimeEdit class provides a widget for editing dates and times. \endtable \table 100% \row -\o \image plastique-slider.png +\li \image plastique-slider.png The QSlider widget provides a vertical or horizontal slider. -\o \image plastique-combobox.png +\li \image plastique-combobox.png The QComboBox widget is a combined button and pop-up list. -\o \image plastique-spinbox.png +\li \image plastique-spinbox.png The QSpinBox class provides a spin box widget. \endtable \table 100% \row -\o \image plastique-fontcombobox.png +\li \image plastique-fontcombobox.png The QFontComboBox widget is a specialized combobox that enables fonts to be selected from a pop-up list containing previews of available fonts. -\o \image plastique-doublespinbox.png +\li \image plastique-doublespinbox.png The QDoubleSpinBox class provides a spin box widget that allows double precision floating point numbers to be entered. -\o \image plastique-horizontalscrollbar.png +\li \image plastique-horizontalscrollbar.png The QScrollBar widget provides a vertical or horizontal scroll bar. Here, we show a scroll bar with horizontal orientation. \endtable \table 100% \row -\o \image plastique-dial.png +\li \image plastique-dial.png The QDial class provides a rounded range control (like a speedometer or potentiometer). -\o \image plastique-textedit.png +\li \image plastique-textedit.png The QTextEdit class provides a widget that is used to edit and display both plain and rich text. -\o \image plastique-calendarwidget.png +\li \image plastique-calendarwidget.png The QCalendarWidget class provides a monthly calendar widget that can be used to select dates. \endtable */ diff --git a/doc/src/widgets/widgets-and-layouts/gallery-windows.qdoc b/doc/src/widgets/widgets-and-layouts/gallery-windows.qdoc index 83ebce97f5..b118c845c6 100644 --- a/doc/src/widgets/widgets-and-layouts/gallery-windows.qdoc +++ b/doc/src/widgets/widgets-and-layouts/gallery-windows.qdoc @@ -38,18 +38,18 @@ \table 100% \row -\o \image windows-pushbutton.png +\li \image windows-pushbutton.png \caption The QPushButton widget provides a command button. -\o \image windows-toolbutton.png +\li \image windows-toolbutton.png \caption The QToolButton class provides a quick-access button to commands or options, usually used inside a QToolBar. \endtable \table 100% \row -\o \image windows-checkbox.png +\li \image windows-checkbox.png \caption The QCheckBox widget provides a checkbox with a text label. -\o \image windows-radiobutton.png +\li \image windows-radiobutton.png \caption The QRadioButton widget provides a radio button with a text or pixmap label. \endtable @@ -57,13 +57,13 @@ \table 100% \row -\o \image windows-groupbox.png +\li \image windows-groupbox.png The The QGroupBox widget provides a group box frame with a title. -\o \image windows-tabwidget.png +\li \image windows-tabwidget.png The QTabWidget class provides a stack of tabbed widgets. -\o \image windows-frame.png +\li \image windows-frame.png The QFrame widget provides a simple decorated container for other widgets. -\o \image windows-toolbox.png +\li \image windows-toolbox.png The QToolBox class provides a column of tabbed widget items. \endtable @@ -71,24 +71,24 @@ \table 100% \row -\o \image windows-listview.png +\li \image windows-listview.png The QListView class provides a default model/view implementation of a list/icon view. The QListWidget class provides a classic item-based list/icon view. -\o \image windows-treeview.png +\li \image windows-treeview.png The QTreeView class provides a default model/view implementation of a tree view. The QTreeWidget class provides a classic item-based tree view. -\o \image windows-tableview.png - The QTableView class provides a default model/view implementation of a table view. The QTableWidget class provides a classic item-based table view.\o -\o +\li \image windows-tableview.png + The QTableView class provides a default model/view implementation of a table view. The QTableWidget class provides a classic item-based table view.\li +\li \endtable \section2 Display Widgets \table 100% \row -\o \image windows-progressbar.png +\li \image windows-progressbar.png The QProgressBar widget provides a horizontal progress bar. -\o \image windows-label.png +\li \image windows-label.png The QLabel widget provides a text or image display. -\o \image windows-lcdnumber.png +\li \image windows-lcdnumber.png The QLCDNumber widget displays a number with LCD-like digits. \endtable @@ -96,43 +96,43 @@ \table 100% \row -\o \image windows-lineedit.png +\li \image windows-lineedit.png The QLineEdit widget is a one-line text editor. -\o \image windows-dateedit.png +\li \image windows-dateedit.png The QDateEdit class provides a widget for editing dates. -\o \image windows-timeedit.png +\li \image windows-timeedit.png The QTimeEdit class provides a widget for editing times. -\o \image windows-datetimeedit.png +\li \image windows-datetimeedit.png The QDateTimeEdit class provides a widget for editing dates and times. \endtable \table 100% \row -\o \image windows-slider.png +\li \image windows-slider.png The QSlider widget provides a vertical or horizontal slider. -\o \image windows-combobox.png +\li \image windows-combobox.png The QComboBox widget is a combined button and pop-up list. -\o \image windows-spinbox.png +\li \image windows-spinbox.png The QSpinBox class provides a spin box widget. \endtable \table 100% \row -\o \image windows-fontcombobox.png +\li \image windows-fontcombobox.png The QFontComboBox widget is a specialized combobox that enables fonts to be selected from a pop-up list containing previews of available fonts. -\o \image windows-doublespinbox.png +\li \image windows-doublespinbox.png The QDoubleSpinBox class provides a spin box widget that allows double precision floating point numbers to be entered. -\o \image windows-horizontalscrollbar.png +\li \image windows-horizontalscrollbar.png The QScrollBar widget provides a vertical or horizontal scroll bar. Here, we show a scroll bar with horizontal orientation. \endtable \table 100% \row -\o \image windows-dial.png +\li \image windows-dial.png The QDial class provides a rounded range control (like a speedometer or potentiometer). -\o \image windows-textedit.png +\li \image windows-textedit.png The QTextEdit class provides a widget that is used to edit and display both plain and rich text. -\o \image windows-calendarwidget.png +\li \image windows-calendarwidget.png The QCalendarWidget class provides a monthly calendar widget that can be used to select dates. \endtable */ diff --git a/doc/src/widgets/widgets-and-layouts/gallery-windowsvista.qdoc b/doc/src/widgets/widgets-and-layouts/gallery-windowsvista.qdoc index e54a4dc399..db1a7cee90 100644 --- a/doc/src/widgets/widgets-and-layouts/gallery-windowsvista.qdoc +++ b/doc/src/widgets/widgets-and-layouts/gallery-windowsvista.qdoc @@ -38,18 +38,18 @@ \table 100% \row -\o \image windowsvista-pushbutton.png +\li \image windowsvista-pushbutton.png \caption The QPushButton widget provides a command button. -\o \image windowsvista-toolbutton.png +\li \image windowsvista-toolbutton.png \caption The QToolButton class provides a quick-access button to commands or options, usually used inside a QToolBar. \endtable \table 100% \row -\o \image windowsvista-checkbox.png +\li \image windowsvista-checkbox.png \caption The QCheckBox widget provides a checkbox with a text label. -\o \image windowsvista-radiobutton.png +\li \image windowsvista-radiobutton.png \caption The QRadioButton widget provides a radio button with a text or pixmap label. \endtable @@ -57,13 +57,13 @@ \table 100% \row -\o \image windowsvista-groupbox.png +\li \image windowsvista-groupbox.png The The QGroupBox widget provides a group box frame with a title. -\o \image windowsvista-tabwidget.png +\li \image windowsvista-tabwidget.png The QTabWidget class provides a stack of tabbed widgets. -\o \image windowsvista-frame.png +\li \image windowsvista-frame.png The QFrame widget provides a simple decorated container for other widgets. -\o \image windowsvista-toolbox.png +\li \image windowsvista-toolbox.png The QToolBox class provides a column of tabbed widget items. \endtable @@ -71,24 +71,24 @@ \table 100% \row -\o \image windowsvista-listview.png +\li \image windowsvista-listview.png The QListView class provides a default model/view implementation of a list/icon view. The QListWidget class provides a classic item-based list/icon view. -\o \image windowsvista-treeview.png +\li \image windowsvista-treeview.png The QTreeView class provides a default model/view implementation of a tree view. The QTreeWidget class provides a classic item-based tree view. -\o \image windowsvista-tableview.png - The QTableView class provides a default model/view implementation of a table view. The QTableWidget class provides a classic item-based table view.\o -\o +\li \image windowsvista-tableview.png + The QTableView class provides a default model/view implementation of a table view. The QTableWidget class provides a classic item-based table view.\li +\li \endtable \section2 Display Widgets \table 100% \row -\o \image windowsvista-progressbar.png +\li \image windowsvista-progressbar.png The QProgressBar widget provides a horizontal progress bar. -\o \image windowsvista-label.png +\li \image windowsvista-label.png The QLabel widget provides a text or image display. -\o \image windowsvista-lcdnumber.png +\li \image windowsvista-lcdnumber.png The QLCDNumber widget displays a number with LCD-like digits. \endtable @@ -96,43 +96,43 @@ \table 100% \row -\o \image windowsvista-lineedit.png +\li \image windowsvista-lineedit.png The QLineEdit widget is a one-line text editor. -\o \image windowsvista-dateedit.png +\li \image windowsvista-dateedit.png The QDateEdit class provides a widget for editing dates. -\o \image windowsvista-timeedit.png +\li \image windowsvista-timeedit.png The QTimeEdit class provides a widget for editing times. -\o \image windowsvista-datetimeedit.png +\li \image windowsvista-datetimeedit.png The QDateTimeEdit class provides a widget for editing dates and times. \endtable \table 100% \row -\o \image windowsvista-slider.png +\li \image windowsvista-slider.png The QSlider widget provides a vertical or horizontal slider. -\o \image windowsvista-combobox.png +\li \image windowsvista-combobox.png The QComboBox widget is a combined button and pop-up list. -\o \image windowsvista-spinbox.png +\li \image windowsvista-spinbox.png The QSpinBox class provides a spin box widget. \endtable \table 100% \row -\o \image windowsvista-fontcombobox.png +\li \image windowsvista-fontcombobox.png The QFontComboBox widget is a specialized combobox that enables fonts to be selected from a pop-up list containing previews of available fonts. -\o \image windowsvista-doublespinbox.png +\li \image windowsvista-doublespinbox.png The QDoubleSpinBox class provides a spin box widget that allows double precision floating point numbers to be entered. -\o \image windowsvista-horizontalscrollbar.png +\li \image windowsvista-horizontalscrollbar.png The QScrollBar widget provides a vertical or horizontal scroll bar. Here, we show a scroll bar with horizontal orientation. \endtable \table 100% \row -\o \image windowsvista-dial.png +\li \image windowsvista-dial.png The QDial class provides a rounded range control (like a speedometer or potentiometer). -\o \image windowsvista-textedit.png +\li \image windowsvista-textedit.png The QTextEdit class provides a widget that is used to edit and display both plain and rich text. -\o \image windowsvista-calendarwidget.png +\li \image windowsvista-calendarwidget.png The QCalendarWidget class provides a monthly calendar widget that can be used to select dates. \endtable */ diff --git a/doc/src/widgets/widgets-and-layouts/gallery-windowsxp.qdoc b/doc/src/widgets/widgets-and-layouts/gallery-windowsxp.qdoc index 3753402c5a..2ade5681e2 100644 --- a/doc/src/widgets/widgets-and-layouts/gallery-windowsxp.qdoc +++ b/doc/src/widgets/widgets-and-layouts/gallery-windowsxp.qdoc @@ -38,18 +38,18 @@ \table 100% \row -\o \image windowsxp-pushbutton.png +\li \image windowsxp-pushbutton.png \caption The QPushButton widget provides a command button. -\o \image windowsxp-toolbutton.png +\li \image windowsxp-toolbutton.png \caption The QToolButton class provides a quick-access button to commands or options, usually used inside a QToolBar. \endtable \table 100% \row -\o \image windowsxp-checkbox.png +\li \image windowsxp-checkbox.png \caption The QCheckBox widget provides a checkbox with a text label. -\o \image windowsxp-radiobutton.png +\li \image windowsxp-radiobutton.png \caption The QRadioButton widget provides a radio button with a text or pixmap label. \endtable @@ -57,13 +57,13 @@ \table 100% \row -\o \image windowsxp-groupbox.png +\li \image windowsxp-groupbox.png The The QGroupBox widget provides a group box frame with a title. -\o \image windowsxp-tabwidget.png +\li \image windowsxp-tabwidget.png The QTabWidget class provides a stack of tabbed widgets. -\o \image windowsxp-frame.png +\li \image windowsxp-frame.png The QFrame widget provides a simple decorated container for other widgets. -\o \image windowsxp-toolbox.png +\li \image windowsxp-toolbox.png The QToolBox class provides a column of tabbed widget items. \endtable @@ -71,24 +71,24 @@ \table 100% \row -\o \image windowsxp-listview.png +\li \image windowsxp-listview.png The QListView class provides a default model/view implementation of a list/icon view. The QListWidget class provides a classic item-based list/icon view. -\o \image windowsxp-treeview.png +\li \image windowsxp-treeview.png The QTreeView class provides a default model/view implementation of a tree view. The QTreeWidget class provides a classic item-based tree view. -\o \image windowsxp-tableview.png - The QTableView class provides a default model/view implementation of a table view. The QTableWidget class provides a classic item-based table view.\o -\o +\li \image windowsxp-tableview.png + The QTableView class provides a default model/view implementation of a table view. The QTableWidget class provides a classic item-based table view.\li +\li \endtable \section2 Display Widgets \table 100% \row -\o \image windowsxp-progressbar.png +\li \image windowsxp-progressbar.png The QProgressBar widget provides a horizontal progress bar. -\o \image windowsxp-label.png +\li \image windowsxp-label.png The QLabel widget provides a text or image display. -\o \image windowsxp-lcdnumber.png +\li \image windowsxp-lcdnumber.png The QLCDNumber widget displays a number with LCD-like digits. \endtable @@ -96,43 +96,43 @@ \table 100% \row -\o \image windowsxp-lineedit.png +\li \image windowsxp-lineedit.png The QLineEdit widget is a one-line text editor. -\o \image windowsxp-dateedit.png +\li \image windowsxp-dateedit.png The QDateEdit class provides a widget for editing dates. -\o \image windowsxp-timeedit.png +\li \image windowsxp-timeedit.png The QTimeEdit class provides a widget for editing times. -\o \image windowsxp-datetimeedit.png +\li \image windowsxp-datetimeedit.png The QDateTimeEdit class provides a widget for editing dates and times. \endtable \table 100% \row -\o \image windowsxp-slider.png +\li \image windowsxp-slider.png The QSlider widget provides a vertical or horizontal slider. -\o \image windowsxp-combobox.png +\li \image windowsxp-combobox.png The QComboBox widget is a combined button and pop-up list. -\o \image windowsxp-spinbox.png +\li \image windowsxp-spinbox.png The QSpinBox class provides a spin box widget. \endtable \table 100% \row -\o \image windowsxp-fontcombobox.png +\li \image windowsxp-fontcombobox.png The QFontComboBox widget is a specialized combobox that enables fonts to be selected from a pop-up list containing previews of available fonts. -\o \image windowsxp-doublespinbox.png +\li \image windowsxp-doublespinbox.png The QDoubleSpinBox class provides a spin box widget that allows double precision floating point numbers to be entered. -\o \image windowsxp-horizontalscrollbar.png +\li \image windowsxp-horizontalscrollbar.png The QScrollBar widget provides a vertical or horizontal scroll bar. Here, we show a scroll bar with horizontal orientation. \endtable \table 100% \row -\o \image windowsxp-dial.png +\li \image windowsxp-dial.png The QDial class provides a rounded range control (like a speedometer or potentiometer). -\o \image windowsxp-textedit.png +\li \image windowsxp-textedit.png The QTextEdit class provides a widget that is used to edit and display both plain and rich text. -\o \image windowsxp-calendarwidget.png +\li \image windowsxp-calendarwidget.png The QCalendarWidget class provides a monthly calendar widget that can be used to select dates. \endtable */ diff --git a/doc/src/widgets/widgets-and-layouts/gallery.qdoc b/doc/src/widgets/widgets-and-layouts/gallery.qdoc index d82eda4805..a2f4db5a7b 100644 --- a/doc/src/widgets/widgets-and-layouts/gallery.qdoc +++ b/doc/src/widgets/widgets-and-layouts/gallery.qdoc @@ -36,15 +36,15 @@ \table \row - \o \image plastique-tabwidget.png Plastique Style Widget Gallery + \li \image plastique-tabwidget.png Plastique Style Widget Gallery \caption \l{Plastique Style Widget Gallery} The Plastique style is provided by QPlastiqueStyle. - \o \image windowsxp-tabwidget.png Windows XP Style Widget Gallery + \li \image windowsxp-tabwidget.png Windows XP Style Widget Gallery \caption \l{Windows XP Style Widget Gallery} The Windows XP style is provided by QWindowsXPStyle. - \o \image windows-tabwidget.png Windows Style Widget Gallery + \li \image windows-tabwidget.png Windows Style Widget Gallery \caption \l{Windows Style Widget Gallery} The Windows style is provided by QWindowsStyle. @@ -52,15 +52,15 @@ \table \row - \o \image macintosh-tabwidget.png Macintosh Style Widget Gallery + \li \image macintosh-tabwidget.png Macintosh Style Widget Gallery \caption \l{Macintosh Style Widget Gallery} The Macintosh style is provided by QMacStyle. - \o \image cleanlooks-tabwidget.png Cleanlooks Style Widget Gallery + \li \image cleanlooks-tabwidget.png Cleanlooks Style Widget Gallery \caption \l{Cleanlooks Style Widget Gallery} The Cleanlooks style is provided by QCleanlooksStyle. - \o \image windowsvista-tabwidget.png Windows Vista Style Widget Gallery + \li \image windowsvista-tabwidget.png Windows Vista Style Widget Gallery \caption \l{Windows Vista Style Widget Gallery} The Windows Vista style is provided by QWindowsVistaStyle. @@ -68,15 +68,15 @@ \table \row - \o \image gtk-tabwidget.png GTK Style Widget Gallery + \li \image gtk-tabwidget.png GTK Style Widget Gallery \caption \l{GTK Style Widget Gallery} The GTK style is provided by QGtkStyle. - \o \image motif-tabwidget.png Motif Style Widget Gallery + \li \image motif-tabwidget.png Motif Style Widget Gallery \caption \l{Motif Style Widget Gallery} The Motif style is provided by QMotifStyle. - \o \image cde-tabwidget.png CDE Style Widget Gallery + \li \image cde-tabwidget.png CDE Style Widget Gallery \caption \l{CDE Style Widget Gallery} The Common Desktop Environment style is provided by QCDEStyle. diff --git a/doc/src/widgets/widgets-and-layouts/layout.qdoc b/doc/src/widgets/widgets-and-layouts/layout.qdoc index ccc15ef805..6e1a5f70e1 100644 --- a/doc/src/widgets/widgets-and-layouts/layout.qdoc +++ b/doc/src/widgets/widgets-and-layouts/layout.qdoc @@ -63,15 +63,15 @@ is set on a widget in this way, it takes charge of the following tasks: \list - \o Positioning of child widgets. - \o Sensible default sizes for windows. - \o Sensible minimum sizes for windows. - \o Resize handling. - \o Automatic updates when contents change: + \li Positioning of child widgets. + \li Sensible default sizes for windows. + \li Sensible minimum sizes for windows. + \li Resize handling. + \li Automatic updates when contents change: \list - \o Font size, text or other contents of child widgets. - \o Hiding or showing a child widget. - \o Removal of child widgets. + \li Font size, text or other contents of child widgets. + \li Hiding or showing a child widget. + \li Removal of child widgets. \endlist \endlist @@ -95,19 +95,19 @@ create more complex layouts, you can nest layout managers inside each other. \list - \o A QHBoxLayout lays out widgets in a horizontal row, from left to + \li A QHBoxLayout lays out widgets in a horizontal row, from left to right (or right to left for right-to-left languages). \image qhboxlayout-with-5-children.png - \o A QVBoxLayout lays out widgets in a vertical column, from top to + \li A QVBoxLayout lays out widgets in a vertical column, from top to bottom. \image qvboxlayout-with-5-children.png - \o A QGridLayout lays out widgets in a two-dimensional grid. Widgets + \li A QGridLayout lays out widgets in a two-dimensional grid. Widgets can occupy multiple cells. \image qgridlayout-with-5-children.png - \o A QFormLayout lays out widgets in a 2-column descriptive label- + \li A QFormLayout lays out widgets in a 2-column descriptive label- field style. \image qformlayout-with-6-children.png \endlist @@ -176,26 +176,26 @@ When you add widgets to a layout, the layout process works as follows: \list 1 - \o All the widgets will initially be allocated an amount of space in + \li All the widgets will initially be allocated an amount of space in accordance with their QWidget::sizePolicy() and QWidget::sizeHint(). - \o If any of the widgets have stretch factors set, with a value + \li If any of the widgets have stretch factors set, with a value greater than zero, then they are allocated space in proportion to their stretch factor (explained below). - \o If any of the widgets have stretch factors set to zero they will + \li If any of the widgets have stretch factors set to zero they will only get more space if no other widgets want the space. Of these, space is allocated to widgets with an \l{QSizePolicy::Expanding}{Expanding} size policy first. - \o Any widgets that are allocated less space than their minimum size + \li Any widgets that are allocated less space than their minimum size (or minimum size hint if no minimum size is specified) are allocated this minimum size they require. (Widgets don't have to have a minimum size or minimum size hint in which case the stretch factor is their determining factor.) - \o Any widgets that are allocated more space than their maximum size + \li Any widgets that are allocated more space than their maximum size are allocated the maximum size space they require. (Widgets do not have to have a maximum size in which case the stretch factor is their determining factor.) @@ -231,11 +231,11 @@ following mechanisms: \list - \o Reimplement QWidget::sizeHint() to return the preferred size of the + \li Reimplement QWidget::sizeHint() to return the preferred size of the widget. - \o Reimplement QWidget::minimumSizeHint() to return the smallest size + \li Reimplement QWidget::minimumSizeHint() to return the smallest size the widget can have. - \o Call QWidget::setSizePolicy() to specify the space requirements of + \li Call QWidget::setSizePolicy() to specify the space requirements of the widget. \endlist @@ -304,14 +304,14 @@ To write your own layout class, you must define the following: \list - \o A data structure to store the items handled by the layout. Each + \li A data structure to store the items handled by the layout. Each item is a \link QLayoutItem QLayoutItem\endlink. We will use a QList in this example. - \o \l{QLayout::}{addItem()}, how to add items to the layout. - \o \l{QLayout::}{setGeometry()}, how to perform the layout. - \o \l{QLayout::}{sizeHint()}, the preferred size of the layout. - \o \l{QLayout::}{itemAt()}, how to iterate over the layout. - \o \l{QLayout::}{takeAt()}, how to remove items from the layout. + \li \l{QLayout::}{addItem()}, how to add items to the layout. + \li \l{QLayout::}{setGeometry()}, how to perform the layout. + \li \l{QLayout::}{sizeHint()}, the preferred size of the layout. + \li \l{QLayout::}{itemAt()}, how to iterate over the layout. + \li \l{QLayout::}{takeAt()}, how to remove items from the layout. \endlist In most cases, you will also implement \l{QLayout::}{minimumSize()}. @@ -376,16 +376,16 @@ \section2 Further Notes \list - \o This custom layout does not handle height for width. - \o We ignore QLayoutItem::isEmpty(); this means that the layout will + \li This custom layout does not handle height for width. + \li We ignore QLayoutItem::isEmpty(); this means that the layout will treat hidden widgets as visible. - \o For complex layouts, speed can be greatly increased by caching + \li For complex layouts, speed can be greatly increased by caching calculated values. In that case, implement QLayoutItem::invalidate() to mark the cached data is dirty. - \o Calling QLayoutItem::sizeHint(), etc. may be expensive. So, you + \li Calling QLayoutItem::sizeHint(), etc. may be expensive. So, you should store the value in a local variable if you need it again later within in the same function. - \o You should not call QLayoutItem::setGeometry() twice on the same + \li You should not call QLayoutItem::setGeometry() twice on the same item in the same function. This call can be very expensive if the item has several child widgets, because the layout manager must do a complete layout every time. Instead, calculate the geometry and diff --git a/doc/src/widgets/widgets-and-layouts/styles.qdoc b/doc/src/widgets/widgets-and-layouts/styles.qdoc index febe1a8345..b9e3a30333 100644 --- a/doc/src/widgets/widgets-and-layouts/styles.qdoc +++ b/doc/src/widgets/widgets-and-layouts/styles.qdoc @@ -93,10 +93,10 @@ bar. Most draw functions now take four arguments: \list - \o an enum value specifying which graphical element to draw - \o a QStyleOption specifying how and where to render that element - \o a QPainter that should be used to draw the element - \o a QWidget on which the drawing is performed (optional) + \li an enum value specifying which graphical element to draw + \li a QStyleOption specifying how and where to render that element + \li a QPainter that should be used to draw the element + \li a QWidget on which the drawing is performed (optional) \endlist When a widget asks a style to draw an element, it provides the style @@ -309,11 +309,11 @@ following parameters: \list - \o the enum value of the element to draw - \o a QStyleOption which contains the information needed to + \li the enum value of the element to draw + \li a QStyleOption which contains the information needed to draw the element. - \o a QPainter with which to draw the element. - \o a pointer to a QWidget, typically the widget + \li a QPainter with which to draw the element. + \li a pointer to a QWidget, typically the widget that the element is painted on. \endlist @@ -337,27 +337,27 @@ typically takes the same arguments. \list - \o The \l{QStyle::}{subElementRect()} function takes a + \li The \l{QStyle::}{subElementRect()} function takes a \l{QStyle::}{SubElement} enum value, and calculates a bounding rectangle for a sub element. The style uses this function to know where to draw the different parts of an element. This is mainly done for reuse. If you create a new style, you can use the same location of sub elements as the super class. - \o The \l{QStyle::}{subControlRect()} function is used to + \li The \l{QStyle::}{subControlRect()} function is used to calculate bounding rectangles for sub controls in complex controls. When you implement a new style, you reimplement \c subControlRect() and calculate the rectangles that are different from the super class. - \o The \l{QStyle::}{pixelMetric()} function returns a pixel + \li The \l{QStyle::}{pixelMetric()} function returns a pixel metric, which is a style dependent size given in screen pixels. It takes a value of the \l{QStyle::}{PixelMetric} enum and returns the correct measure. Note that pixel metrics do not necessarily have to be static measures, but can be calculated with, for example, the style option. - \o The \l{QStyle::}{hitTestComplexControl()} function returns the + \li The \l{QStyle::}{hitTestComplexControl()} function returns the sub control that the mouse pointer is over in a complex control. Usually, this is simply a matter of using \l{QStyle::}{subControlRect()} to get the bounding rectangles of @@ -588,35 +588,35 @@ \table 90% \header - \o State flag - \o Set + \li State flag + \li Set \row - \o State_Sunken - \o Yes + \li State_Sunken + \li Yes \row - \o State_NoChange - \o No + \li State_NoChange + \li No \row - \o State_On - \o Yes + \li State_On + \li Yes \row - \o State_Off - \o No + \li State_Off + \li No \row - \o State_MouseOver - \o Yes + \li State_MouseOver + \li Yes \row - \o State_Enabled - \o Yes + \li State_Enabled + \li Yes \row - \o State_HasFocus - \o Yes + \li State_HasFocus + \li Yes \row - \o State_KeyboardFocusChange - \o No + \li State_KeyboardFocusChange + \li No \row - \o State_Active - \o Yes + \li State_Active + \li Yes \endtable The QCheckBox paints itself in QWidget::paintEvent() with @@ -714,16 +714,16 @@ The following is given for each widget: \list - \o A table with the members (variables, etc.) of its style option. - \o A table over the state flags (QStyle::StateFlag) that + \li A table with the members (variables, etc.) of its style option. + \li A table over the state flags (QStyle::StateFlag) that can be set on the widget and when the states are set. - \o Its element tree (see section \l{The Style Elements}). - \o An image of the widget in which the elements are outlined. + \li Its element tree (see section \l{The Style Elements}). + \li An image of the widget in which the elements are outlined. \omit This is not written yet - probably never will be either - \o List of style hints that should be checked for the + \li List of style hints that should be checked for the widget. - \o List of standard pixmaps that could be used by the + \li List of standard pixmaps that could be used by the elements. \endomit \endlist @@ -737,7 +737,7 @@ Our approach on styling center on the drawing of the widgets. The calculations of sub elements rectangles, sub controls, and pixel - metrics used \bold during drawing is only listed as contents in + metrics used \b during drawing is only listed as contents in the element trees. Note that there are rectangles and pixel metrics that are only used by widgets. This leaves these calculations untreated in the walkthrough. For instance, the @@ -778,53 +778,53 @@ \table 90% \header - \o State - \o State Set When + \li State + \li State Set When \row - \o State_Enabled - \o Set if the widget is not disabled (see + \li State_Enabled + \li Set if the widget is not disabled (see QWidget::setEnabled()) \row - \o State_Focus - \o Set if the widget has focus (see + \li State_Focus + \li Set if the widget has focus (see QWidget::hasFocus()) \row - \o State_KeyobordFocusChange - \o Set when the user changes focus with the keyboard + \li State_KeyobordFocusChange + \li Set when the user changes focus with the keyboard (see Qt::WA_KeyboardFocusChange) \row - \o State_MouseOver - \o Set if the mouse cursor is over the widget + \li State_MouseOver + \li Set if the mouse cursor is over the widget \row - \o State_Active - \o Set if the widget is a child of the active window. + \li State_Active + \li Set if the widget is a child of the active window. \row - \o State_HasEditFocus - \o Set if the widget has the edit focus + \li State_HasEditFocus + \li Set if the widget has the edit focus \endtable The other common members for widgets are: \table 90% \header - \o Member - \o Content + \li Member + \li Content \row - \o rect - \o The bounding rectangle of the element to draw. This + \li rect + \li The bounding rectangle of the element to draw. This is set to the widget bounding rectangle (QWidget::rect()). \row - \o direction - \o The layout direction; a value of the + \li direction + \li The layout direction; a value of the Qt::LayoutDirection enum. \row - \o palette - \o The QPalette to use when drawing the element. This + \li palette + \li The QPalette to use when drawing the element. This is set to the widgets palette (QWidget::palette()). \row - \o fontMetrics - \o The QFontMetrics to use when drawing text on the + \li fontMetrics + \li The QFontMetrics to use when drawing text on the widget. \endtable @@ -885,38 +885,38 @@ \table 90% \header - \o State - \o State Set When + \li State + \li State Set When \row - \o State_Sunken - \o Button is down or menu is pressed shown + \li State_Sunken + \li Button is down or menu is pressed shown \row - \o State_On - \o Button is checked + \li State_On + \li Button is checked \row - \o State_Raised - \o Button is not flat and not pressed down + \li State_Raised + \li Button is not flat and not pressed down \endtable Other members of QStyleOptionButton is: \table 90% \header - \o Member - \o Content + \li Member + \li Content \row - \o features - \o Flags of the QStyleOptionButton::ButtonFeatures enum, + \li features + \li Flags of the QStyleOptionButton::ButtonFeatures enum, which describes various button properties (see enum) \row - \o icon - \o The buttons QIcon (if any) + \li icon + \li The buttons QIcon (if any) \row - \o iconSize - \o The QSize of the icon + \li iconSize + \li The QSize of the icon \row - \o text - \o a QString with the buttons text + \li text + \li a QString with the buttons text \endtable \section3 Check and Radio Buttons @@ -933,21 +933,21 @@ \table 90% \header - \o State - \o State Set When + \li State + \li State Set When \row - \o State_sunken - \o The box is pressed down + \li State_sunken + \li The box is pressed down \row - \o State_NoChange - \o The box is partially checked (for tristate + \li State_NoChange + \li The box is partially checked (for tristate checkboxes.) \row - \o State_On - \o The box is checked + \li State_On + \li The box is checked \row - \o State_Off - \o The box is unchecked + \li State_Off + \li The box is unchecked \endtable See \l{Push Buttons} for a table over other members in the @@ -1017,17 +1017,17 @@ \table 90% \header - \o State - \o State Set When + \li State + \li State Set When \row - \o State_Sunken - \o The tab is pressed on with the mouse. + \li State_Sunken + \li The tab is pressed on with the mouse. \row - \o State_Selected - \o If it is the current tab. + \li State_Selected + \li If it is the current tab. \row - \o State_HasFocus - \o The tab bar has focus and the tab is selected + \li State_HasFocus + \li The tab bar has focus and the tab is selected \endtable Note that individual tabs may be disabled even if the tab bar @@ -1037,38 +1037,38 @@ \table 90% \header - \o Member - \o Content + \li Member + \li Content \row - \o cornerWidgets - \o Is flags of the CornerWidget enum, which indicate + \li cornerWidgets + \li Is flags of the CornerWidget enum, which indicate if and which corner widgets the tab bar has. \row - \o icon - \o The QIcon of the tab + \li icon + \li The QIcon of the tab \row - \o iconSize - \o The QSize of the icon + \li iconSize + \li The QSize of the icon \row - \o position - \o A TabPosition enum value that indicates the tabs + \li position + \li A TabPosition enum value that indicates the tabs position on the bar relative to the other tabs. \row - \o row - \o holds which row the tab is in + \li row + \li holds which row the tab is in \row - \o selectedPosition - \o A value of the SelectedPosition enum that indicates + \li selectedPosition + \li A value of the SelectedPosition enum that indicates whether the selected tab is adjacent to or is the tab. \row - \o shape - \o A value of the QTabBar::Shape enum indication + \li shape + \li A value of the QTabBar::Shape enum indication whether the tab has rounded or triangular corners and the orientation of the tab. \row - \o text - \o The tab text + \li text + \li The tab text \endtable The frame for tab widgets use QStyleOptionTabWidgetFrame as @@ -1077,26 +1077,26 @@ \table 90% \header - \o Member - \o content + \li Member + \li content \row - \o leftCornerWidgetSize - \o The QSize of the left corner widget (if any). + \li leftCornerWidgetSize + \li The QSize of the left corner widget (if any). \row - \o rightCornerWidgetSize - \o The QSize of the right corner widget (if any). + \li rightCornerWidgetSize + \li The QSize of the right corner widget (if any). \row - \o lineWidth - \o holds the line with for drawing the panel. + \li lineWidth + \li holds the line with for drawing the panel. \row - \o midLineWith - \o this value is currently always 0. + \li midLineWith + \li this value is currently always 0. \row - \o shape - \o The shape of the tabs on the tab bar. + \li shape + \li The shape of the tabs on the tab bar. \row - \o tabBarSize - \o The QSize of the tab bar. + \li tabBarSize + \li The QSize of the tab bar. \endtable \section3 Scroll Bars @@ -1130,11 +1130,11 @@ \table 90% \header - \o State - \o State Set When + \li State + \li State Set When \row - \o State_Horizontal - \o The scroll bar is horizontal + \li State_Horizontal + \li The scroll bar is horizontal \endtable The style option of QScrollBar is QStyleOptionSlider. Its @@ -1144,43 +1144,43 @@ \table 90% \header - \o Member - \o Content + \li Member + \li Content \row - \o maximum - \o the maximum value of the scroll bar + \li maximum + \li the maximum value of the scroll bar \row - \o minimum - \o the minimum value of the scroll bar + \li minimum + \li the minimum value of the scroll bar \row - \o notchTarget - \o the number of pixels between notches + \li notchTarget + \li the number of pixels between notches \row - \o orientation - \o a value of the Qt::Orientation enum that specifies + \li orientation + \li a value of the Qt::Orientation enum that specifies whether the scroll bar is vertical or horizontal \row - \o pageStep - \o the number to increase or decrease the sliders + \li pageStep + \li the number to increase or decrease the sliders value (relative to the size of the slider and its value range) on page steps. \row - \o singleStep - \o the number to increase or decrease the sliders + \li singleStep + \li the number to increase or decrease the sliders value on single (or line) steps \row - \o sliderValue - \o The value of the slider + \li sliderValue + \li The value of the slider \row - \o sliderPosition - \o the position of the slider handle. This is the same + \li sliderPosition + \li the position of the slider handle. This is the same as \c sliderValue if the scroll bar is QAbstractSlider::tracking. If not, the scroll bar does not update its value before the mouse releases the handle. \row - \o upsideDown - \o holds the direction in which the scroll bar + \li upsideDown + \li holds the direction in which the scroll bar increases its value. This is used instead of QStyleOption::direction for all abstract sliders. \endtable @@ -1207,42 +1207,42 @@ \table 90% \header - \o Member - \o Content + \li Member + \li Content \row - \o maximum - \o the maximum value of the slider + \li maximum + \li the maximum value of the slider \row - \o minimum - \o the minimum value of the slider + \li minimum + \li the minimum value of the slider \row - \o notchTarget - \o this is the number of pixels between each notch + \li notchTarget + \li this is the number of pixels between each notch \row - \o orientation - \o a Qt::Orientation enum value that gives whether the + \li orientation + \li a Qt::Orientation enum value that gives whether the slider is vertical or horizontal. \row - \o pageStep - \o a number in slider value to increase or decrease + \li pageStep + \li a number in slider value to increase or decrease for page steps \row - \o singleStep - \o the number to increase or decrease the sliders + \li singleStep + \li the number to increase or decrease the sliders value on single (or line) steps. \row - \o sliderValue - \o the value of the slider. + \li sliderValue + \li the value of the slider. \row - \o sliderPosition - \o the position of the slider given as a slider value. + \li sliderPosition + \li the position of the slider given as a slider value. This will be equal to the \c sliderValue if the slider is \l{QAbstractSlider::}{tracking}; if not, the sliders value will not change until the handle is released with the mouse. \row - \o upsideDown - \o this member is used instead of QStyleOption::direction + \li upsideDown + \li this member is used instead of QStyleOption::direction for all abstract sliders. \endtable @@ -1270,11 +1270,11 @@ \table 90% \header - \o State - \o State Set When + \li State + \li State Set When \row - \o State_Sunken - \o Is set if one of the sub controls CC_SpinUp or + \li State_Sunken + \li Is set if one of the sub controls CC_SpinUp or CC_SpinDown is pressed on with the mouse. \endtable @@ -1282,19 +1282,19 @@ \table 90% \header - \o Property - \o Function + \li Property + \li Function \row - \o frame - \o boolean that is true if the spin box is to draw a + \li frame + \li boolean that is true if the spin box is to draw a frame. \row - \o buttonSymbols - \o Value of the ButtonSymbols enum that decides the + \li buttonSymbols + \li Value of the ButtonSymbols enum that decides the symbol on the up/down buttons. \row - \o stepEnabled - \o A value of the StepEnabled indication which of the + \li stepEnabled + \li A value of the StepEnabled indication which of the spin box buttons are pressed down. \endtable @@ -1326,21 +1326,21 @@ \table 90% \header - \o Member - \o Content + \li Member + \li Content \row - \o icon - \o The title bars icon + \li icon + \li The title bars icon \row - \o text - \o the text for the title bar's label + \li text + \li the text for the title bar's label \row - \o windowFlags - \o flags of the Qt::WindowFlag enum. The window flags + \li windowFlags + \li flags of the Qt::WindowFlag enum. The window flags used by QMdiArea for window management. \row - \o titleBarState - \o this is the QWidget::windowState() of the window + \li titleBarState + \li this is the QWidget::windowState() of the window that contains the title bar. \endtable @@ -1374,44 +1374,44 @@ \table 90% \header - \o State - \o Set When + \li State + \li Set When \row - \o State_Selected - \o The box is not editable and has focus + \li State_Selected + \li The box is not editable and has focus \row - \o State_Sunken - \o SC_ComboBoxArrow is active + \li State_Sunken + \li SC_ComboBoxArrow is active \row - \o State_on - \o The container (list) of the box is visible + \li State_on + \li The container (list) of the box is visible \endtable The style options other members are: \table \header - \o Member - \o Content + \li Member + \li Content \row - \o currentIcon - \o the icon of the current (selected) item of the + \li currentIcon + \li the icon of the current (selected) item of the combo box. \row - \o currentText - \o the text of the current item in the box. + \li currentText + \li the text of the current item in the box. \row - \o editable - \o holds whether the combo box is editable or not + \li editable + \li holds whether the combo box is editable or not \row - \o frame - \o holds whether the combo box has a frame or not + \li frame + \li holds whether the combo box has a frame or not \row - \o iconSize - \o the size of the current items icon. + \li iconSize + \li the size of the current items icon. \row - \o popupRect - \o the bounding rectangle of the combo box's popup + \li popupRect + \li the bounding rectangle of the combo box's popup list. \endtable @@ -1438,42 +1438,42 @@ \table 90% \header - \o State - \o Set When + \li State + \li Set When \row - \o State_On - \o The check box is checked + \li State_On + \li The check box is checked \row - \o State_Sunken - \o The checkbox is pressed down + \li State_Sunken + \li The checkbox is pressed down \row - \o State_Off - \o The check box is unchecked (or there is no check box) + \li State_Off + \li The check box is unchecked (or there is no check box) \endtable The remaining members of QStyleOptionGroupBox are: \table \header - \o Member - \o Content + \li Member + \li Content \row - \o features - \o flags of the QStyleOptionFrameV2::FrameFeatures + \li features + \li flags of the QStyleOptionFrameV2::FrameFeatures enum describing the frame of the group box. \row - \o lineWidth - \o the line width with which to draw the panel. This + \li lineWidth + \li the line width with which to draw the panel. This is always 1. \row - \o text - \o the text of the group box. + \li text + \li the text of the group box. \row - \o textAlignment - \o the alignment of the group box title + \li textAlignment + \li the alignment of the group box title \row - \o textColor - \o the QColor of the text + \li textColor + \li the QColor of the text \endtable \section3 Splitters @@ -1487,11 +1487,11 @@ \table 90% \header - \o State - \o Set When + \li State + \li Set When \row - \o State_Horizontal - \o Set if it is a horizontal splitter + \li State_Horizontal + \li Set if it is a horizontal splitter \endtable QSplitter does not use \l{QStyleOption::}{initFrom()} to set up its @@ -1517,36 +1517,36 @@ \table 90% \header - \o Member - \o Content + \li Member + \li Content \row - \o minimum - \o The minimum value of the bar + \li minimum + \li The minimum value of the bar \row - \o maximum - \o The maximum value of the bar + \li maximum + \li The maximum value of the bar \row - \o progress - \o The current value of the bar + \li progress + \li The current value of the bar \row - \o textAlignment - \o How the text is aligned in the label + \li textAlignment + \li How the text is aligned in the label \row - \o textVisible - \o Whether the label is drawn + \li textVisible + \li Whether the label is drawn \row - \o text - \o The label text + \li text + \li The label text \row - \o orientation - \o Progress bars can be vertical or horizontal + \li orientation + \li Progress bars can be vertical or horizontal \row - \o invertedAppearance - \o The progress is inverted (i.e., right to left in a + \li invertedAppearance + \li The progress is inverted (i.e., right to left in a horizontal bar) \row - \o bottomToTop - \o Boolean that if true, turns the label of vertical + \li bottomToTop + \li Boolean that if true, turns the label of vertical progress bars 90 degrees. \endtable @@ -1578,58 +1578,58 @@ \table 90% \header - \o State - \o Set When + \li State + \li Set When \row - \o State_AutoRise - \o the tool button has the autoRise property set + \li State_AutoRise + \li the tool button has the autoRise property set \row - \o State_raised - \o the button is not sunken (i.e., by being checked or + \li State_raised + \li the button is not sunken (i.e., by being checked or pressed on with the mouse). \row - \o State_Sunken - \o the button is down + \li State_Sunken + \li the button is down \row - \o State_On - \o the button is checkable and checked. + \li State_On + \li the button is checkable and checked. \endtable QStyleOptionToolButton also contains the following members: \table \header - \o Member - \o Content + \li Member + \li Content \row - \o arrowType - \o a Qt::ArrowType enum value, which contains the + \li arrowType + \li a Qt::ArrowType enum value, which contains the direction of the buttons arrow (if an arrow is to be used in place of an icon) \row - \o features - \o flags of the QStyleOptionToolButton::ButtonFeature + \li features + \li flags of the QStyleOptionToolButton::ButtonFeature enum describing if the button has an arrow, a menu, and/or has a popup-delay. \row - \o font - \o the QFont of the buttons label + \li font + \li the QFont of the buttons label \row - \o icon - \o the QIcon of the tool button + \li icon + \li the QIcon of the tool button \row - \o iconSize - \o the icon size of the button's icon + \li iconSize + \li the icon size of the button's icon \row - \o pos - \o the position of the button, as given by + \li pos + \li the position of the button, as given by QWidget::pos() \row - \o text - \o the text of the button + \li text + \li the text of the button \row - \o toolButtonStyle - \o a Qt::ToolButtonStyle enum value which decides + \li toolButtonStyle + \li a Qt::ToolButtonStyle enum value which decides whether the button shows the icon, the text, or both. \endtable @@ -1677,29 +1677,29 @@ \table 90% \header - \o Member - \o Content + \li Member + \li Content \row - \o features - \o Holds whether the bar is movable in a value of the + \li features + \li Holds whether the bar is movable in a value of the ToolBarFeature, which is either Movable or None. \row - \o lineWidth - \o The width of the tool bar frame. + \li lineWidth + \li The width of the tool bar frame. \row - \o midLineWidth - \o This variable is currently not used and is always + \li midLineWidth + \li This variable is currently not used and is always 0. \row - \o positionOfLine - \o The position of the toolbar line within the toolbar + \li positionOfLine + \li The position of the toolbar line within the toolbar area to which it belongs. \row - \o positionWithinLine - \o The position of the toolbar within the toolbar line. + \li positionWithinLine + \li The position of the toolbar within the toolbar line. \row - \o toolBarArea - \o The toolbar area in which the toolbar lives. + \li toolBarArea + \li The toolbar area in which the toolbar lives. \endtable \section3 Menus @@ -1740,61 +1740,61 @@ \table 90% \header - \o State - \o Set When + \li State + \li Set When \row - \o State_Selected - \o The mouse is over the action and the action is not + \li State_Selected + \li The mouse is over the action and the action is not a separator. \row - \o State_Sunken - \o The mouse is pressed down on the menu item. + \li State_Sunken + \li The mouse is pressed down on the menu item. \row - \o State_DownArrow - \o Set if the menu item is a menu scroller and it scrolls + \li State_DownArrow + \li Set if the menu item is a menu scroller and it scrolls the menu downwards. \endtable \table 90% \header - \o Member - \o Content + \li Member + \li Content \row - \o checkType - \o A value of the \l{QStyleOptionMenuItem::}{CheckType} enum, + \li checkType + \li A value of the \l{QStyleOptionMenuItem::}{CheckType} enum, which is either NotCheckable, Exclusive, or NonExclusive. \row - \o checked - \o Boolean that is true if the menu item is checked. + \li checked + \li Boolean that is true if the menu item is checked. \row - \o font - \o The QFont to use for the menu item's text. + \li font + \li The QFont to use for the menu item's text. \row - \o icon - \o the QIcon of the menu item. + \li icon + \li the QIcon of the menu item. \row - \o maxIconWidth - \o The maximum width allowed for the icon + \li maxIconWidth + \li The maximum width allowed for the icon \row - \o menuHasChecableItem - \o Boolean which is true if at least one item in the + \li menuHasChecableItem + \li Boolean which is true if at least one item in the menu is checkable. \row - \o menuItemType - \o The type of the menu item. This a value of the + \li menuItemType + \li The type of the menu item. This a value of the \l{QStyleOptionMenuItem::}{MenuItemType}. \row - \o menuRect - \o The bounding rectangle for the QMenu that the menu + \li menuRect + \li The bounding rectangle for the QMenu that the menu item lives in. \row - \o tabWidth - \o This is the distance between the text of the menu + \li tabWidth + \li This is the distance between the text of the menu item and the shortcut. \row - \o text - \o The text of the menu item. + \li text + \li The text of the menu item. \endtable The setup of the style option for CE_MenuTearOff and @@ -1825,18 +1825,18 @@ \table \header - \o Member - \o Content + \li Member + \li Content \row - \o menuRect - \o the bounding rectangle of the entire menu bar to + \li menuRect + \li the bounding rectangle of the entire menu bar to which the item belongs. \row - \o text - \o the text of the item + \li text + \li the text of the item \row - \o icon - \o the icon of the menu item (it is not common that + \li icon + \li the icon of the menu item (it is not common that styles draw this icon) \endtable @@ -1874,44 +1874,44 @@ \table 90% \header - \o Member - \o Content + \li Member + \li Content \row - \o icon - \o the icon of the header (for section that is being + \li icon + \li the icon of the header (for section that is being drawn). \row - \o iconAlignment - \o the alignment (Qt::Alignment) of the icon in the header. + \li iconAlignment + \li the alignment (Qt::Alignment) of the icon in the header. \row - \o orientation - \o a Qt::Orientation value deciding whether the header + \li orientation + \li a Qt::Orientation value deciding whether the header is the horizontal header above the view or the vertical header on the left. \row - \o position - \o a QStyleOptionHeader::SectionPosition value + \li position + \li a QStyleOptionHeader::SectionPosition value giving the header section's position relative to the other sections. \row - \o section - \o holds the section that is being drawn. + \li section + \li holds the section that is being drawn. \row - \o selectedPosition - \o a QStyleOptionHeader::SelectedPosition value giving + \li selectedPosition + \li a QStyleOptionHeader::SelectedPosition value giving the selected section's position relative to the section that is being painted. \row - \o sortIndicator - \o a QStyleOptionHeader::SortIndicator value that + \li sortIndicator + \li a QStyleOptionHeader::SortIndicator value that describes the direction in which the section's sort indicator should be drawn. \row - \o text - \o the text of the currently drawn section. + \li text + \li the text of the currently drawn section. \row - \o textAlignment - \o the Qt::Alignment of the text within the + \li textAlignment + \li the Qt::Alignment of the text within the headersection. \endtable @@ -1927,22 +1927,22 @@ \table 90% \header - \o State - \o Set When + \li State + \li Set When \row - \o State_Sibling - \o the node in the tree has a sibling (i.e., there is + \li State_Sibling + \li the node in the tree has a sibling (i.e., there is another node in the same column). \row - \o State_Item - \o this branch indicator has an item. + \li State_Item + \li this branch indicator has an item. \row - \o State_Children - \o the branch has children (i.e., a new sub-tree can + \li State_Children + \li the branch has children (i.e., a new sub-tree can be opened at the branch). \row - \o State_Open - \o the branch indicator has an opened sub-tree. + \li State_Open + \li the branch indicator has an opened sub-tree. \endtable The tree view (and tree widget) use the style to draw the branches @@ -1986,14 +1986,14 @@ \table 90% \header - \o Member - \o Content + \li Member + \li Content \row - \o icon - \o the icon on the toolbox tab + \li icon + \li the icon on the toolbox tab \row - \o text - \o the text on the toolbox tab + \li text + \li the text on the toolbox tab \endtable \section3 Size Grip @@ -2014,11 +2014,11 @@ \table 90% \header - \o Member - \o Content + \li Member + \li Content \row - \o corner - \o a Qt::Corner value that describe which corner in a + \li corner + \li a Qt::Corner value that describe which corner in a window (or equivalent) the grip is located. \endtable @@ -2038,15 +2038,15 @@ \table \header - \o Member - \o Content + \li Member + \li Content \row - \o opaque - \o boolean that is true if the rubber band must be + \li opaque + \li boolean that is true if the rubber band must be drawn in an opaque style (i.e., color) \row - \o shape - \o a QRubberBand::Shape enum value that holds the + \li shape + \li a QRubberBand::Shape enum value that holds the shape of the band (which is either a rectangle or a line) \endtable @@ -2076,24 +2076,24 @@ \table 90% \header - \o Member - \o Content + \li Member + \li Content \row - \o closeable - \o boolean that holds whether the dock window can be + \li closeable + \li boolean that holds whether the dock window can be closed \row - \o floatable - \o boolean that holds whether the dock window can + \li floatable + \li boolean that holds whether the dock window can float (i.e., detach from the main window in which it lives) \row - \o movable - \o boolean that holds whether the window is movable + \li movable + \li boolean that holds whether the window is movable (i.e., can move to other dock widget areas) \row - \o title - \o the title text of the dock window + \li title + \li the title text of the dock window \endtable For the buttons, QStyleOptionButton is used (see \l{Tool Buttons} diff --git a/doc/src/widgets/widgets-and-layouts/stylesheet.qdoc b/doc/src/widgets/widgets-and-layouts/stylesheet.qdoc index a0a8652eaf..eaedb847c8 100644 --- a/doc/src/widgets/widgets-and-layouts/stylesheet.qdoc +++ b/doc/src/widgets/widgets-and-layouts/stylesheet.qdoc @@ -51,12 +51,12 @@ Topics: \list - \i \l{Overview} - \i \l{The Style Sheet Syntax} - \i \l{Qt Designer Integration} - \i \l{Customizing Qt Widgets Using Style Sheets} - \i \l{Qt Style Sheets Reference} - \i \l{Qt Style Sheets Examples} + \li \l{Overview} + \li \l{The Style Sheet Syntax} + \li \l{Qt Designer Integration} + \li \l{Customizing Qt Widgets Using Style Sheets} + \li \l{Qt Style Sheets Reference} + \li \l{Qt Style Sheets Examples} \endlist \target overview @@ -111,17 +111,17 @@ will. \table - \row \o \inlineimage stylesheet-coffee-xp.png - \o \inlineimage stylesheet-pagefold.png - \row \o Coffee theme running on Windows XP - \o Pagefold theme running on Windows XP + \row \li \inlineimage stylesheet-coffee-xp.png + \li \inlineimage stylesheet-pagefold.png + \row \li Coffee theme running on Windows XP + \li Pagefold theme running on Windows XP \endtable \table - \row \o \inlineimage stylesheet-coffee-cleanlooks.png - \o \inlineimage stylesheet-pagefold-mac.png - \row \o Coffee theme running on Ubuntu Linux - \o Pagefold theme running on Mac OS X + \row \li \inlineimage stylesheet-coffee-cleanlooks.png + \li \inlineimage stylesheet-pagefold-mac.png + \row \li Coffee theme running on Ubuntu Linux + \li Pagefold theme running on Mac OS X \endtable When a style sheet is active, the QStyle returned by QWidget::style() @@ -199,24 +199,24 @@ \table 100% \header - \o Selector - \o Example - \o Explanation + \li Selector + \li Example + \li Explanation \row - \o Universal Selector - \o \c * - \o Matches all widgets. + \li Universal Selector + \li \c * + \li Matches all widgets. \row - \o Type Selector - \o \c QPushButton - \o Matches instances of QPushButton and of its subclasses. + \li Type Selector + \li \c QPushButton + \li Matches instances of QPushButton and of its subclasses. \row - \o Property Selector - \o \c{QPushButton[flat="false"]} - \o Matches instances of QPushButton that are not + \li Property Selector + \li \c{QPushButton[flat="false"]} + \li Matches instances of QPushButton that are not \l{QPushButton::}{flat}. You may use this selector to test for any Qt \l{Qt's Property System}{property} that supports QVariant::toString() (see the \l{QVariant::}{toString()} @@ -237,29 +237,29 @@ unset the style sheet and set it again. \row - \o Class Selector - \o \c .QPushButton - \o Matches instances of QPushButton, but not of its subclasses. + \li Class Selector + \li \c .QPushButton + \li Matches instances of QPushButton, but not of its subclasses. This is equivalent to \c{*[class~="QPushButton"]}. \row - \o ID \target ID Selector + \li ID \target ID Selector Selector - \o \c{QPushButton#okButton} - \o Matches all QPushButton instances whose + \li \c{QPushButton#okButton} + \li Matches all QPushButton instances whose \l{QObject::objectName}{object name} is \c okButton. \row - \o Descendant Selector - \o \c{QDialog QPushButton} - \o Matches all instances of QPushButton that are descendants + \li Descendant Selector + \li \c{QDialog QPushButton} + \li Matches all instances of QPushButton that are descendants (children, grandchildren, etc.) of a QDialog. \row - \o Child Selector - \o \c{QDialog > QPushButton} - \o Matches all instances of QPushButton that are direct + \li Child Selector + \li \c{QDialog > QPushButton} + \li Matches all instances of QPushButton that are direct children of a QDialog. \endtable @@ -329,7 +329,7 @@ Sub-Control} for a realistic example. \note With complex widgets such as QComboBox and QScrollBar, if one - property or sub-control is customized, \bold{all} the other properties or + property or sub-control is customized, \b{all} the other properties or sub-controls must be customized as well. \section1 Pseudo-States @@ -436,10 +436,10 @@ \e{A selector's specificity is calculated as follows:} \list - \o \e{count the number of ID attributes in the selector (= a)} - \o \e{count the number of other attributes and pseudo-classes in the selector (= b)} - \o \e{count the number of element names in the selector (= c)} - \o \e{ignore pseudo-elements [i.e., \l{subcontrols}].} + \li \e{count the number of ID attributes in the selector (= a)} + \li \e{count the number of other attributes and pseudo-classes in the selector (= b)} + \li \e{count the number of element names in the selector (= c)} + \li \e{ignore pseudo-elements [i.e., \l{subcontrols}].} \endlist \e{Concatenating the three numbers a-b-c (in a number system with a @@ -495,7 +495,7 @@ In classic CSS, when font and color of an item is not explicitly set, it gets automatically inherited from the parent. When using Qt Style Sheets, - a widget does \bold{not} automatically inherit its font and color setting + a widget does \b{not} automatically inherit its font and color setting from its parent widget. For example, consider a QPushButton inside a QGroupBox: @@ -589,11 +589,11 @@ \image stylesheet-boxmodel.png \list - \o The margin falls outside the border. - \o The border is drawn between the margin and the padding. - \o The padding falls inside the border, between the border and + \li The margin falls outside the border. + \li The border is drawn between the margin and the padding. + \li The padding falls inside the border, between the border and the actual contents. - \o The content is what is left from the original widget or + \li The content is what is left from the original widget or subcontrol once we have removed the margin, the border, and the padding. \endlist @@ -636,10 +636,10 @@ The steps to render a rule are as follows: \list - \o Set clip for entire rendering operation (border-radius) - \o Draw the background (background-image) - \o Draw the border (border-image, border) - \o Draw overlay image (image) + \li Set clip for entire rendering operation (border-radius) + \li Draw the background (background-image) + \li Draw the border (border-image, border) + \li Draw overlay image (image) \endlist \target sub controls @@ -650,9 +650,9 @@ followed by the down-arrow sub-control. A QComboBox is thus rendered as follows: \list - \o Render the QComboBox { } rule - \o Render the QComboBox::drop-down { } rule - \o Render the QComboBox::down-arrow { } rule + \li Render the QComboBox { } rule + \li Render the QComboBox::drop-down { } rule + \li Render the QComboBox::down-arrow { } rule \endlist Sub-controls share a parent-child relationship. In the case of QComboBox, @@ -666,7 +666,7 @@ Once positioned, sub-controls can be styled using the \l{box model}. \note With complex widgets such as QComboBox and QScrollBar, if one - property or sub-control is customized, \bold{all} the other properties or + property or sub-control is customized, \b{all} the other properties or sub-controls must be customized as well. */ @@ -691,12 +691,12 @@ \table 100% \header - \o Widget - \o How to Style + \li Widget + \li How to Style \row - \o QAbstractScrollArea \target qabstractscrollarea-widget - \o Supports the \l{box model}. + \li QAbstractScrollArea \target qabstractscrollarea-widget + \li Supports the \l{box model}. All derivatives of QAbstractScrollArea, including QTextEdit, and QAbstractItemView (all item view classes), support @@ -711,8 +711,8 @@ {Customizing QAbstractScrollArea} for an example. \row - \o QCheckBox \target qcheckbox-widget - \o Supports the \l{box model}. The check indicator can be + \li QCheckBox \target qcheckbox-widget + \li Supports the \l{box model}. The check indicator can be styled using the \l{#indicator-sub}{::indicator} subcontrol. By default, the indicator is placed in the Top Left corner of the Contents rectangle of the widget. @@ -725,15 +725,15 @@ {Customizing QCheckBox} for an example. \row - \o QColumnView \target qcolumnview-widget - \o The grip can be styled be using the \l{image-prop}{image} property. + \li QColumnView \target qcolumnview-widget + \li The grip can be styled be using the \l{image-prop}{image} property. The arrow indicators can by styled using the \l{left-arrow-sub}{::left-arrow} subcontrol and the \l{right-arrow-sub}{::right-arrow} subcontrol. \row - \o QComboBox \target qcombobox-widget - \o The frame around the combobox can be styled using the + \li QComboBox \target qcombobox-widget + \li The frame around the combobox can be styled using the \l{box model}. The drop-down button can be styled using the \l{#drop-down-sub}{::drop-down} subcontrol. By default, the drop-down button is placed in the top right corner of the padding @@ -746,16 +746,16 @@ for an example. \row - \o QDateEdit \target qdateedit-widget - \o See \l{#qspinbox-widget}{QSpinBox}. + \li QDateEdit \target qdateedit-widget + \li See \l{#qspinbox-widget}{QSpinBox}. \row - \o QDateTimeEdit \target qdatetimeedit-widget - \o See \l{#qspinbox-widget}{QSpinBox}. + \li QDateTimeEdit \target qdatetimeedit-widget + \li See \l{#qspinbox-widget}{QSpinBox}. \row - \o QDialog \target qdialog-widget - \o Supports only the \l{Qt Style Sheets Reference#background-prop}{background}, + \li QDialog \target qdialog-widget + \li Supports only the \l{Qt Style Sheets Reference#background-prop}{background}, \l{#background-clip-prop}{background-clip} and \l{#background-origin-prop}{background-origin} properties. @@ -763,13 +763,13 @@ widget. \row - \o QDialogButtonBox \target qdialogbuttonbox-widget - \o The layout of buttons can be altered using the + \li QDialogButtonBox \target qdialogbuttonbox-widget + \li The layout of buttons can be altered using the \l{#button-layout-prop}{button-layout} property. \row - \o QDockWidget \target qdockwidget-widget - \o Supports styling of the title bar and the title bar buttons when docked. + \li QDockWidget \target qdockwidget-widget + \li Supports styling of the title bar and the title bar buttons when docked. The dock widget border can be styled using the \l{#border-prop}{border} property. The \l{#title-sub}{::title} subcontrol can be used to customize @@ -792,12 +792,12 @@ {Customizing QDockWidget} for an example. \row - \o QDoubleSpinBox \target qdoublespinbox-widget - \o See \l{#qspinbox-widget}{QSpinBox}. + \li QDoubleSpinBox \target qdoublespinbox-widget + \li See \l{#qspinbox-widget}{QSpinBox}. \row - \o QFrame \target qframe-widget - \o Supports the \l{box model}. + \li QFrame \target qframe-widget + \li Supports the \l{box model}. Since 4.3, setting a stylesheet on a QLabel automatically sets the QFrame::frameStyle property to QFrame::StyledPanel. @@ -806,8 +806,8 @@ for an example. \row - \o QGroupBox \target qgroupbox-widget - \o Supports the \l{box model}. The title can be styled using the + \li QGroupBox \target qgroupbox-widget + \li Supports the \l{box model}. The title can be styled using the \l{#title-sub}{::title} subcontrol. By default, the title is placed depending on QGroupBox::textAlignment. @@ -821,8 +821,8 @@ for an example. \row - \o QHeaderView \target qheaderview-widget - \o Supports the \l{box model}. The sections of the header view are + \li QHeaderView \target qheaderview-widget + \li Supports the \l{box model}. The sections of the header view are styled using the \l{#section-sub}{::section} sub control. The \c{section} Sub-control supports the \l{#middle-ps}{:middle}, \l{#first-ps}{:first}, \l{#last-ps}{:last}, @@ -839,8 +839,8 @@ for an example. \row - \o QLabel \target qlabel-widget - \o Supports the \l{box model}. Does not support the + \li QLabel \target qlabel-widget + \li Supports the \l{box model}. Does not support the \l{#hover-ps}{:hover} pseudo-state. Since 4.3, setting a stylesheet on a QLabel automatically @@ -850,8 +850,8 @@ example (a QLabel derives from QFrame). \row - \o QLineEdit \target qlineedit-widget - \o Support the \l{box model}. + \li QLineEdit \target qlineedit-widget + \li Support the \l{box model}. The color and background of the selected item is styled using \l{#selection-color-prop}{selection-color} and @@ -866,8 +866,8 @@ for an example. \row - \o QListView \target qlistview-widget - \o Supports the \l{box model}. When + \li QListView \target qlistview-widget + \li Supports the \l{box model}. When \l{QAbstractItemView::alternatingRowColors}{alternating row colors} is enabled, the alternating colors can be styled using the \l{#alternate-background-color-prop}{alternate-background-color} @@ -891,12 +891,12 @@ {Customzing QListView} for an example. \row - \o QListWidget \target qlistwidget-widget - \o See \l{#qlistview-widget}{QListView}. + \li QListWidget \target qlistwidget-widget + \li See \l{#qlistview-widget}{QListView}. \row - \o QMainWindow \target qmainwindow-widget - \o Supports styling of the separator + \li QMainWindow \target qmainwindow-widget + \li Supports styling of the separator The separator in a QMainWindow when using QDockWidget is styled using the \l{#separator-sub}{::separator} subcontrol. @@ -905,8 +905,8 @@ for an example. \row - \o QMenu \target qmenu-widget - \o Supports the \l{box model}. + \li QMenu \target qmenu-widget + \li Supports the \l{box model}. Individual items are styled using the \l{#item-sub}{::item} subcontrol. In addition to the usually supported pseudo states, @@ -933,8 +933,8 @@ for an example. \row - \o QMenuBar \target qmenubar-widget - \o Supports the \l{box model}. The \l{#spacing-prop}{spacing} + \li QMenuBar \target qmenubar-widget + \li Supports the \l{box model}. The \l{#spacing-prop}{spacing} property specifies the spacing between menu items. Individual items are styled using the \l{#item-sub}{::item} subcontrol. @@ -946,14 +946,14 @@ for an example. \row - \o QMessageBox \target qmessagebox-widget - \o The \l{#messagebox-text-interaction-flags-prop} + \li QMessageBox \target qmessagebox-widget + \li The \l{#messagebox-text-interaction-flags-prop} {messagebox-text-interaction-flags} property can be used to alter the interaction with text in the message box. \row - \o QProgressBar \target qprogressbar-widget - \o Supports the \l{box model}. The chunks of the progress bar + \li QProgressBar \target qprogressbar-widget + \li Supports the \l{box model}. The chunks of the progress bar can be styled using the \l{#chunk-sub}{::chunk} subcontrol. The chunk is displayed on the Contents rectangle of the widget. @@ -967,8 +967,8 @@ for an example. \row - \o QPushButton \target qpushbutton-widget - \o Supports the \l{box model}. Supports the \l{#default-ps}{:default}, + \li QPushButton \target qpushbutton-widget + \li Supports the \l{box model}. Supports the \l{#default-ps}{:default}, \l{#flat-ps}{:flat}, \l{#checked-ps}{:checked} pseudo states. For QPushButton with a menu, the menu indicator is styled @@ -988,8 +988,8 @@ for an example. \row - \o QRadioButton \target qradiobutton-widget - \o Supports the \l{box model}. The check indicator can be + \li QRadioButton \target qradiobutton-widget + \li Supports the \l{box model}. The check indicator can be styled using the \l{#indicator-sub}{::indicator} subcontrol. By default, the indicator is placed in the Top Left corner of the Contents rectangle of the widget. @@ -1002,8 +1002,8 @@ {Customizing QRadioButton} for an example. \row - \o QScrollBar \target qscrollbar-widget - \o Supports the \l{box model}. The Contents rectangle of the widget + \li QScrollBar \target qscrollbar-widget + \li Supports the \l{box model}. The Contents rectangle of the widget is considered to be the groove over which the slider moves. The extent of the QScrollBar (i.e the width or the height depending on the orientation) is set using the \l{#width-prop}{width} or \l{#height-prop}{height} property @@ -1037,8 +1037,8 @@ for an example. \row - \o QSizeGrip \target qsizegrip-widget - \o Supports the \l{#width-prop}{width}, + \li QSizeGrip \target qsizegrip-widget + \li Supports the \l{#width-prop}{width}, \l{#height-prop}{height}, and \l{#image-prop}{image} properties. @@ -1046,8 +1046,8 @@ for an example. \row - \o QSlider \target qslider-widget - \o Supports the \l{box model}. For horizontal slides, the + \li QSlider \target qslider-widget + \li Supports the \l{box model}. For horizontal slides, the \l{min-width-prop}{min-width} and \l{height-prop}{height} properties must be provided. For vertical sliders, the \l{min-height-prop}{min-height} and \l{width-prop}{width} @@ -1064,8 +1064,8 @@ for an example. \row - \o QSpinBox \target qspinbox-widget - \o The frame of the spin box can be styled using the \l{box + \li QSpinBox \target qspinbox-widget + \li The frame of the spin box can be styled using the \l{box model}. The up button and arrow can be styled using the @@ -1090,16 +1090,16 @@ for an example. \row - \o QSplitter \target qsplitter-widget - \o Supports the \l{box model}. The handle of the splitter + \li QSplitter \target qsplitter-widget + \li Supports the \l{box model}. The handle of the splitter is styled using the \l{#handle-sub}{::handle} subcontrol. See \l{Qt Style Sheets Examples#Customizing QSplitter}{Customizing QSplitter} for an example. \row - \o QStatusBar \target qstatusbar-widget - \o Supports only the \l{Qt Style Sheets Reference#background-prop} + \li QStatusBar \target qstatusbar-widget + \li Supports only the \l{Qt Style Sheets Reference#background-prop} {background} property. The frame for individual items can be style using the \l{#item-sub}{::item} subcontrol. @@ -1108,8 +1108,8 @@ for an example. \row - \o QTabBar \target qtabbar-widget - \o Individual tabs may be styled using the \l{#tab-sub}{::tab} subcontrol. + \li QTabBar \target qtabbar-widget + \li Individual tabs may be styled using the \l{#tab-sub}{::tab} subcontrol. Close buttons using the \l{#close-button-sub}{::close-button} The tabs support the \l{#only-one-ps}{:only-one}, \l{#first-ps}{:first}, @@ -1143,8 +1143,8 @@ for an example. \row - \o QTabWidget \target qtabwidget-widget - \o The frame of the tab widget is styled using the + \li QTabWidget \target qtabwidget-widget + \li The frame of the tab widget is styled using the \l{#pane-sub}{::pane} subcontrol. The left and right corners are styled using the \l{#left-corner-sub}{::left-corner} and \l{#right-corner-sub}{::right-corner} respectively. @@ -1163,8 +1163,8 @@ {Customizing QTabWidget} for an example. \row - \o QTableView \target qtableview-widget - \o Supports the \l{box model}. When + \li QTableView \target qtableview-widget + \li Supports the \l{box model}. When \l{QAbstractItemView::alternatingRowColors}{alternating row colors} is enabled, the alternating colors can be styled using the \l{#alternate-background-color-prop}{alternate-background-color} @@ -1194,12 +1194,12 @@ {Customzing QTableView} for an example. \row - \o QTableWidget \target qtablewidget-widget - \o See \l{#qtableview-widget}{QTableView}. + \li QTableWidget \target qtablewidget-widget + \li See \l{#qtableview-widget}{QTableView}. \row - \o QTextEdit \target qtextedit-widget - \o Supports the \l{box model}. + \li QTextEdit \target qtextedit-widget + \li Supports the \l{box model}. The color and background of selected text is styled using \l{#selection-color-prop}{selection-color} and @@ -1210,12 +1210,12 @@ style scrollable backgrounds. \row - \o QTimeEdit \target qtimeedit-widget - \o See \l{#qspinbox-widget}{QSpinBox}. + \li QTimeEdit \target qtimeedit-widget + \li See \l{#qspinbox-widget}{QSpinBox}. \row - \o QToolBar \target qtoolbar-widget - \o Supports the \l{box model}. + \li QToolBar \target qtoolbar-widget + \li Supports the \l{box model}. The \l{#top-ps}{:top}, \l{#left-ps}{:left}, \l{#right-ps}{:right}, \l{#bottom-ps}{:bottom} pseudo states depending on the area in @@ -1236,8 +1236,8 @@ for an example. \row - \o QToolButton \target qtoolbutton-widget - \o Supports the \l{box model}. + \li QToolButton \target qtoolbutton-widget + \li Supports the \l{box model}. If the QToolButton has a menu, is \l{#menu-indicator-sub}{::menu-indicator} subcontrol can be used to @@ -1266,8 +1266,8 @@ for an example. \row - \o QToolBox \target qtoolbox-widget - \o Supports the \l{box model}. + \li QToolBox \target qtoolbox-widget + \li Supports the \l{box model}. The individual tabs can by styled using the \l{#tab-sub}{::tab} subcontrol. The tabs support the @@ -1278,16 +1278,16 @@ \l{#selected-ps}{:selected} pseudo states. \row - \o QToolTip \target qtooltip-widget - \o Supports the \l{box model}. The \l{#opacity-prop}{opacity} + \li QToolTip \target qtooltip-widget + \li Supports the \l{box model}. The \l{#opacity-prop}{opacity} property controls the opacity of the tooltip. See \l{Qt Style Sheets Examples#Customizing QFrame}{Customizing QFrame} for an example (a QToolTip is a QFrame). \row - \o QTreeView \target qtreeview-widget - \o Supports the \l{box model}. When + \li QTreeView \target qtreeview-widget + \li Supports the \l{box model}. When \l{QAbstractItemView::alternatingRowColors}{alternating row colors} is enabled, the alternating colors can be styled using the \l{#alternate-background-color-prop}{alternate-background-color} @@ -1317,12 +1317,12 @@ for an example to style the branches. \row - \o QTreeWidget \target qtreewidget-widget - \o See \l{#qtreeview-widget}{QTreeView}. + \li QTreeWidget \target qtreewidget-widget + \li See \l{#qtreeview-widget}{QTreeView}. \row - \o QWidget \target qwidget-widget - \o Supports only the \l{Qt Style Sheets Reference#background-prop}{background}, + \li QWidget \target qwidget-widget + \li Supports only the \l{Qt Style Sheets Reference#background-prop}{background}, \l{#background-clip-prop}{background-clip} and \l{#background-origin-prop}{background-origin} properties. @@ -1348,14 +1348,14 @@ \table 100% \header - \o Property - \o Type - \o Description + \li Property + \li Type + \li Description \row - \o \bold{\c alternate-background-color} \target alternate-background-color-prop - \o \l{#Brush}{Brush} \BR - \o The \l{QAbstractItemView::alternatingRowColors} + \li \b{\c alternate-background-color} \target alternate-background-color-prop + \li \l{#Brush}{Brush} \BR + \li The \l{QAbstractItemView::alternatingRowColors} {alternate background color} used in QAbstractItemView subclasses. If this property is not set, the default value is @@ -1370,9 +1370,9 @@ \l{#selection-background-color-prop}{selection-background-color}. \row - \o \bold{\c background} \target background-prop - \o \l{#Background}{Background} - \o Shorthand notation for setting the background. Equivalent + \li \b{\c background} \target background-prop + \li \l{#Background}{Background} + \li Shorthand notation for setting the background. Equivalent to specifying \c background-color, \c background-image, \c background-repeat, and/or \c background-position. @@ -1404,18 +1404,18 @@ and \l{#alternate-background-color-prop}{alternate-background-color}. \row - \o \c background-color \target background-color-prop - \o \l{#Brush}{Brush} \BR - \o The background color used for the widget. + \li \c background-color \target background-color-prop + \li \l{#Brush}{Brush} \BR + \li The background color used for the widget. Examples: \snippet doc/src/snippets/code/doc_src_stylesheet.qdoc 36 \row - \o \c background-image \target background-image-prop - \o \l{#Url}{Url} - \o The background image used for the widget. Semi-transparent + \li \c background-image \target background-image-prop + \li \l{#Url}{Url} + \li The background image used for the widget. Semi-transparent parts of the image let the \c background-color shine through. @@ -1424,9 +1424,9 @@ \snippet doc/src/snippets/code/doc_src_stylesheet.qdoc 37 \row - \o \c background-repeat \target background-repeat-prop - \o \l{#Repeat}{Repeat} - \o Whether and how the background image is repeated to fill + \li \c background-repeat \target background-repeat-prop + \li \l{#Repeat}{Repeat} + \li Whether and how the background image is repeated to fill the \c background-origin rectangle. If this property is not specified, the background image @@ -1437,9 +1437,9 @@ \snippet doc/src/snippets/code/doc_src_stylesheet.qdoc 38 \row - \o \c background-position - \o \l{#Alignment}{Alignment} - \o The alignment of the background image within the \c + \li \c background-position + \li \l{#Alignment}{Alignment} + \li The alignment of the background image within the \c background-origin rectangle. If this property is not specified, the alignment is \c @@ -1450,9 +1450,9 @@ \snippet doc/src/snippets/code/doc_src_stylesheet.qdoc 39 \row - \o \bold{\c background-attachment} \target background-attachment-prop - \o \l{#Attachment}{Attachment} - \o Determines whether the background-image in a QAbstractScrollArea + \li \b{\c background-attachment} \target background-attachment-prop + \li \l{#Attachment}{Attachment} + \li Determines whether the background-image in a QAbstractScrollArea is scrolled or fixed with respect to the viewport. By default, the background-image scrolls with the viewport. @@ -1463,9 +1463,9 @@ See also \l{Qt Style Sheets Reference#background-prop}{background} \row - \o \bold{\c background-clip} \target background-clip-prop - \o \l{#Origin}{Origin} - \o The widget's rectangle, in which the \c background is drawn. + \li \b{\c background-clip} \target background-clip-prop + \li \l{#Origin}{Origin} + \li The widget's rectangle, in which the \c background is drawn. This property specifies the rectangle to which the \c background-color and \c background-image are clipped. @@ -1487,9 +1487,9 @@ \l{#background-origin-prop}{background-origin} and \l{The Box Model}. \row - \o \bold{\c background-origin} \target background-origin-prop - \o \l{#Origin}{Origin} - \o The widget's background rectangle, to use in conjunction + \li \b{\c background-origin} \target background-origin-prop + \li \l{#Origin}{Origin} + \li The widget's background rectangle, to use in conjunction with \c background-position and \c background-image. This property is supported by QAbstractItemView @@ -1509,9 +1509,9 @@ \l{The Box Model}. \row - \o \bold{\c border} \target border-prop - \o \l{#Border}{Border} - \o Shorthand notation for setting the widget's border. Equivalent + \li \b{\c border} \target border-prop + \li \l{#Border}{Border} + \li Shorthand notation for setting the widget's border. Equivalent to specifying \c border-color, \c border-style, and/or \c border-width. @@ -1526,38 +1526,38 @@ \snippet doc/src/snippets/code/doc_src_stylesheet.qdoc 43 \row - \o \c border-top - \o \l{#Border}{Border} - \o Shorthand notation for setting the widget's top border. + \li \c border-top + \li \l{#Border}{Border} + \li Shorthand notation for setting the widget's top border. Equivalent to specifying \c border-top-color, \c border-top-style, and/or \c border-top-width. \row - \o \c border-right - \o \l{#Border}{Border} - \o Shorthand notation for setting the widget's right border. + \li \c border-right + \li \l{#Border}{Border} + \li Shorthand notation for setting the widget's right border. Equivalent to specifying \c border-right-color, \c border-right-style, and/or \c border-right-width. \row - \o \c border-bottom - \o \l{#Border}{Border} - \o Shorthand notation for setting the widget's bottom border. + \li \c border-bottom + \li \l{#Border}{Border} + \li Shorthand notation for setting the widget's bottom border. Equivalent to specifying \c border-bottom-color, \c border-bottom-style, and/or \c border-bottom-width. \row - \o \c border-left - \o \l{#Border}{Border} - \o Shorthand notation for setting the widget's left border. + \li \c border-left + \li \l{#Border}{Border} + \li Shorthand notation for setting the widget's left border. Equivalent to specifying \c border-left-color, \c border-left-style, and/or \c border-left-width. \row - \o \bold{\c border-color} \target border-attrs + \li \b{\c border-color} \target border-attrs \target border-color-prop - \o \l{#Box Colors}{Box Colors} - \o The color of all the border's edges. Equivalent to + \li \l{#Box Colors}{Box Colors} + \li The color of all the border's edges. Equivalent to specifying \c border-top-color, \c border-right-color, \c border-bottom-color, and \c border-left-color. @@ -1580,29 +1580,29 @@ \l{#border-image-prop}{border-image}, and \l{The Box Model}. \row - \o \c border-top-color - \o \l{#Brush}{Brush} \BR - \o The color of the border's top edge. + \li \c border-top-color + \li \l{#Brush}{Brush} \BR + \li The color of the border's top edge. \row - \o \c border-right-color - \o \l{#Brush}{Brush} \BR - \o The color of the border's right edge. + \li \c border-right-color + \li \l{#Brush}{Brush} \BR + \li The color of the border's right edge. \row - \o \c border-bottom-color - \o \l{#Brush}{Brush} \BR - \o The color of the border's bottom edge. + \li \c border-bottom-color + \li \l{#Brush}{Brush} \BR + \li The color of the border's bottom edge. \row - \o \c border-left-color - \o \l{#Brush}{Brush} \BR - \o The color of the border's left edge. + \li \c border-left-color + \li \l{#Brush}{Brush} \BR + \li The color of the border's left edge. \row - \o \bold{\c border-image} \target border-image-prop - \o \l{#Border Image}{Border Image} - \o The image used to fill the border. The image is cut into + \li \b{\c border-image} \target border-image-prop + \li \l{#Border Image}{Border Image} + \li The image used to fill the border. The image is cut into nine parts and stretched appropriately if necessary. See \l{#Border Image}{Border Image} for details. @@ -1618,9 +1618,9 @@ \l{The Box Model}. \row - \o \bold{\c border-radius} \target border-radius-prop - \o \l{#Radius}{Radius} - \o The radius of the border's corners. Equivalent to + \li \b{\c border-radius} \target border-radius-prop + \li \l{#Radius}{Radius} + \li The radius of the border's corners. Equivalent to specifying \c border-top-left-radius, \c border-top-right-radius, \c border-bottom-right-radius, and \c border-bottom-left-radius. @@ -1644,32 +1644,32 @@ \l{The Box Model}. \row - \o \c border-top-left-radius - \o \l{#Radius}{Radius} - \o The radius of the border's top-left corner. + \li \c border-top-left-radius + \li \l{#Radius}{Radius} + \li The radius of the border's top-left corner. \row - \o \c border-top-right-radius - \o \l{#Radius}{Radius} - \o The radius of the border's top-right corner. + \li \c border-top-right-radius + \li \l{#Radius}{Radius} + \li The radius of the border's top-right corner. \row - \o \c border-bottom-right-radius - \o \l{#Radius}{Radius} - \o The radius of the border's bottom-right corner. Setting + \li \c border-bottom-right-radius + \li \l{#Radius}{Radius} + \li The radius of the border's bottom-right corner. Setting this property to a positive value results in a rounded corner. \row - \o \c border-bottom-left-radius - \o \l{#Radius}{Radius} - \o The radius of the border's bottom-left corner. Setting this + \li \c border-bottom-left-radius + \li \l{#Radius}{Radius} + \li The radius of the border's bottom-left corner. Setting this property to a positive value results in a rounded corner. \row - \o \bold{\c border-style} \target border-style-prop - \o \l {Border Style} - \o The style of all the border's edges. + \li \b{\c border-style} \target border-style-prop + \li \l {Border Style} + \li The style of all the border's edges. This property is supported by QAbstractItemView subclasses, QAbstractSpinBox subclasses, QCheckBox, @@ -1688,29 +1688,29 @@ \l{#border-image-prop}{border-image}, and \l{The Box Model}. \row - \o \c border-top-style - \o \l{#Border Style}{Border Style} - \o The style of the border's top edge. + \li \c border-top-style + \li \l{#Border Style}{Border Style} + \li The style of the border's top edge. \row - \o \c border-right-style - \o \l{#Border Style}{Border Style} - \o The style of the border's right edge/ + \li \c border-right-style + \li \l{#Border Style}{Border Style} + \li The style of the border's right edge/ \row - \o \c border-bottom-style - \o \l{#Border Style}{Border Style} - \o The style of the border's bottom edge. + \li \c border-bottom-style + \li \l{#Border Style}{Border Style} + \li The style of the border's bottom edge. \row - \o \c border-left-style - \o \l{#Border Style}{Border Style} - \o The style of the border's left edge. + \li \c border-left-style + \li \l{#Border Style}{Border Style} + \li The style of the border's left edge. \row - \o \bold{\c border-width} \target border-width-prop - \o \l{#Box Lengths}{Box Lengths} - \o The width of the border. Equivalent to setting \c + \li \b{\c border-width} \target border-width-prop + \li \l{#Box Lengths}{Box Lengths} + \li The width of the border. Equivalent to setting \c border-top-width, \c border-right-width, \c border-bottom-width, and \c border-left-width. @@ -1731,29 +1731,29 @@ \l{The Box Model}. \row - \o \c border-top-width - \o \l{#Length}{Length} - \o The width of the border's top edge. + \li \c border-top-width + \li \l{#Length}{Length} + \li The width of the border's top edge. \row - \o \c border-right-width - \o \l{#Length}{Length} - \o The width of the border's right edge. + \li \c border-right-width + \li \l{#Length}{Length} + \li The width of the border's right edge. \row - \o \c border-bottom-width - \o \l{#Length}{Length} - \o The width of the border's bottom edge. + \li \c border-bottom-width + \li \l{#Length}{Length} + \li The width of the border's bottom edge. \row - \o \c border-left-width - \o \l{#Length}{Length} - \o The width of the border's left edge. + \li \c border-left-width + \li \l{#Length}{Length} + \li The width of the border's left edge. \row - \o \bold{\c bottom} \target bottom-prop - \o \l{#Length}{Length} - \o If \l{#position-prop}{position} is \c relative (the + \li \b{\c bottom} \target bottom-prop + \li \l{#Length}{Length} + \li If \l{#position-prop}{position} is \c relative (the default), moves a \l{subcontrol} by a certain offset up; specifying \tt{bottom: \e{y}} is then equivalent to specifying \tt{\l{Qt Style Sheets Reference#top-prop}{top}: -\e{y}}. @@ -1772,9 +1772,9 @@ \l{Qt Style Sheets Reference#top-prop}{top}. \row - \o \bold{\c button-layout} \target button-layout-prop - \o \l{#Number}{Number} - \o The layout of buttons in a QDialogButtonBox or + \li \b{\c button-layout} \target button-layout-prop + \li \l{#Number}{Number} + \li The layout of buttons in a QDialogButtonBox or a QMessageBox. The possible values are 0 (\l{QDialogButtonBox::}{WinLayout}), 1 (\l{QDialogButtonBox::}{MacLayout}), 2 @@ -1790,9 +1790,9 @@ \snippet doc/src/snippets/code/doc_src_stylesheet.qdoc 49 \row - \o \bold{\c color} \target color-prop - \o \l{#Brush}{Brush} \BR - \o The color used to render text. + \li \b{\c color} \target color-prop + \li \l{#Brush}{Brush} \BR + \li The color used to render text. This property is supported by all widgets that respect the \l QWidget::palette. @@ -1809,9 +1809,9 @@ \l{#selection-color-prop}{selection-color}. \row - \o \bold{\c dialogbuttonbox-buttons-have-icons} - \o \l{#Boolean}{Boolean} - \o Whether the buttons in a QDialogButtonBox show icons + \li \b{\c dialogbuttonbox-buttons-have-icons} + \li \l{#Boolean}{Boolean} + \li Whether the buttons in a QDialogButtonBox show icons If this property is set to 1, the buttons of a QDialogButtonBox show icons; if it is set to 0, the icons are not shown. @@ -1827,9 +1827,9 @@ \omit \row - \o \bold{\c etch-disabled-text}* - \o \l{#Boolean}{Boolean} - \o Whether disabled text is drawn etched. + \li \b{\c etch-disabled-text}* + \li \l{#Boolean}{Boolean} + \li Whether disabled text is drawn etched. If this property is not specified, it defaults to the value specified by the current style for the @@ -1841,9 +1841,9 @@ \endomit \row - \o \bold{\c font} \target font-prop - \o \l{#Font}{Font} - \o Shorthand notation for setting the text's font. Equivalent + \li \b{\c font} \target font-prop + \li \l{#Font}{Font} + \li Shorthand notation for setting the text's font. Equivalent to specifying \c font-family, \c font-size, \c font-style, and/or \c font-weight. @@ -1858,18 +1858,18 @@ \snippet doc/src/snippets/code/doc_src_stylesheet.qdoc 53 \row - \o \c font-family - \o String - \o The font family. + \li \c font-family + \li String + \li The font family. Example: \snippet doc/src/snippets/code/doc_src_stylesheet.qdoc 54 \row - \o \c font-size - \o \l{#Font Size}{Font Size} - \o The font size. In this version of Qt, only pt and px metrics are + \li \c font-size + \li \l{#Font Size}{Font Size} + \li The font size. In this version of Qt, only pt and px metrics are supported. Example: @@ -1877,23 +1877,23 @@ \snippet doc/src/snippets/code/doc_src_stylesheet.qdoc 55 \row - \o \c font-style - \o \l {Font Style} - \o The font style. + \li \c font-style + \li \l {Font Style} + \li The font style. Example: \snippet doc/src/snippets/code/doc_src_stylesheet.qdoc 56 \row - \o \c font-weight - \o \l{#Font Weight}{Font Weight} - \o The weight of the font. + \li \c font-weight + \li \l{#Font Weight}{Font Weight} + \li The weight of the font. \row - \o \bold{\c gridline-color}* \target gridline-color-prop - \o \l{#Color}{Color} \BR - \o The color of the grid line in a QTableView. + \li \b{\c gridline-color}* \target gridline-color-prop + \li \l{#Color}{Color} \BR + \li The color of the grid line in a QTableView. If this property is not specified, it defaults to the value specified by the current style for the @@ -1904,9 +1904,9 @@ \snippet doc/src/snippets/code/doc_src_stylesheet.qdoc 57 \row - \o \bold{\c height} \target height-prop - \o \l{#Length}{Length} - \o The height of a \l{subcontrol} (or in some case, a widget). + \li \b{\c height} \target height-prop + \li \l{#Length}{Length} + \li The height of a \l{subcontrol} (or in some case, a widget). If this property is not specified, it defaults to a value that depends on the subcontrol/widget and on the current style. @@ -1923,27 +1923,27 @@ See also \l{#width-prop}{width}. \row - \o \bold{\c icon-size} \target icon-size-prop - \o \l{#Length}{Length} - \o The width and height of the icon in a widget. + \li \b{\c icon-size} \target icon-size-prop + \li \l{#Length}{Length} + \li The width and height of the icon in a widget. The icon size of the following widgets can be set using this property. \list - \i QCheckBox - \i QListView - \i QPushButton - \i QRadioButton - \i QTabBar - \i QToolBar - \i QToolBox - \i QTreeView + \li QCheckBox + \li QListView + \li QPushButton + \li QRadioButton + \li QTabBar + \li QToolBar + \li QToolBox + \li QTreeView \endlist \row - \o \bold{\c image}* \target image-prop - \o \l{#Url}{Url}+ - \o The image that is drawn in the contents rectangle of a + \li \b{\c image}* \target image-prop + \li \l{#Url}{Url}+ + \li The image that is drawn in the contents rectangle of a \l{subcontrol}. The image property accepts a list of \l{#Url}{Url}s or @@ -1969,15 +1969,15 @@ \snippet doc/src/snippets/code/doc_src_stylesheet.qdoc 59 \row - \o \bold{\c image-position} \target image-position-prop - \o \l{#Alignment}{alignment} - \o In Qt 4.3 and later, the alignment of the image image's position can be specified + \li \b{\c image-position} \target image-position-prop + \li \l{#Alignment}{alignment} + \li In Qt 4.3 and later, the alignment of the image image's position can be specified using relative or absolute position. \row - \o \bold{\c left} \target left-prop - \o \l{#Length}{Length} - \o If \l{#position-prop}{position} is \c relative (the + \li \b{\c left} \target left-prop + \li \l{#Length}{Length} + \li If \l{#position-prop}{position} is \c relative (the default), moves a \l{subcontrol} by a certain offset to the right. @@ -1996,9 +1996,9 @@ \l{#bottom-prop}{bottom}. \row - \o \bold{\c lineedit-password-character*} \target lineedit-password-character-prop - \o \l{#Number}{Number} - \o The QLineEdit password character as a Unicode number. + \li \b{\c lineedit-password-character*} \target lineedit-password-character-prop + \li \l{#Number}{Number} + \li The QLineEdit password character as a Unicode number. If this property is not specified, it defaults to the value specified by the current style for the @@ -2009,9 +2009,9 @@ \snippet doc/src/snippets/code/doc_src_stylesheet.qdoc 61 \row - \o \bold{\c margin} \target margin-prop - \o \l {Box Lengths} - \o The widget's margins. Equivalent to specifying \c + \li \b{\c margin} \target margin-prop + \li \l {Box Lengths} + \li The widget's margins. Equivalent to specifying \c margin-top, \c margin-right, \c margin-bottom, and \c margin-left. @@ -2031,29 +2031,29 @@ \l{#spacing-prop}{spacing}, and \l{The Box Model}. \row - \o \c margin-top - \o \l{#Length}{Length} - \o The widget's top margin. + \li \c margin-top + \li \l{#Length}{Length} + \li The widget's top margin. \row - \o \c margin-right - \o \l{#Length}{Length} - \o The widget's right margin. + \li \c margin-right + \li \l{#Length}{Length} + \li The widget's right margin. \row - \o \c margin-bottom - \o \l{#Length}{Length} - \o The widget's bottom margin. + \li \c margin-bottom + \li \l{#Length}{Length} + \li The widget's bottom margin. \row - \o \c margin-left - \o \l{#Length}{Length} - \o The widget's left margin. + \li \c margin-left + \li \l{#Length}{Length} + \li The widget's left margin. \row - \o \bold{\c max-height} \target max-height-prop - \o \l{#Length}{Length} - \o The widget's or a subcontrol's maximum height. + \li \b{\c max-height} \target max-height-prop + \li \l{#Length}{Length} + \li The widget's or a subcontrol's maximum height. This property is supported by QAbstractItemView subclasses, QAbstractSpinBox subclasses, QCheckBox, @@ -2071,9 +2071,9 @@ See also \l{#max-width-prop}{max-width}. \row - \o \bold{\c max-width} \target max-width-prop - \o \l{#Length}{Length} - \o The widget's or a subcontrol's maximum width. + \li \b{\c max-width} \target max-width-prop + \li \l{#Length}{Length} + \li The widget's or a subcontrol's maximum width. This property is supported by QAbstractItemView subclasses, QAbstractSpinBox subclasses, QCheckBox, @@ -2092,9 +2092,9 @@ \row - \o \bold{\c messagebox-text-interaction-flags*} \target messagebox-text-interaction-flags-prop - \o \l{#Number}{Number} - \o The interaction behavior for text in a message box. + \li \b{\c messagebox-text-interaction-flags*} \target messagebox-text-interaction-flags-prop + \li \l{#Number}{Number} + \li The interaction behavior for text in a message box. Possible values are based on Qt::TextInteractionFlags. If this property is not specified, it defaults to the @@ -2107,9 +2107,9 @@ \snippet doc/src/snippets/code/doc_src_stylesheet.qdoc 65 \row - \o \bold{\c min-height} \target min-height-prop - \o \l{#Length}{Length} - \o The widget's or a subcontrol's minimum height. + \li \b{\c min-height} \target min-height-prop + \li \l{#Length}{Length} + \li The widget's or a subcontrol's minimum height. This property is supported by QAbstractItemView subclasses, QAbstractSpinBox subclasses, QCheckBox, @@ -2130,9 +2130,9 @@ See also \l{#min-width-prop}{min-width}. \row - \o \bold{\c min-width} \target min-width-prop - \o \l{#Length}{Length} - \o The widget's or a subcontrol's minimum width. + \li \b{\c min-width} \target min-width-prop + \li \l{#Length}{Length} + \li The widget's or a subcontrol's minimum width. This property is supported by QAbstractItemView subclasses, QAbstractSpinBox subclasses, QCheckBox, @@ -2153,9 +2153,9 @@ See also \l{#min-height-prop}{min-height}. \row - \o \bold{\c opacity*} \target opacity-prop - \o \l{#Number}{Number} - \o The opacity for a widget. Possible values are from 0 + \li \b{\c opacity*} \target opacity-prop + \li \l{#Number}{Number} + \li The opacity for a widget. Possible values are from 0 (transparent) to 255 (opaque). For the moment, this is only supported for \l{QToolTip}{tooltips}. @@ -2168,9 +2168,9 @@ \snippet doc/src/snippets/code/doc_src_stylesheet.qdoc 68 \row - \o \bold{\c padding} \target padding-prop - \o \l{#Box Lengths}{Box Lengths} - \o The widget's padding. Equivalent to specifying \c + \li \b{\c padding} \target padding-prop + \li \l{#Box Lengths}{Box Lengths} + \li The widget's padding. Equivalent to specifying \c padding-top, \c padding-right, \c padding-bottom, and \c padding-left. @@ -2190,37 +2190,37 @@ \l{#spacing-prop}{spacing}, and \l{The Box Model}. \row - \o \c padding-top - \o \l{#Length}{Length} - \o The widget's top padding. + \li \c padding-top + \li \l{#Length}{Length} + \li The widget's top padding. \row - \o \c padding-right - \o \l{#Length}{Length} - \o The widget's right padding. + \li \c padding-right + \li \l{#Length}{Length} + \li The widget's right padding. \row - \o \c padding-bottom - \o \l{#Length}{Length} - \o The widget's bottom padding. + \li \c padding-bottom + \li \l{#Length}{Length} + \li The widget's bottom padding. \row - \o \c padding-left - \o \l{#Length}{Length} - \o The widget's left padding. + \li \c padding-left + \li \l{#Length}{Length} + \li The widget's left padding. \row - \o \bold{\c paint-alternating-row-colors-for-empty-area} + \li \b{\c paint-alternating-row-colors-for-empty-area} \target paint-alternating-row-colors-for-empty-area-prop - \o \c bool - \o Whether the QTreeView paints alternating row colors for the empty + \li \c bool + \li Whether the QTreeView paints alternating row colors for the empty area (i.e the area where there are no items) \row - \o \bold{\c position} \target position-prop - \o \c relative \BR + \li \b{\c position} \target position-prop + \li \c relative \BR | \c absolute - \o Whether offsets specified using \l{Qt Style Sheets Reference#left-prop}{left}, + \li Whether offsets specified using \l{Qt Style Sheets Reference#left-prop}{left}, \l{#right-prop}{right}, \l{Qt Style Sheets Reference#top-prop}{top}, and \l{#bottom-prop}{bottom} are relative or absolute coordinates. @@ -2229,9 +2229,9 @@ relative. \row - \o \bold{\c right} \target right-prop - \o \l{#Length}{Length} - \o If \l{#position-prop}{position} is \c relative (the + \li \b{\c right} \target right-prop + \li \l{#Length}{Length} + \li If \l{#position-prop}{position} is \c relative (the default), moves a \l{subcontrol} by a certain offset to the left; specifying \tt{right: \e{x}} is then equivalent to specifying \tt{\l{Qt Style Sheets Reference#left-prop}{left}: -\e{x}}. @@ -2249,9 +2249,9 @@ \l{#bottom-prop}{bottom}. \row - \o \bold{\c selection-background-color*} \target selection-background-color-prop - \o \l{#Brush}{Brush} \BR - \o The background of selected text or items. + \li \b{\c selection-background-color*} \target selection-background-color-prop + \li \l{#Brush}{Brush} \BR + \li The background of selected text or items. This property is supported by all widgets that respect the \l QWidget::palette and that show selection text. @@ -2268,9 +2268,9 @@ \l{Qt Style Sheets Reference#background-prop}{background}. \row - \o \bold{\c selection-color*} \target selection-color-prop - \o \l{#Brush}{Brush} \BR - \o The foreground of selected text or items. + \li \b{\c selection-color*} \target selection-color-prop + \li \l{#Brush}{Brush} \BR + \li The foreground of selected text or items. This property is supported by all widgets that respect the \l QWidget::palette and that show selection text. @@ -2288,9 +2288,9 @@ and \l{#color-prop}{color}. \row - \o \bold{\c show-decoration-selected*} \target show-decoration-selected-prop - \o \l{#Boolean}{Boolean} - \o Controls whether selections in a QListView cover the + \li \b{\c show-decoration-selected*} \target show-decoration-selected-prop + \li \l{#Boolean}{Boolean} + \li Controls whether selections in a QListView cover the entire row or just the extent of the text. If this property is not specified, it defaults to the @@ -2303,9 +2303,9 @@ \snippet doc/src/snippets/code/doc_src_stylesheet.qdoc 73 \row - \o \bold{\c spacing*} \target spacing-prop - \o \l{#Length}{Length} - \o Internal spacing in the widget. + \li \b{\c spacing*} \target spacing-prop + \li \l{#Length}{Length} + \li Internal spacing in the widget. This property is supported by QCheckBox, checkable \l{QGroupBox}es, QMenuBar, and QRadioButton. @@ -2321,9 +2321,9 @@ \l{#margin-prop}{margin}. \row - \o \bold{\c subcontrol-origin*} \target subcontrol-origin-prop - \o \l{#Origin}{Origin} - \o The origin rectangle of the \l subcontrol within the + \li \b{\c subcontrol-origin*} \target subcontrol-origin-prop + \li \l{#Origin}{Origin} + \li The origin rectangle of the \l subcontrol within the parent element. If this property is not specified, the default is \c @@ -2337,9 +2337,9 @@ \l{Qt Style Sheets Reference#subcontrol-position-prop}{subcontrol-position}. \row - \o \bold{\c subcontrol-position*} \target subcontrol-position-prop - \o \l{#Alignment}{Alignment} - \o The alignment of the \l subcontrol within the origin + \li \b{\c subcontrol-position*} \target subcontrol-position-prop + \li \l{#Alignment}{Alignment} + \li The alignment of the \l subcontrol within the origin rectangle specified by \l{Qt Style Sheets Reference#subcontrol-origin-prop} {subcontrol-origin}. @@ -2354,9 +2354,9 @@ \l{Qt Style Sheets Reference#subcontrol-origin-prop}{subcontrol-origin}. \row - \o \bold{\c text-align} \target text-align-prop - \o \l{#Alignment}{Alignment} - \o The alignment of text and icon within the contents of the widget. + \li \b{\c text-align} \target text-align-prop + \li \l{#Alignment}{Alignment} + \li The alignment of text and icon within the contents of the widget. If this value is not specified, it defaults to the value that depends on the native style. @@ -2369,17 +2369,17 @@ and QProgressBar. \row - \o \bold{\c text-decoration} - \o \c none \BR + \li \b{\c text-decoration} + \li \c none \BR \c underline \BR \c overline \BR \c line-through - \o Additional text effects + \li Additional text effects \row - \o \bold{\c top} \target top-prop - \o \l{#Length}{Length} - \o If \l{#position-prop}{position} is \c relative (the + \li \b{\c top} \target top-prop + \li \l{#Length}{Length} + \li If \l{#position-prop}{position} is \c relative (the default), moves a \l{subcontrol} by a certain offset down. @@ -2398,9 +2398,9 @@ \l{#bottom-prop}{bottom}. \row - \o \bold{\c width} \target width-prop - \o \l{#Length}{Length} - \o The width of a \l{subcontrol} (or a widget in some cases). + \li \b{\c width} \target width-prop + \li \l{#Length}{Length} + \li The width of a \l{subcontrol} (or a widget in some cases). If this property is not specified, it defaults to a value that depends on the subcontrol/widget and on the current style. @@ -2430,222 +2430,222 @@ \table 100% \header - \o Name - \o QStyle::StandardPixmap + \li Name + \li QStyle::StandardPixmap \row - \o backward-icon - \o QStyle::SP_ArrowBack + \li backward-icon + \li QStyle::SP_ArrowBack \row - \o cd-icon - \o QStyle::SP_DriveCDIcon + \li cd-icon + \li QStyle::SP_DriveCDIcon \row - \o computer-icon - \o QStyle::SP_ComputerIcon + \li computer-icon + \li QStyle::SP_ComputerIcon \row - \o desktop-icon - \o QStyle::SP_DesktopIcon + \li desktop-icon + \li QStyle::SP_DesktopIcon \row - \o dialog-apply-icon - \o QStyle::SP_DialogApplyButton + \li dialog-apply-icon + \li QStyle::SP_DialogApplyButton \row - \o dialog-cancel-icon - \o QStyle::SP_DialogCancelButton + \li dialog-cancel-icon + \li QStyle::SP_DialogCancelButton \row - \o dialog-close-icon - \o QStyle::SP_DialogCloseButton + \li dialog-close-icon + \li QStyle::SP_DialogCloseButton \row - \o dialog-discard-icon - \o QStyle::SP_DialogDiscardButton + \li dialog-discard-icon + \li QStyle::SP_DialogDiscardButton \row - \o dialog-help-icon - \o QStyle::SP_DialogHelpButton + \li dialog-help-icon + \li QStyle::SP_DialogHelpButton \row - \o dialog-no-icon - \o QStyle::SP_DialogNoButton + \li dialog-no-icon + \li QStyle::SP_DialogNoButton \row - \o dialog-ok-icon - \o QStyle::SP_DialogOkButton + \li dialog-ok-icon + \li QStyle::SP_DialogOkButton \row - \o dialog-open-icon - \o QStyle::SP_DialogOpenButton + \li dialog-open-icon + \li QStyle::SP_DialogOpenButton \row - \o dialog-reset-icon - \o QStyle::SP_DialogResetButton + \li dialog-reset-icon + \li QStyle::SP_DialogResetButton \row - \o dialog-save-icon - \o QStyle::SP_DialogSaveButton + \li dialog-save-icon + \li QStyle::SP_DialogSaveButton \row - \o dialog-yes-icon - \o QStyle::SP_DialogYesButton + \li dialog-yes-icon + \li QStyle::SP_DialogYesButton \row - \o directory-closed-icon - \o QStyle::SP_DirClosedIcon + \li directory-closed-icon + \li QStyle::SP_DirClosedIcon \row - \o directory-icon - \o QStyle::SP_DirIcon + \li directory-icon + \li QStyle::SP_DirIcon \row - \o directory-link-icon - \o QStyle::SP_DirLinkIcon + \li directory-link-icon + \li QStyle::SP_DirLinkIcon \row - \o directory-open-icon - \o QStyle::SP_DirOpenIcon + \li directory-open-icon + \li QStyle::SP_DirOpenIcon \row - \o dockwidget-close-icon - \o QStyle::SP_DockWidgetCloseButton + \li dockwidget-close-icon + \li QStyle::SP_DockWidgetCloseButton \row - \o downarrow-icon - \o QStyle::SP_ArrowDown + \li downarrow-icon + \li QStyle::SP_ArrowDown \row - \o dvd-icon - \o QStyle::SP_DriveDVDIcon + \li dvd-icon + \li QStyle::SP_DriveDVDIcon \row - \o file-icon - \o QStyle::SP_FileIcon + \li file-icon + \li QStyle::SP_FileIcon \row - \o file-link-icon - \o QStyle::SP_FileLinkIcon + \li file-link-icon + \li QStyle::SP_FileLinkIcon \omit \row - \o filedialog-backward-icon - \o QStyle::SP_FileDialogBack + \li filedialog-backward-icon + \li QStyle::SP_FileDialogBack \endomit \row - \o filedialog-contentsview-icon - \o QStyle::SP_FileDialogContentsView + \li filedialog-contentsview-icon + \li QStyle::SP_FileDialogContentsView \row - \o filedialog-detailedview-icon - \o QStyle::SP_FileDialogDetailedView + \li filedialog-detailedview-icon + \li QStyle::SP_FileDialogDetailedView \row - \o filedialog-end-icon - \o QStyle::SP_FileDialogEnd + \li filedialog-end-icon + \li QStyle::SP_FileDialogEnd \row - \o filedialog-infoview-icon - \o QStyle::SP_FileDialogInfoView + \li filedialog-infoview-icon + \li QStyle::SP_FileDialogInfoView \row - \o filedialog-listview-icon - \o QStyle::SP_FileDialogListView + \li filedialog-listview-icon + \li QStyle::SP_FileDialogListView \row - \o filedialog-new-directory-icon - \o QStyle::SP_FileDialogNewFolder + \li filedialog-new-directory-icon + \li QStyle::SP_FileDialogNewFolder \row - \o filedialog-parent-directory-icon - \o QStyle::SP_FileDialogToParent + \li filedialog-parent-directory-icon + \li QStyle::SP_FileDialogToParent \row - \o filedialog-start-icon - \o QStyle::SP_FileDialogStart + \li filedialog-start-icon + \li QStyle::SP_FileDialogStart \row - \o floppy-icon - \o QStyle::SP_DriveFDIcon + \li floppy-icon + \li QStyle::SP_DriveFDIcon \row - \o forward-icon - \o QStyle::SP_ArrowForward + \li forward-icon + \li QStyle::SP_ArrowForward \row - \o harddisk-icon - \o QStyle::SP_DriveHDIcon + \li harddisk-icon + \li QStyle::SP_DriveHDIcon \row - \o home-icon - \o QStyle::SP_DirHomeIcon + \li home-icon + \li QStyle::SP_DirHomeIcon \row - \o leftarrow-icon - \o QStyle::SP_ArrowLeft + \li leftarrow-icon + \li QStyle::SP_ArrowLeft \row - \o messagebox-critical-icon - \o QStyle::SP_MessageBoxCritical + \li messagebox-critical-icon + \li QStyle::SP_MessageBoxCritical \row - \o messagebox-information-icon - \o QStyle::SP_MessageBoxInformation + \li messagebox-information-icon + \li QStyle::SP_MessageBoxInformation \row - \o messagebox-question-icon - \o QStyle::SP_MessageBoxQuestion + \li messagebox-question-icon + \li QStyle::SP_MessageBoxQuestion \row - \o messagebox-warning-icon - \o QStyle::SP_MessageBoxWarning + \li messagebox-warning-icon + \li QStyle::SP_MessageBoxWarning \row - \o network-icon - \o QStyle::SP_DriveNetIcon + \li network-icon + \li QStyle::SP_DriveNetIcon \row - \o rightarrow-icon - \o QStyle::SP_ArrowRight + \li rightarrow-icon + \li QStyle::SP_ArrowRight \row - \o titlebar-contexthelp-icon - \o QStyle::SP_TitleBarContextHelpButton + \li titlebar-contexthelp-icon + \li QStyle::SP_TitleBarContextHelpButton \row - \o titlebar-maximize-icon - \o QStyle::SP_TitleBarMaxButton + \li titlebar-maximize-icon + \li QStyle::SP_TitleBarMaxButton \row - \o titlebar-menu-icon - \o QStyle::SP_TitleBarMenuButton + \li titlebar-menu-icon + \li QStyle::SP_TitleBarMenuButton \row - \o titlebar-minimize-icon - \o QStyle::SP_TitleBarMinButton + \li titlebar-minimize-icon + \li QStyle::SP_TitleBarMinButton \row - \o titlebar-normal-icon - \o QStyle::SP_TitleBarNormalButton + \li titlebar-normal-icon + \li QStyle::SP_TitleBarNormalButton \row - \o titlebar-shade-icon - \o QStyle::SP_TitleBarShadeButton + \li titlebar-shade-icon + \li QStyle::SP_TitleBarShadeButton \row - \o titlebar-unshade-icon - \o QStyle::SP_TitleBarUnshadeButton + \li titlebar-unshade-icon + \li QStyle::SP_TitleBarUnshadeButton \row - \o trash-icon - \o QStyle::SP_TrashIcon + \li trash-icon + \li QStyle::SP_TrashIcon \row - \o uparrow-icon - \o QStyle::SP_ArrowUp + \li uparrow-icon + \li QStyle::SP_ArrowUp \endtable @@ -2656,59 +2656,59 @@ \table 100% \header - \o Type - \o Syntax - \o Description + \li Type + \li Syntax + \li Description \row - \o \bold Alignment \target Alignment - \o \{ \c top \BR + \li \b Alignment \target Alignment + \li \{ \c top \BR | \c bottom \BR | \c left \BR | \c right \BR | \c center \}* - \o Horizontal and/or vertical alignment. + \li Horizontal and/or vertical alignment. Example: \snippet doc/src/snippets/code/doc_src_stylesheet.qdoc 80 \row - \o \bold Attachment \target Attachment - \o \{ \c scroll \BR + \li \b Attachment \target Attachment + \li \{ \c scroll \BR | \c fixed \}* - \o Scroll or fixed attachment. + \li Scroll or fixed attachment. \row - \o \bold Background \target Background - \o \{ \l{#Brush}{Brush} \BR + \li \b Background \target Background + \li \{ \l{#Brush}{Brush} \BR | \l{#Url}{Url} \BR | \l{#Repeat}{Repeat} \BR | \l{#Alignment}{Alignment} \}* - \o A sequence of \l{#Brush}{Brush}, \l{#Url}{Url}, + \li A sequence of \l{#Brush}{Brush}, \l{#Url}{Url}, \l{#Repeat}{Repeat}, and \l{#Alignment}{Alignment}. \row - \o \bold Boolean \target Boolean - \o 0 | 1 - \o True (\c 1) or false (\c 0). + \li \b Boolean \target Boolean + \li 0 | 1 + \li True (\c 1) or false (\c 0). Example: \snippet doc/src/snippets/code/doc_src_stylesheet.qdoc 81 \row - \o \bold Border \target Border - \o \{ \l{#Border Style}{Border Style} \BR + \li \b Border \target Border + \li \{ \l{#Border Style}{Border Style} \BR | \l{#Length}{Length} \BR | \l{#Brush}{Brush} \}* - \o Shorthand border property. + \li Shorthand border property. \row - \o \bold{Border Image} \target Border Image - \o \c none \BR + \li \b{Border Image} \target Border Image + \li \c none \BR | \l{Url} \l{Number}\{4\} \BR (\c stretch | \c repeat){0,2} - \o A border image is an image that is composed of nine parts + \li A border image is an image that is composed of nine parts (top left, top center, top right, center left, center, center right, bottom left, bottom center, and bottom right). When a border of a certain size is required, the @@ -2721,8 +2721,8 @@ {CSS3 Draft Specification} for details. \row - \o \bold{Border Style} \target Border Style - \o \c dashed \BR + \li \b{Border Style} \target Border Style + \li \c dashed \BR | \c dot-dash \BR | \c dot-dot-dash \BR | \c dotted \BR @@ -2733,14 +2733,14 @@ | \c ridge \BR | \c solid \BR | \c none - \o Specifies the pattern used to draw a border. + \li Specifies the pattern used to draw a border. See the \l{http://www.w3.org/TR/css3-background/#border-style} {CSS3 Draft Specification} for details. \row - \o \bold{Box Colors} \target Box Colors - \o \l{#Brush}{Brush}\{1,4\} - \o One to four occurrences of \l{#Brush}{Brush}, specifying the top, + \li \b{Box Colors} \target Box Colors + \li \l{#Brush}{Brush}\{1,4\} + \li One to four occurrences of \l{#Brush}{Brush}, specifying the top, right, bottom, and left edges of a box, respectively. If the left color is not specified, it is taken to be the same as the right color. If the bottom color is not @@ -2753,9 +2753,9 @@ \snippet doc/src/snippets/code/doc_src_stylesheet.qdoc 82 \row - \o \bold{Box Lengths} \target Box Lengths - \o \l{#Length}{Length}\{1,4\} - \o One to four occurrences of \l{#Length}{Length}, specifying the + \li \b{Box Lengths} \target Box Lengths + \li \l{#Length}{Length}\{1,4\} + \li One to four occurrences of \l{#Length}{Length}, specifying the top, right, bottom, and left edges of a box, respectively. If the left length is not specified, it is taken to be the same as the right length. If the bottom @@ -2768,21 +2768,21 @@ \snippet doc/src/snippets/code/doc_src_stylesheet.qdoc 83 \row - \o \bold{Brush} \target Brush - \o \l{#Color}{Color} \BR + \li \b{Brush} \target Brush + \li \l{#Color}{Color} \BR | \l{Gradient} \BR | \l{PaletteRole} - \o Specifies a Color or a Gradient or an entry in the Palette. + \li Specifies a Color or a Gradient or an entry in the Palette. \row - \o \bold{Color} \target Color - \o \tt{rgb(\e{r}, \e{g}, \e{b})} \BR + \li \b{Color} \target Color + \li \tt{rgb(\e{r}, \e{g}, \e{b})} \BR | \tt{rgba(\e{r}, \e{g}, \e{b}, \e{a})} \BR | \tt{hsv(\e{h}, \e{s}, \e{v})} \BR | \tt{hsva(\e{h}, \e{s}, \e{v}, \e{a})} \BR | \tt{#\e{rrggbb}} \BR | \l{QColor::setNamedColor()}{Color Name} \BR - \o Specifies a color as RGB (red, green, blue) or RGBA + \li Specifies a color as RGB (red, green, blue) or RGBA (red, green, blue, alpha) or HSV (hue, saturation, value) or HSVA (hue, saturation, value, alpha) or a named color. The \c rgb() or \c rgba() syntax can be used with integer values between 0 and 255, or with @@ -2798,45 +2798,45 @@ \l{http://www.w3.org/TR/CSS21/syndata.html#color-units}{here}. \row - \o \bold{Font} \target Font - \o (\l{#Font Style}{Font Style} | \l{#Font Weight}{Font Weight}){0,2} \l{#Font Size}{Font Size} String - \o Shorthand font property. + \li \b{Font} \target Font + \li (\l{#Font Style}{Font Style} | \l{#Font Weight}{Font Weight}){0,2} \l{#Font Size}{Font Size} String + \li Shorthand font property. \row - \o \bold{Font Size} \target Font Size - \o \l{Length} - \o The size of a font. + \li \b{Font Size} \target Font Size + \li \l{Length} + \li The size of a font. \row - \o \bold{Font Style} \target Font Style - \o \c normal \BR + \li \b{Font Style} \target Font Style + \li \c normal \BR | \c italic \BR | \c oblique - \o The style of a font. + \li The style of a font. \row - \o \bold{Font Weight} \target Font Weight - \o \c normal \BR + \li \b{Font Weight} \target Font Weight + \li \c normal \BR | \c bold \BR | \c 100 \BR | \c 200 \BR ... \BR | \c 900 - \o The weight of a font. + \li The weight of a font. \row - \o \bold{Gradient} \target Gradient - \o \c qlineargradient \BR + \li \b{Gradient} \target Gradient + \li \c qlineargradient \BR | \c qradialgradient \BR | \c qconicalgradient - \o Specifies gradient fills. There are three types of gradient fills: + \li Specifies gradient fills. There are three types of gradient fills: \list - \o \e{Linear} gradients interpolate colors between start and + \li \e{Linear} gradients interpolate colors between start and end points. - \o \e{Radial} gradients interpolate colors between a focal + \li \e{Radial} gradients interpolate colors between a focal point and end points on a circle surrounding it. - \o \e{Conical} gradients interpolate colors around a center + \li \e{Conical} gradients interpolate colors around a center point. \endlist @@ -2855,18 +2855,18 @@ \snippet doc/src/snippets/code/doc_src_stylesheet.qdoc 85 \row - \o \bold{Icon} \target Icon - \o (\l{#Url}{Url} (\c disabled | \c active | \c normal | \c selected)? + \li \b{Icon} \target Icon + \li (\l{#Url}{Url} (\c disabled | \c active | \c normal | \c selected)? (\c on | \c off)? )* - \o A list of url, QIcon::Mode and QIcon::State. + \li A list of url, QIcon::Mode and QIcon::State. Example: \snippet doc/src/snippets/code/doc_src_stylesheet.qdoc 86 \row - \o \bold{Length} \target Length - \o \l{#Number}{Number} (\c px | \c pt | \c em | \c ex)? - \o A number followed by a measurement unit. The CSS standard recommends + \li \b{Length} \target Length + \li \l{#Number}{Number} (\c px | \c pt | \c em | \c ex)? + \li A number followed by a measurement unit. The CSS standard recommends that user agents must \l{http://www.w3.org/TR/CSS21/syndata.html#illegalvalues}{ignore} a declaration with an illegal value. In Qt, it is mandatory to @@ -2875,32 +2875,32 @@ in most contexts. The supported units are: \list - \o \c px: pixels - \o \c pt: the size of one point (i.e., 1/72 of an inch) - \o \c em: the em width of the font (i.e., the width of 'M') - \o \c ex: the ex width of the font (i.e., the height of 'x') + \li \c px: pixels + \li \c pt: the size of one point (i.e., 1/72 of an inch) + \li \c em: the em width of the font (i.e., the width of 'M') + \li \c ex: the ex width of the font (i.e., the height of 'x') \endlist \row - \o \bold{Number} \target Number - \o A decimal integer or a real number - \o Examples: \c 0, \c 18, \c +127, \c -255, \c 12.34, \c -.5, + \li \b{Number} \target Number + \li A decimal integer or a real number + \li Examples: \c 0, \c 18, \c +127, \c -255, \c 12.34, \c -.5, \c 0009. \row - \o \bold{Origin} \target Origin - \o \c margin \BR + \li \b{Origin} \target Origin + \li \c margin \BR | \c border \BR | \c padding \BR | \c content - \o Indicates which of four rectangles to use. + \li Indicates which of four rectangles to use. \list - \o \c margin: The margin rectangle. The margin falls outside the border. - \o \c border: The border rectangle. This is where any border is drawn. - \o \c padding: The padding rectangle. Unlike the margins, + \li \c margin: The margin rectangle. The margin falls outside the border. + \li \c border: The border rectangle. This is where any border is drawn. + \li \c padding: The padding rectangle. Unlike the margins, padding is located inside the border. - \o \c content: The content rectangle. This specifies where + \li \c content: The content rectangle. This specifies where the actual contents go, excluding any padding, border, or margin. \endlist @@ -2908,8 +2908,8 @@ See also \l{The Box Model}. \row - \o \bold{PaletteRole} \target PaletteRole - \o \c alternate-base \BR + \li \b{PaletteRole} \target PaletteRole + \li \c alternate-base \BR | \c base \BR | \c bright-text \BR | \c button \BR @@ -2926,40 +2926,40 @@ | \c text \BR | \c window \BR | \c window-text \BR - \o These values correspond the \l{QPalette::ColorRole}{Color roles} + \li These values correspond the \l{QPalette::ColorRole}{Color roles} in the widget's QPalette. For example, \snippet doc/src/snippets/code/doc_src_stylesheet.qdoc 87 \row - \o \bold{Radius} \target Radius - \o \l{#Length}{Length}\{1, 2\} - \o One or two occurrences of \l{#Length}{Length}. If only one length is + \li \b{Radius} \target Radius + \li \l{#Length}{Length}\{1, 2\} + \li One or two occurrences of \l{#Length}{Length}. If only one length is specified, it is used as the radius of the quarter circle defining the corner. If two lengths are specified, the first length is the horizontal radius of a quarter ellipse, whereas the second length is the vertical radius. \row - \o \bold{Repeat} \target Repeat - \o \c repeat-x \BR + \li \b{Repeat} \target Repeat + \li \c repeat-x \BR | \c repeat-y \BR | \c repeat \BR | \c no-repeat - \o A value indicating the nature of repetition. + \li A value indicating the nature of repetition. \list - \o \c repeat-x: Repeat horizontally. - \o \c repeat-y: Repeat vertically. - \o \c repeat: Repeat horizontally and vertically. - \o \c no-repeat: Don't repeat. + \li \c repeat-x: Repeat horizontally. + \li \c repeat-y: Repeat vertically. + \li \c repeat: Repeat horizontally and vertically. + \li \c no-repeat: Don't repeat. \endlist \row - \o \bold{Url} \target Url - \o \tt{url(\e{filename})} - \o \tt{\e{filename}} is the name of a file on the local disk + \li \b{Url} \target Url + \li \tt{url(\e{filename})} + \li \tt{\e{filename}} is the name of a file on the local disk or stored using \l{the Qt Resource System}. Setting an image implicitly sets the width and height of the element. @@ -2971,218 +2971,218 @@ \table 100% \header - \o Pseudo-State - \o Description + \li Pseudo-State + \li Description - \row \o \c :active \target active - \o This state is set when the widget resides in an active window. + \row \li \c :active \target active + \li This state is set when the widget resides in an active window. \row - \o \c :adjoins-item \target adjoins-item-ps - \o This state is set when the \l{#branch-sub}{::branch} of a QTreeView + \li \c :adjoins-item \target adjoins-item-ps + \li This state is set when the \l{#branch-sub}{::branch} of a QTreeView is adjacent to an item. \row - \o \c :alternate \target alternate-ps - \o This state is set for every alternate row whe painting the row of + \li \c :alternate \target alternate-ps + \li This state is set for every alternate row whe painting the row of a QAbstractItemView when QAbstractItemView::alternatingRowColors() is set to true. \row - \o \c :bottom \target bottom-ps - \o The item is positioned at the bottom. For example, a QTabBar + \li \c :bottom \target bottom-ps + \li The item is positioned at the bottom. For example, a QTabBar that has its tabs positioned at the bottom. \row - \o \c :checked \target checked-ps - \o The item is checked. For example, the + \li \c :checked \target checked-ps + \li The item is checked. For example, the \l{QAbstractButton::checked}{checked} state of QAbstractButton. \row - \o \c :closable \target closable-ps - \o The items can be closed. For example, the QDockWidget has the + \li \c :closable \target closable-ps + \li The items can be closed. For example, the QDockWidget has the QDockWidget::DockWidgetClosable feature turned on. \row - \o \c :closed \target closed-ps - \o The item is in the closed state. For example, an non-expanded + \li \c :closed \target closed-ps + \li The item is in the closed state. For example, an non-expanded item in a QTreeView \row - \o \c :default \target default-ps - \o The item is the default. For example, a + \li \c :default \target default-ps + \li The item is the default. For example, a \l{QPushButton::default}{default} QPushButton or a default action in a QMenu. \row - \o \c :disabled \target disabled-ps - \o The item is \l{QWidget::enabled}{disabled}. + \li \c :disabled \target disabled-ps + \li The item is \l{QWidget::enabled}{disabled}. \row - \o \c :editable \target editable-ps - \o The QComboBox is editable. + \li \c :editable \target editable-ps + \li The QComboBox is editable. \row - \o \c :edit-focus \target edit-focus-ps - \o The item has edit focus (See QStyle::State_HasEditFocus). This state + \li \c :edit-focus \target edit-focus-ps + \li The item has edit focus (See QStyle::State_HasEditFocus). This state is available only for Qt Extended applications. \row - \o \c :enabled \target enabled-ps - \o The item is \l{QWidget::enabled}{enabled}. + \li \c :enabled \target enabled-ps + \li The item is \l{QWidget::enabled}{enabled}. \row - \o \c :exclusive \target exclusive-ps - \o The item is part of an exclusive item group. For example, a menu + \li \c :exclusive \target exclusive-ps + \li The item is part of an exclusive item group. For example, a menu item in a exclusive QActionGroup. \row - \o \c :first \target first-ps - \o The item is the first (in a list). For example, the first + \li \c :first \target first-ps + \li The item is the first (in a list). For example, the first tab in a QTabBar. \row - \o \c :flat \target flat-ps - \o The item is flat. For example, a + \li \c :flat \target flat-ps + \li The item is flat. For example, a \l{QPushButton::flat}{flat} QPushButton. \row - \o \c :floatable \target floatable-ps - \o The items can be floated. For example, the QDockWidget has the + \li \c :floatable \target floatable-ps + \li The items can be floated. For example, the QDockWidget has the QDockWidget::DockWidgetFloatable feature turned on. \row - \o \c :focus \target focus-ps - \o The item has \l{QWidget::hasFocus()}{input focus}. + \li \c :focus \target focus-ps + \li The item has \l{QWidget::hasFocus()}{input focus}. \row - \o \c :has-children \target has-children-ps - \o The item has children. For example, an item in a + \li \c :has-children \target has-children-ps + \li The item has children. For example, an item in a QTreeView that has child items. \row - \o \c :has-siblings \target has-siblings-ps - \o The item has siblings. For example, an item in a + \li \c :has-siblings \target has-siblings-ps + \li The item has siblings. For example, an item in a QTreeView that siblings. \row - \o \c :horizontal \target horizontal-ps - \o The item has horizontal orientation + \li \c :horizontal \target horizontal-ps + \li The item has horizontal orientation \row - \o \c :hover \target hover-ps - \o The mouse is hovering over the item. + \li \c :hover \target hover-ps + \li The mouse is hovering over the item. \row - \o \c :indeterminate \target indeterminate-ps - \o The item has indeterminate state. For example, a QCheckBox + \li \c :indeterminate \target indeterminate-ps + \li The item has indeterminate state. For example, a QCheckBox or QRadioButton is \l{Qt::PartiallyChecked}{partially checked}. \row - \o \c :last \target last-ps - \o The item is the last (in a list). For example, the last + \li \c :last \target last-ps + \li The item is the last (in a list). For example, the last tab in a QTabBar. \row - \o \c :left \target left-ps - \o The item is positioned at the left. For example, a QTabBar + \li \c :left \target left-ps + \li The item is positioned at the left. For example, a QTabBar that has its tabs positioned at the left. \row - \o \c :maximized \target maximized-ps - \o The item is maximized. For example, a maximized QMdiSubWindow. + \li \c :maximized \target maximized-ps + \li The item is maximized. For example, a maximized QMdiSubWindow. \row - \o \c :middle \target middle-ps - \o The item is in the middle (in a list). For example, a tab + \li \c :middle \target middle-ps + \li The item is in the middle (in a list). For example, a tab that is not in the beginning or the end in a QTabBar. \row - \o \c :minimized \target minimized-ps - \o The item is minimized. For example, a minimized QMdiSubWindow. + \li \c :minimized \target minimized-ps + \li The item is minimized. For example, a minimized QMdiSubWindow. \row - \o \c :movable \target movable-ps - \o The item can be moved around. For example, the QDockWidget has the + \li \c :movable \target movable-ps + \li The item can be moved around. For example, the QDockWidget has the QDockWidget::DockWidgetMovable feature turned on. \row - \o \c :no-frame \target no-frame-ps - \o The item has no frame. For example, a frameless QSpinBox + \li \c :no-frame \target no-frame-ps + \li The item has no frame. For example, a frameless QSpinBox or QLineEdit. \row - \o \c :non-exclusive \target non-exclusive-ps - \o The item is part of a non-exclusive item group. For example, a menu + \li \c :non-exclusive \target non-exclusive-ps + \li The item is part of a non-exclusive item group. For example, a menu item in a non-exclusive QActionGroup. \row - \o \c :off \target off-ps - \o For items that can be toggled, this applies to items + \li \c :off \target off-ps + \li For items that can be toggled, this applies to items in the "off" state. \row - \o \c :on \target on-ps - \o For items that can be toggled, this applies to widgets + \li \c :on \target on-ps + \li For items that can be toggled, this applies to widgets in the "on" state. \row - \o \c :only-one \target only-one-ps - \o The item is the only one (in a list). For example, a lone tab + \li \c :only-one \target only-one-ps + \li The item is the only one (in a list). For example, a lone tab in a QTabBar. \row - \o \c :open \target open-ps - \o The item is in the open state. For example, an expanded + \li \c :open \target open-ps + \li The item is in the open state. For example, an expanded item in a QTreeView, or a QComboBox or QPushButton with an open menu. \row - \o \c :next-selected \target next-selected-ps - \o The next item (in a list) is selected. For example, the + \li \c :next-selected \target next-selected-ps + \li The next item (in a list) is selected. For example, the selected tab of a QTabBar is next to this item. \row - \o \c :pressed \target pressed-ps - \o The item is being pressed using the mouse. + \li \c :pressed \target pressed-ps + \li The item is being pressed using the mouse. \row - \o \c :previous-selected \target previous-selected-ps - \o The previous item (in a list) is selected. For example, a + \li \c :previous-selected \target previous-selected-ps + \li The previous item (in a list) is selected. For example, a tab in a QTabBar that is next to the selected tab. \row - \o \c :read-only \target read-only-ps - \o The item is marked read only or non-editable. For example, + \li \c :read-only \target read-only-ps + \li The item is marked read only or non-editable. For example, a read only QLineEdit or a non-editable QComboBox. \row - \o \c :right \target right-ps - \o The item is positioned at the right. For example, a QTabBar + \li \c :right \target right-ps + \li The item is positioned at the right. For example, a QTabBar that has its tabs positioned at the right. \row - \o \c :selected \target selected-ps - \o The item is selected. For example, the selected tab in + \li \c :selected \target selected-ps + \li The item is selected. For example, the selected tab in a QTabBar or the selected item in a QMenu. \row - \o \c :top \target top-ps - \o The item is positioned at the top. For example, a QTabBar + \li \c :top \target top-ps + \li The item is positioned at the top. For example, a QTabBar that has its tabs positioned at the top. \row - \o \c :unchecked \target unchecked-ps - \o The item is + \li \c :unchecked \target unchecked-ps + \li The item is \l{QAbstractButton::checked}{unchecked}. \row - \o \c :vertical \target vertical-ps - \o The item has vertical orientation. + \li \c :vertical \target vertical-ps + \li The item has vertical orientation. \row - \o \c :window \target window-ps - \o The widget is a window (i.e top level widget) + \li \c :window \target window-ps + \li The widget is a window (i.e top level widget) \endtable @@ -3193,162 +3193,162 @@ \table 100% \header - \o Sub-Control - \o Description + \li Sub-Control + \li Description \row - \o \c ::add-line \target add-line-sub - \o The button to add a line of a QScrollBar. + \li \c ::add-line \target add-line-sub + \li The button to add a line of a QScrollBar. \row - \o \c ::add-page \target add-page-sub - \o The region between the handle (slider) and the \l{#add-line-sub}{add-line} + \li \c ::add-page \target add-page-sub + \li The region between the handle (slider) and the \l{#add-line-sub}{add-line} of a QScrollBar. \row - \o \c ::branch \target branch-sub - \o The branch indicator of a QTreeView. + \li \c ::branch \target branch-sub + \li The branch indicator of a QTreeView. \row - \o \c ::chunk \target chunk-sub - \o The progress chunk of a QProgressBar. + \li \c ::chunk \target chunk-sub + \li The progress chunk of a QProgressBar. \row - \o \c ::close-button \target close-button-sub - \o The close button of a QDockWidget or tabs of QTabBar + \li \c ::close-button \target close-button-sub + \li The close button of a QDockWidget or tabs of QTabBar \row - \o \c ::corner \target corner-sub - \o The corner between two scrollbars in a QAbstractScrollArea + \li \c ::corner \target corner-sub + \li The corner between two scrollbars in a QAbstractScrollArea \row - \o \c ::down-arrow \target down-arrow-sub - \o The down arrow of a QComboBox, QHeaderView (sort indicator), + \li \c ::down-arrow \target down-arrow-sub + \li The down arrow of a QComboBox, QHeaderView (sort indicator), QScrollBar or QSpinBox. \row - \o \c ::down-button \target down-button-sub - \o The down button of a QScrollBar or a QSpinBox. + \li \c ::down-button \target down-button-sub + \li The down button of a QScrollBar or a QSpinBox. \row - \o \c ::drop-down \target drop-down-sub - \o The drop-down button of a QComboBox. + \li \c ::drop-down \target drop-down-sub + \li The drop-down button of a QComboBox. \row - \o \c ::float-button \target float-button-sub - \o The float button of a QDockWidget + \li \c ::float-button \target float-button-sub + \li The float button of a QDockWidget \row - \o \c ::groove \target groove-sub - \o The groove of a QSlider. + \li \c ::groove \target groove-sub + \li The groove of a QSlider. \row - \o \c ::indicator \target indicator-sub - \o The indicator of a QAbstractItemView, a QCheckBox, a QRadioButton, + \li \c ::indicator \target indicator-sub + \li The indicator of a QAbstractItemView, a QCheckBox, a QRadioButton, a checkable QMenu item or a checkable QGroupBox. \row - \o \c ::handle \target handle-sub - \o The handle (slider) of a QScrollBar, a QSplitter, or a QSlider. + \li \c ::handle \target handle-sub + \li The handle (slider) of a QScrollBar, a QSplitter, or a QSlider. \row - \o \c ::icon \target icon-sub - \o The icon of a QAbstractItemView or a QMenu. + \li \c ::icon \target icon-sub + \li The icon of a QAbstractItemView or a QMenu. \row - \o \c ::item \target item-sub - \o An item of a QAbstractItemView, a QMenuBar, a QMenu, or + \li \c ::item \target item-sub + \li An item of a QAbstractItemView, a QMenuBar, a QMenu, or a QStatusBar. \row - \o \c ::left-arrow \target left-arrow-sub - \o The left arrow of a QScrollBar. + \li \c ::left-arrow \target left-arrow-sub + \li The left arrow of a QScrollBar. \row - \o \c ::left-corner \target left-corner-sub - \o The left corner of a QTabWidget. For example, this control can be + \li \c ::left-corner \target left-corner-sub + \li The left corner of a QTabWidget. For example, this control can be used to control position the left corner widget in a QTabWidget. \row - \o \c ::menu-arrow \target menu-arrow-sub - \o The arrow of a QToolButton with a menu. + \li \c ::menu-arrow \target menu-arrow-sub + \li The arrow of a QToolButton with a menu. \row - \o \c ::menu-button \target menu-button-sub - \o The menu button of a QToolButton. + \li \c ::menu-button \target menu-button-sub + \li The menu button of a QToolButton. \row - \o \c ::menu-indicator \target menu-indicator-sub - \o The menu indicator of a QPushButton. + \li \c ::menu-indicator \target menu-indicator-sub + \li The menu indicator of a QPushButton. \row - \o \c ::right-arrow \target right-arrow-sub - \o The right arrow of a QMenu or a QScrollBar. + \li \c ::right-arrow \target right-arrow-sub + \li The right arrow of a QMenu or a QScrollBar. \row - \o \c ::pane \target pane-sub - \o The pane (frame) of a QTabWidget. + \li \c ::pane \target pane-sub + \li The pane (frame) of a QTabWidget. \row - \o \c ::right-corner \target right-corner-sub - \o The right corner of a QTabWidget. For example, this control can be + \li \c ::right-corner \target right-corner-sub + \li The right corner of a QTabWidget. For example, this control can be used to control the position the right corner widget in a QTabWidget. \row - \o \c ::scroller \target scroller-sub - \o The scroller of a QMenu or QTabBar. + \li \c ::scroller \target scroller-sub + \li The scroller of a QMenu or QTabBar. \row - \o \c ::section \target section-sub - \o The section of a QHeaderView. + \li \c ::section \target section-sub + \li The section of a QHeaderView. \row - \o \c ::separator \target separator-sub - \o The separator of a QMenu or in a QMainWindow. + \li \c ::separator \target separator-sub + \li The separator of a QMenu or in a QMainWindow. \row - \o \c ::sub-line \target sub-line-sub - \o The button to subtract a line of a QScrollBar. + \li \c ::sub-line \target sub-line-sub + \li The button to subtract a line of a QScrollBar. \row - \o \c ::sub-page \target sub-page-sub - \o The region between the handle (slider) and the \l{#sub-line-sub}{sub-line} + \li \c ::sub-page \target sub-page-sub + \li The region between the handle (slider) and the \l{#sub-line-sub}{sub-line} of a QScrollBar. \row - \o \c ::tab \target tab-sub - \o The tab of a QTabBar or QToolBox. + \li \c ::tab \target tab-sub + \li The tab of a QTabBar or QToolBox. \row - \o \c ::tab-bar \target tab-bar-sub - \o The tab bar of a QTabWidget. This subcontrol exists only to + \li \c ::tab-bar \target tab-bar-sub + \li The tab bar of a QTabWidget. This subcontrol exists only to control the position of the QTabBar inside the QTabWidget. To style the tabs using the \l{#tab-sub}{::tab} subcontrol. \row - \o \c ::tear \target tear-sub - \o The tear indicator of a QTabBar. + \li \c ::tear \target tear-sub + \li The tear indicator of a QTabBar. \row - \o \c ::tearoff \target tearoff-sub - \o The tear-off indicator of a QMenu. + \li \c ::tearoff \target tearoff-sub + \li The tear-off indicator of a QMenu. \row - \o \c ::text \target text-ps - \o The text of a QAbstractItemView. + \li \c ::text \target text-ps + \li The text of a QAbstractItemView. \row - \o \c ::title \target title-sub - \o The title of a QGroupBox or a QDockWidget. + \li \c ::title \target title-sub + \li The title of a QGroupBox or a QDockWidget. \row - \o \c ::up-arrow \target up-arrow-sub - \o The up arrow of a QHeaderView (sort indicator), QScrollBar + \li \c ::up-arrow \target up-arrow-sub + \li The up arrow of a QHeaderView (sort indicator), QScrollBar or a QSpinBox. \row - \o \c ::up-button \target up-button-sub - \o The up button of a QSpinBox. + \li \c ::up-button \target up-button-sub + \li The up button of a QSpinBox. \endtable @@ -3441,11 +3441,11 @@ What happened is this: \list - \o We have made a request that cannot be satisfied using the + \li We have made a request that cannot be satisfied using the native styles alone (e.g., the Windows XP theme engine doesn't let us specify the background color of a button). - \o Therefore, the button is rendered using style sheets. - \o We haven't specified any values for + \li Therefore, the button is rendered using style sheets. + \li We haven't specified any values for \l{Qt Style Sheets Reference#border-width-prop}{border-width} and \l{Qt Style Sheets Reference#border-style-prop}{border-style}, so by default we obtain a 0-pixel wide border of style \c none. @@ -3836,18 +3836,18 @@ There are three types of QToolButtons. \list - \i The QToolButton has no menu. In this case, the QToolButton is styled + \li The QToolButton has no menu. In this case, the QToolButton is styled exactly like QPushButton. See \l{#Customizing QPushButton}{Customizing QPushButton} for an example. - \i The QToolButton has a menu and has the QToolButton::popupMode set to + \li The QToolButton has a menu and has the QToolButton::popupMode set to QToolButton::DelayedPopup or QToolButton::InstantPopup. In this case, the QToolButton is styled exactly like a QPushButton with a menu. See \l{#Customizing QPushButton}{Customizing QPushButton} for an example of the usage of the menu-indicator pseudo state. - \i The QToolButton has its QToolButton::popupMode set to + \li The QToolButton has its QToolButton::popupMode set to QToolButton::MenuButtonPopup. In this case, we style it as follows: \endlist @@ -3885,17 +3885,17 @@ \table \row - \o \inlineimage stylesheet-vline.png - \o \inlineimage stylesheet-branch-more.png - \o \inlineimage stylesheet-branch-end.png - \o \inlineimage stylesheet-branch-closed.png - \o \inlineimage stylesheet-branch-open.png - \row - \o vline.png - \o branch-more.png - \o branch-end.png - \o branch-closed.png - \o branch-open.png + \li \inlineimage stylesheet-vline.png + \li \inlineimage stylesheet-branch-more.png + \li \inlineimage stylesheet-branch-end.png + \li \inlineimage stylesheet-branch-closed.png + \li \inlineimage stylesheet-branch-open.png + \row + \li vline.png + \li branch-more.png + \li branch-end.png + \li branch-closed.png + \li branch-open.png \endtable \snippet doc/src/snippets/code/doc_src_stylesheet.qdoc 158 @@ -3948,16 +3948,16 @@ \table \row - \o \inlineimage stylesheet-border-image-stretched.png + \li \inlineimage stylesheet-border-image-stretched.png \row - \o With borders + \li With borders \endtable \table \row - \o \inlineimage stylesheet-border-image-wrong.png + \li \inlineimage stylesheet-border-image-wrong.png \row - \o Without borders + \li Without borders \endtable */ diff --git a/doc/src/widgets/widgets-and-layouts/widgets.qdoc b/doc/src/widgets/widgets-and-layouts/widgets.qdoc index a84f12e70f..e80b0fbec0 100644 --- a/doc/src/widgets/widgets-and-layouts/widgets.qdoc +++ b/doc/src/widgets/widgets-and-layouts/widgets.qdoc @@ -58,8 +58,8 @@ \table \row - \o \image qgridlayout-with-5-children.png - \o \image qformlayout-with-6-children.png + \li \image qgridlayout-with-5-children.png + \li \image qformlayout-with-6-children.png \endtable \l{Qt Designer Manual}{\QD} is a powerful tool for interactively creating and @@ -74,9 +74,9 @@ \table \row - \o \image windowsxp-tabwidget.png - \o \image plastique-tabwidget.png - \o \image macintosh-tabwidget.png + \li \image windowsxp-tabwidget.png + \li \image plastique-tabwidget.png + \li \image macintosh-tabwidget.png \endtable \l{Qt Style Sheets} are a powerful mechanism that allows you to customize the @@ -94,13 +94,13 @@ \table \row - \o \image windows-label.png - \o \image windowsvista-pushbutton.png - \o \image gtk-progressbar.png + \li \image windows-label.png + \li \image windowsvista-pushbutton.png + \li \image gtk-progressbar.png \row - \o \image plastique-combobox.png - \o \image macintosh-radiobutton.png - \o \image cde-lineedit.png + \li \image plastique-combobox.png + \li \image macintosh-radiobutton.png + \li \image cde-lineedit.png \endtable \annotatedlist basicwidgets @@ -112,17 +112,17 @@ \table \row - \o \image windowsxp-treeview.png - \o \image gtk-calendarwidget.png - \o \image qundoview.png + \li \image windowsxp-treeview.png + \li \image gtk-calendarwidget.png + \li \image qundoview.png \endtable \annotatedlist advanced \table \row - \o \image windowsvista-tabwidget.png - \o \image macintosh-groupbox.png + \li \image windowsvista-tabwidget.png + \li \image macintosh-groupbox.png \endtable \section2 Organizer Widgets diff --git a/doc/src/widgets/widgets-tutorial.qdoc b/doc/src/widgets/widgets-tutorial.qdoc index 1d010651e5..735a7ebc54 100644 --- a/doc/src/widgets/widgets-tutorial.qdoc +++ b/doc/src/widgets/widgets-tutorial.qdoc @@ -78,13 +78,13 @@ the \c main() function. \list - \o \l {tutorials/widgets/toplevel} {Creating a window} + \li \l {tutorials/widgets/toplevel} {Creating a window} - \o \l {tutorials/widgets/childwidget} {Creating child widgets} + \li \l {tutorials/widgets/childwidget} {Creating child widgets} - \o \l {tutorials/widgets/windowlayout} {Using layouts} + \li \l {tutorials/widgets/windowlayout} {Using layouts} - \o \l {tutorials/widgets/nestedlayouts} {Nested layouts} + \li \l {tutorials/widgets/nestedlayouts} {Nested layouts} \endlist \section1 Real world widget examples @@ -103,14 +103,14 @@ \list 1 - \o From a command prompt, enter the directory containing the + \li From a command prompt, enter the directory containing the example you have modified. - \o Type \c qmake and press \key{Return}. If this doesn't work, + \li Type \c qmake and press \key{Return}. If this doesn't work, make sure that the executable is on your path, or enter its full location. - \o On Linux/Unix and Mac OS X, type \c make and press + \li On Linux/Unix and Mac OS X, type \c make and press \key{Return}; on Windows with Visual Studio, type \c nmake and press \key{Return}. @@ -137,8 +137,8 @@ \div {class="qt-code"} \table \row - \o \snippet tutorials/widgets/toplevel/main.cpp main program - \o \inlineimage widgets-tutorial-toplevel.png + \li \snippet tutorials/widgets/toplevel/main.cpp main program + \li \inlineimage widgets-tutorial-toplevel.png \endtable \enddiv @@ -159,8 +159,8 @@ \div {class="qt-code"} \table \row - \o \snippet tutorials/widgets/childwidget/main.cpp main program - \o \inlineimage widgets-tutorial-childwidget.png + \li \snippet tutorials/widgets/childwidget/main.cpp main program + \li \inlineimage widgets-tutorial-childwidget.png \endtable \enddiv @@ -181,8 +181,8 @@ \div {class="qt-code"} \table \row - \o \snippet tutorials/widgets/windowlayout/main.cpp main program - \o \inlineimage widgets-tutorial-windowlayout.png + \li \snippet tutorials/widgets/windowlayout/main.cpp main program + \li \inlineimage widgets-tutorial-windowlayout.png \endtable \enddiv @@ -219,9 +219,9 @@ \div {class="qt-code"} \table \row - \o \snippet tutorials/widgets/nestedlayouts/main.cpp first part + \li \snippet tutorials/widgets/nestedlayouts/main.cpp first part \snippet tutorials/widgets/nestedlayouts/main.cpp last part - \o \inlineimage widgets-tutorial-nestedlayouts.png + \li \inlineimage widgets-tutorial-nestedlayouts.png \endtable \enddiv diff --git a/doc/src/widgets/windows-and-dialogs/mainwindow.qdoc b/doc/src/widgets/windows-and-dialogs/mainwindow.qdoc index 1517116c05..3a2efb06a2 100644 --- a/doc/src/widgets/windows-and-dialogs/mainwindow.qdoc +++ b/doc/src/widgets/windows-and-dialogs/mainwindow.qdoc @@ -94,13 +94,13 @@ most common usage transparently. \list - \o \bold{Including the window frame:} + \li \b{Including the window frame:} \l{QWidget::x()}{x()}, \l{QWidget::y()}{y()}, \l{QWidget::frameGeometry()}{frameGeometry()}, \l{QWidget::pos()}{pos()}, and \l{QWidget::move()}{move()}. - \o \bold{Excluding the window frame:} + \li \b{Excluding the window frame:} \l{QWidget::geometry()}{geometry()}, \l{QWidget::width()}{width()}, \l{QWidget::height()}{height()}, @@ -169,17 +169,17 @@ associated user interface components: \list - \o QMainWindow remains the central class around which applications + \li QMainWindow remains the central class around which applications can be built. The interface to this class has been simplified, and much of the functionality previously included in this class is now present in the companion QDockWidget and QToolBar classes. - \o QDockWidget provides a widget that can be used to create + \li QDockWidget provides a widget that can be used to create detachable tool palettes or helper windows. Dock widgets keep track of their own properties, and they can be moved, closed, and floated as external windows. - \o QToolBar provides a generic toolbar widget that can hold a + \li QToolBar provides a generic toolbar widget that can hold a number of different action-related widgets, such as buttons, drop-down menus, comboboxes, and spin boxes. The emphasis on a unified action model in Qt 4 means that toolbars cooperate well |