              
QListWidgetItem Class Reference |
| enum | ItemType { Type, UserType } |
Public Functions
| QListWidgetItem ( QListWidget * parent = 0, int type = Type ) | |
| QListWidgetItem ( const QString & text, QListWidget * parent = 0, int type = Type ) | |
| QListWidgetItem ( const QIcon & icon, const QString & text, QListWidget * parent = 0, int type = Type ) | |
| QListWidgetItem ( const QListWidgetItem & other ) | |
| virtual | ~QListWidgetItem () |
| QBrush | background () const |
| Qt::CheckState | checkState () const |
| virtual QListWidgetItem * | clone () const |
| virtual QVariant | data ( int role ) const |
| Qt::ItemFlags | flags () const |
| QFont | font () const |
| QBrush | foreground () const |
| QIcon | icon () const |
| bool | isHidden () const |
| bool | isSelected () const |
| QListWidget * | listWidget () const |
| virtual void | read ( QDataStream & in ) |
| void | setBackground ( const QBrush & brush ) |
| void | setCheckState ( Qt::CheckState state ) |
| virtual void | setData ( int role, const QVariant & value ) |
| void | setFlags ( Qt::ItemFlags flags ) |
| void | setFont ( const QFont & font ) |
| void | setForeground ( const QBrush & brush ) |
| void | setHidden ( bool hide ) |
| void | setIcon ( const QIcon & icon ) |
| void | setSelected ( bool select ) |
| void | setSizeHint ( const QSize & size ) |
| void | setStatusTip ( const QString & statusTip ) |
| void | setText ( const QString & text ) |
| void | setTextAlignment ( int alignment ) |
| void | setToolTip ( const QString & toolTip ) |
| void | setWhatsThis ( const QString & whatsThis ) |
| QSize | sizeHint () const |
| QString | statusTip () const |
| QString | text () const |
| int | textAlignment () const |
| QString | toolTip () const |
| int | type () const |
| QString | whatsThis () const |
| virtual void | write ( QDataStream & out ) const |
| virtual bool | operator< ( const QListWidgetItem & other ) const |
| QListWidgetItem & | operator= ( const QListWidgetItem & other ) |
Related Non-Members
| QDataStream & | operator<< ( QDataStream & out, const QListWidgetItem & item ) |
| QDataStream & | operator>> ( QDataStream & in, QListWidgetItem & item ) |
Detailed Description
The QListWidgetItem class provides an item for use with the QListWidget item view class.
A QListWidgetItem represents a single item in a QListWidget. Each item can hold several pieces of information, and will display them appropriately.
The item view convenience classes use a classic item-based interface rather than a pure model/view approach. For a more flexible list view widget, consider using the QListView class with a standard model.
List items can be inserted automatically into a list, when they are constructed, by specifying the list widget:
new QListWidgetItem(tr("Hazel"), listWidget);
Alternatively, list items can also be created without a parent widget, and later inserted into a list using QListWidget::insertItem().
List items are typically used to display text() and an icon(). These are set with the setText() and setIcon() functions. The appearance of the text can be customized with setFont(), setForeground(), and setBackground(). Text in list items can be aligned using the setTextAlignment() function. Tooltips, status tips and "What's This?" help can be added to list items with setToolTip(), setStatusTip(), and setWhatsThis().
By default, items are enabled, selectable, checkable, and can be the source of drag and drop operations.
Each item's flags can be changed by calling setFlags() with the appropriate value (see Qt::ItemFlags). Checkable items can be checked, unchecked and partially checked with the setCheckState() function. The corresponding checkState() function indicates the item's current check state.
The isHidden() function can be used to determine whether the item is hidden. To hide an item, use setHidden().
Subclassing
When subclassing QListWidgetItem to provide custom items, it is possible to define new types for them enabling them to be distinguished from standard items. For subclasses that require this feature, ensure that you call the base class constructor with a new type value equal to or greater than UserType, within your constructor.
See also QListWidget, Model/View Programming, QTreeWidgetItem, and QTableWidgetItem.
Member Type Documentation
enum QListWidgetItem::ItemType
This enum describes the types that are used to describe list widget items.
| Constant | Value | Description |
|---|---|---|
| QListWidgetItem::Type | 0 | The default type for list widget items. |
| QListWidgetItem::UserType | 1000 | The minimum value for custom types. Values below UserType are reserved by Qt. |
You can define new user types in QListWidgetItem subclasses to ensure that custom items are treated specially.
See also type().
Member Function Documentation
QListWidgetItem::QListWidgetItem ( QListWidget * parent = 0, int type = Type )
Constructs an empty list widget item of the specified type with the given parent. If parent is not specified, the item will need to be inserted into a list widget with QListWidget::insertItem().
This constructor inserts the item into the model of the parent that is passed to the constructor. If the model is sorted then the behavior of the insert is undetermined since the model will call the '<' operator method on the item which, at this point, is not yet constructed. To avoid the undetermined behavior, we recommend not to specify the parent and use QListWidget::insertItem() instead.
See also type().
QListWidgetItem::QListWidgetItem ( const QString & text, QListWidget * parent = 0, int type = Type )
Constructs an empty list widget item of the specified type with the given text and parent. If the parent is not specified, the item will need to be inserted into a list widget with QListWidget::insertItem().
This constructor inserts the item into the model of the parent that is passed to the constructor. If the model is sorted then the behavior of the insert is undetermined since the model will call the '<' operator method on the item which, at this point, is not yet constructed. To avoid the undetermined behavior, we recommend not to specify the parent and use QListWidget::insertItem() instead.
See also type().
QListWidgetItem::QListWidgetItem ( const QIcon & icon, const QString & text, QListWidget * parent = 0, int type = Type )
Constructs an empty list widget item of the specified type with the given icon, text and parent. If the parent is not specified, the item will need to be inserted into a list widget with QListWidget::insertItem().
This constructor inserts the item into the model of the parent that is passed to the constructor. If the model is sorted then the behavior of the insert is undetermined since the model will call the '<' operator method on the item which, at this point, is not yet constructed. To avoid the undetermined behavior, we recommend not to specify the parent and use QListWidget::insertItem() instead.
See also type().
QListWidgetItem::QListWidgetItem ( const QListWidgetItem & other )
Constructs a copy of other. Note that type() and listWidget() are not copied.
This function is useful when reimplementing clone().
This function was introduced in Qt 4.1.
QListWidgetItem::~QListWidgetItem () [virtual]
Destroys the list item.
QBrush QListWidgetItem::background () const
Returns the brush used to display the list item's background.
This function was introduced in Qt 4.2.
See also setBackground() and foreground().
Qt::CheckState QListWidgetItem::checkState () const
Returns the checked state of the list item (see Qt::CheckState).
See also setCheckState() and flags().
QListWidgetItem * QListWidgetItem::clone () const [virtual]
Creates an exact copy of the item.
QVariant QListWidgetItem::data ( int role ) const [virtual]
Returns the item's data for a given role. Reimplement this function if you need extra roles or special behavior for certain roles.
See also Qt::ItemDataRole and setData().
Qt::ItemFlags QListWidgetItem::flags () const
Returns the item flags for this item (see Qt::ItemFlags).
See also setFlags().
QFont QListWidgetItem::font () const
Returns the font used to display this list item's text.
See also setFont().
QBrush QListWidgetItem::foreground () const
Returns the brush used to display the list item's foreground (e.g. text).
This function was introduced in Qt 4.2.
See also setForeground() and background().
QIcon QListWidgetItem::icon () const
Returns the list item's icon.
Best Of
Actualités les plus lues
- « Quelque chose ne va vraiment pas avec les développeurs "modernes" », un développeur à "l'ancienne" critique la multiplication des bibliothèques 12
- Quelles nouveautés de C++11 Visual C++ doit-il rapidement intégrer ? Donnez-nous votre avis 10
- Partage de données explicite et implicite avec Qt, un article de Christophe Dumez traduit par Thibaut Cuvelier 0
- Créer des applications avec un style Metro avec Qt, exemples en QML et C++, un article du blog Digia traduit par Thibaut Cuvelier 0
- Microsoft ouvre aux autres compilateurs C++ AMP, la spécification pour la conception d'applications parallèles C++ utilisant le GPU 22
- Les développeurs ignorent-ils trop les failles découvertes dans leur code ? Prenez-vous en compte les remarques des autres ? 17
- RIM : « 13 % des développeurs ont gagné plus de 100 000 $ sur l'AppWord », Qt et open-source au menu du BlackBerry DevCon Europe 0
- « Quelque chose ne va vraiment pas avec les développeurs "modernes" », un développeur à "l'ancienne" critique la multiplication des bibliothèques 12
- BlackBerry 10 : premières images du prochain OS de RIM qui devrait intégrer des widgets et des tuiles inspirées de Windows Phone 0
- Adieu qmake, bienvenue qbs : Qt Building Suite, un outil déclaratif et extensible pour la compilation de projets Qt 17
- Quelles nouveautés de C++11 Visual C++ doit-il rapidement intégrer ? Donnez-nous votre avis 10
- Linus Torvalds : le "C++ est un langage horrible", en justifiant le choix du C pour le système de gestion de version Git 100
- Comment prendre en compte l'utilisateur dans vos applications ? Pour un développeur, « 90 % des utilisateurs sont des idiots » 229
- Quel est LE livre que tout développeur doit lire absolument ? Celui qui vous a le plus marqué et inspiré 96
- Apple cède et s'engage à payer des droits à Nokia, le conflit des brevets entre les deux firmes s'achève 158
- Nokia porte à nouveau plainte contre Apple pour violation de sept nouveaux brevets 158
- Quel est le code dont vous êtes le plus fier ? Pourquoi l'avez-vous écrit ? Et pourquoi vous a-t-il donné autant de satisfaction ? 83
- Le Draft final de la norme C++ 0X validé 181
Le Qt Developer Network au hasard
Applications mobiles modernes avec Qt et QML
Communauté
Ressources
- 91 cours et tutoriels Qt
- F.A.Q. Qt : 200 questions et réponses
- 48 Qt Quarterly, 35 Qt Labs et 22 Qt DevNet en français
- 43 outils Qt
- 99 sources Qt
- 26 binaires Qt
- 6 livres Qt et 9 critiques
- La documentation de Qt 4.7 en français : 157 classes, 70 concepts et 24 modules
- 3 certifications Qt
Liens utiles
Contact
- Vous souhaitez rejoindre la rédaction ou proposer un tutoriel, une traduction, une question... ? Postez dans le forum Contribuez ou contactez-nous par MP ou par email (voir en bas de page).
Qt dans le magazine
| Cette page est une traduction d'une page de la documentation de Qt, écrite par Nokia Corporation and/or its subsidiary(-ies). Les éventuels problèmes résultant d'une mauvaise traduction ne sont pas imputables à Nokia. | Qt 4.6 | |
| Copyright © 2012 Developpez LLC. Tous droits réservés Developpez LLC. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon, vous encourez selon la loi jusqu'à 3 ans de prison et jusqu'à 300 000 E de dommages et intérêts. Cette page est déposée à la SACD. | ||
| Vous avez déniché une erreur ? Un bug ? Une redirection cassée ? Ou tout autre problème, quel qu'il soit ? Ou bien vous désirez participer à ce projet de traduction ? N'hésitez pas à nous contacter ou par MP ! | ||
Copyright © 2000-2012 - www.developpez.com