Viadeo Twitter Google Bookmarks ! Facebook Digg del.icio.us MySpace Yahoo MyWeb Blinklist Netvouz Reddit Simpy StumbleUpon Bookmarks Windows Live Favorites 
Logo Documentation Qt ·  Page d'accueil  ·  Toutes les classes  ·  Classes principales  ·  Annotées  ·  Classes groupées  ·  Fonctions  · 

QToolBox Class Reference

The QToolBox class provides a column of tabbed widget items. More...

#include <qtoolbox.h>

Inherits QFrame.

List of all member functions.

Public Members

  • QToolBox ( QWidget * parent = 0, const char * name = 0, WFlags f = 0 )
  • int addItem ( QWidget * w, const QString & label )
  • int addItem ( QWidget * item, const QIconSet & iconSet, const QString & label )
  • int insertItem ( int index, QWidget * item, const QString & label )
  • int insertItem ( int index, QWidget * item, const QIconSet & iconSet, const QString & label )
  • int removeItem ( QWidget * item )
  • void setItemEnabled ( int index, bool enabled )
  • bool isItemEnabled ( int index ) const
  • void setItemLabel ( int index, const QString & label )
  • QString itemLabel ( int index ) const
  • void setItemIconSet ( int index, const QIconSet & iconSet )
  • QIconSet itemIconSet ( int index ) const
  • void setItemToolTip ( int index, const QString & toolTip )
  • QString itemToolTip ( int index ) const
  • QWidget * currentItem () const
  • void setCurrentItem ( QWidget * item )
  • int currentIndex () const
  • QWidget * item ( int index ) const
  • int indexOf ( QWidget * item ) const
  • int count () const

Public Slots

Signals

Properties

  • int count - the number of items contained in the toolbox  (read only)
  • int currentIndex - the index of the current item, or -1 if the toolbox is empty

Protected Members


Detailed Description

The QToolBox class provides a column of tabbed widget items.

A toolbox is a widget that displays a column of tabs one above the other, with the current item displayed below the current tab. Every tab has an index position within the column of tabs. A tab's item is a QWidget.

Each item has an itemLabel(), an optional icon, itemIconSet(), an optional itemToolTip(), and a widget. The item's attributes can be changed with setItemLabel(), setItemIconSet() and setItemToolTip().

Items are added using addItem(), or inserted at particular positions using insertItem(). The total number of items is given by count(). Items can be deleted with delete, or removed from the toolbox with removeItem(). Combining removeItem() and insertItem() allows to move items to different positions.

The current item widget is returned by currentItem() and set with setCurrentItem(). If you prefer you can work in terms of indexes using currentIndex(), setCurrentIndex(), indexOf() and item().

The currentChanged() signal is emitted when the current item is changed.

See also QTabWidget and Advanced Widgets.


Member Function Documentation

QToolBox::QToolBox ( QWidget * parent = 0, const char * name = 0, WFlags f = 0 )

Constructs a toolbox called name with parent parent and flags f.

int QToolBox::addItem ( QWidget * item, const QIconSet & iconSet, const QString & label )

Adds the widget item in a new tab at bottom of the toolbox. The new tab's label is set to label, and the iconSet is displayed to the left of the label. Returns the new tab's index.

int QToolBox::addItem ( QWidget * w, const QString & label )

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

Adds the widget w in a new tab at bottom of the toolbox. The new tab's label is set to label. Returns the new tab's index.

int QToolBox::count () const

Returns the number of items contained in the toolbox. See the "count" property for details.

void QToolBox::currentChanged ( int index ) [signal]

This signal is emitted when the current item changed. The new current item's index is passed in index, or -1 if there is no current item.

int QToolBox::currentIndex () const

Returns the index of the current item, or -1 if the toolbox is empty. See the "currentIndex" property for details.

QWidget * QToolBox::currentItem () const

Returns the toolbox's current item, or 0 if the toolbox is empty.

int QToolBox::indexOf ( QWidget * item ) const

Returns the index of item item, or -1 if the item does not exist.

int QToolBox::insertItem ( int index, QWidget * item, const QIconSet & iconSet, const QString & label )

Inserts the widget item at position index, or at the bottom of the toolbox if index is out of range. The new item's label is set to label, and the iconSet is displayed to the left of the label. Returns the new item's index.

int QToolBox::insertItem ( int index, QWidget * item, const QString & label )

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

Inserts the widget item at position index, or at the bottom of the toolbox if index is out of range. The new item's label is set to label. Returns the new item's index.

bool QToolBox::isItemEnabled ( int index ) const

Returns TRUE if the item at position index is enabled; otherwise returns FALSE.

QWidget * QToolBox::item ( int index ) const

Returns the item at position index, or 0 if there is no such item.

QIconSet QToolBox::itemIconSet ( int index ) const

Returns the icon of the item at position index, or a null icon if index is out of range.

void QToolBox::itemInserted ( int index ) [virtual protected]

This virtual handler is called after a new item was added or inserted at position index.

QString QToolBox::itemLabel ( int index ) const

Returns the label of the item at position index, or a null string if index is out of range.

void QToolBox::itemRemoved ( int index ) [virtual protected]

This virtual handler is called after an item was removed from position index.

QString QToolBox::itemToolTip ( int index ) const

Returns the tooltip of the item at position index, or a null string if index is out of range.

int QToolBox::removeItem ( QWidget * item )

Removes the widget item from the toolbox. Note that the widget is not deleted. Returns the removed widget's index, or -1 if the widget was not in this tool box.

void QToolBox::setCurrentIndex ( int index ) [slot]

Sets the index of the current item, or -1 if the toolbox is empty to index. See the "currentIndex" property for details.

void QToolBox::setCurrentItem ( QWidget * item )

Sets the current item to be item.

void QToolBox::setItemEnabled ( int index, bool enabled )

If enabled is TRUE then the item at position index is enabled; otherwise item index is disabled.

void QToolBox::setItemIconSet ( int index, const QIconSet & iconSet )

Sets the icon of the item at position index to iconSet.

void QToolBox::setItemLabel ( int index, const QString & label )

Sets the label of the item at position index to label.

void QToolBox::setItemToolTip ( int index, const QString & toolTip )

Sets the tooltip of the item at position index to toolTip.

Property Documentation

int count

This property holds the number of items contained in the toolbox.

Get this property's value with count().

int currentIndex

This property holds the index of the current item, or -1 if the toolbox is empty.

Set this property's value with setCurrentIndex() and get this property's value with currentIndex().

See also currentItem(), indexOf(), and item().


This file is part of the Qt toolkit. Copyright © 1995-2003 Trolltech. All Rights Reserved.

Publicité

Best Of

Actualités les plus lues

Semaine
Mois
Année
  1. « Quelque chose ne va vraiment pas avec les développeurs "modernes" », un développeur à "l'ancienne" critique la multiplication des bibliothèques 94
  2. Apercevoir la troisième dimension ou l'utilisation multithreadée d'OpenGL dans Qt, un article des Qt Quarterly traduit par Guillaume Belz 0
  3. Pourquoi les programmeurs sont-ils moins payés que les gestionnaires de programmes ? Manquent-ils de pouvoir de négociation ? 45
  4. Les développeurs ignorent-ils trop les failles découvertes dans leur code ? Prenez-vous en compte les remarques des autres ? 17
  5. Les développeurs détestent-ils les antivirus ? Un programmeur manifeste sa haine envers ces solutions de sécurité 6
  6. Quelles nouveautés de C++11 Visual C++ doit-il rapidement intégrer ? Donnez-nous votre avis 10
  7. Qt Commercial : Digia organise un webinar gratuit le 27 mars sur la conception d'interfaces utilisateur et d'applications avec le framework 0
Page suivante

Le Qt Developer Network au hasard

Logo

Génération de bindings PySide avec Shiboken

Le Qt Developer Network est un réseau de développeurs Qt anglophone, où ils peuvent partager leur expérience sur le framework. Lire l'article.

Communauté

Ressources

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 3.2
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 !
 
 
 
 
Partenaires

Hébergement Web