   
QListViewLa classe QListView fournit une vue de listes ou d'ic�nes sur un mod�le. Plus d'informations... #include <QListView>Voir la position dans l'arbre des classes. H�ritageH�rite de QAbstractItemView. H�rit�e par QHelpIndexWidget, QListWidget et QUndoView. Description d�taill�eLa classe QListView fournit une vue de listes ou d'ic�nes sur un mod�le. La QListView pr�sente les �l�ments contenus dans un mod�le soit comme une simple liste sans hi�rarchie, soit comme une collection d'ic�nes. Cette classe est utilis�e pour fournir l'affichage de listes et d'ic�nes qui �taient auparavant affich�es par les classes QListBox et QIconView en utilisant l'approche flexible de l'architecture mod�le/vue de Qt. La classe QListView est l'une des classes Mod�le/Vue et fait partie du framework mod�le/vue de Qt. Cette vue n'affiche pas d'en-t�te horizontal, ni d'en-t�te vertical ; afin d'afficher une liste d'�l�ments avec un en-t�te horizontal, utilisez QTreeView. QListView impl�mente les interfaces d�finies par la classe QAbstractItemView qui lui permettent d'afficher les donn�es fournies par les mod�les d�rivant de la classe QAbstractItemModel. Les �l�ments de la liste peuvent �tre affich�s en utilisant l'un des deux modes suivants : avec le mode ListMode, les �l�ments sont affich�s sous la forme d'une simple liste ; avec le mode IconMode, la liste prend la forme d'une vue ic�nes dans laquelle les �l�ments sont affich�s � cot� d'ic�nes comme des fichiers dans les gestionnaire de fichiers. Par d�faut, la vue utilise le mode ListMode. Pour changer le mode, utilisez la fonction setViewMode() et la fonction viewMode() pour connaitre le mode actuel. Dans ces vues, les �l�ments sont dispos�s dans la direction sp�cifi�e par flow(). Les �l�ments peuvent �tre statiques ou mobiles selon l'�tat retourn� par movement(). Si les �l�ments du mod�le ne peuvent pas tous �tre affich�s dans la direction du flux, ils peuvent �tre d�coup�s par les bords du widget ; cela d�pend de la propri�t� isWrapping(). Cette propri�t� est utile, notamment lorsque les �l�ments sont repr�sent�s par une vue d'ic�nes. Les fonctions resizeMode() et layoutMode() informent de la fa�on dont les �l�ments vont �tre dispos�s. Les �l�ments sont espac�s selon spacing() et Qt d�termine s'ils peuvent �tre affich�s selon l'espace sp�cifi� par gridSize(). Les �l�ments peuvent �tre affich�s avec de grandes ou petites ic�nes selon leur iconSize().
Am�lioration des performancesIl est possible de donner des indications sur les �l�ments � prendre en compte afin d'am�liorer les performances lors de l'affichage de nombreux �l�ments. Une des approches utilisable par la vue qui va afficher les �l�ments de m�me taille consiste � mettre la propri�t� uniformItemSizes � true. Voir aussi View Classes, QTreeView, QTableView et QListWidget. Typeenum QListView::Flow
enum QListView::LayoutMode
Voir aussi batchSize. enum QListView::Movement
enum QListView::ResizeMode
enum QListView::ViewMode
Propri�t�sbatchSize : intLa propri�t� contient le nombre d'�l�ments contenu dans chaque lot lorsque layoutMode est d�fini � Batched. La valeur par d�faut est 100. La propri�t� a �t� introduite dans Qt 4.2. Fonctions d'acc�sint batchSize () const void setBatchSize ( int batchSize ) flow : FlowLa propri�t� contient la direction dans laquelle les �l�ments doivent �tre dispos�s. Si la propri�t� est d�finie � LeftToRight, les �l�ments vont �tre dispos�s de gauche � droite. Si la propri�t� isWrapping est d�finie � true, les mots vont passer � la ligne lorsqu'il n'y a pas assez de place sur la droite. Si la propri�t� est d�finie � TopToBottom, les �l�ments vont �tre dispos�s de haut en bas dans la zone visible, passant � la colonne suivante une fois le bas atteint. Red�finir la propri�t� lorsque la vue est visible va provoquer la r�organisation des �l�ments. Par d�faut, la propri�t� est d�finie � TopToBottom. Fonctions d'acc�sFlow flow () const void setFlow ( Flow flow ) Voir aussi viewMode. gridSize : QSizeLa propri�t� contient la taille de la grille. La valeur de la propri�t� indique la taille de la grille dans laquelle les �l�ments sont dispos�s. Par d�faut la taille est vide, signifiant qu'il n'y a pas de grille et que la mise en page n'est pas faite dans une grille. En d�finissant cette propri�t� � une taille non vide, vous basculez sur une mise en page en grille (lorsqu'une mise en page en grille est en place, la propri�t� spacing est ignor�e). La red�finition de cette propri�t� lorsque la vue est visible va provoquer la r�organisation des �l�ments. Fonctions d'acc�sQSize gridSize () const void setGridSize ( const QSize & size ) Voir aussi viewMode. isWrapping : boolLa propri�t� active ou d�sactive le retour � la ligne des �l�ments. La valeur de la propri�t� d�termine si la mise en page doit appliquer ou non le retour � la ligne lorsque la place est insuffisante. L'endroit du retour � la ligne d�pend de la propri�t� flow. La red�finition de la propri�t� lorsque la vue est visible va provoquer la r�organisation des �l�ments. Par d�faut, la propri�t� est false. Fonctions d'acc�sbool isWrapping () const void setWrapping ( bool enable ) Voir aussi viewMode. layoutMode : LayoutModeLa propri�t� d�termine si la mise ne page doit �tre faite en une fois ou non. La propri�t� contient le mode de mise en page des �l�ments. Lorsque le mode est d�fini � SinglePass (celui par d�faut), les �l�ments sont dispos�s en une seule fois. Lorsque le mode est d�fini � Batched, les �l�ments sont dispos�s par lot de batchSize �l�ments lors du traitement des �v�nements. Cela permet de voir et d'interagir avec la vue pendant que le reste des �l�ments et en cours de mise en place. Fonctions d'acc�sLayoutMode layoutMode () const void setLayoutMode ( LayoutMode mode ) Voir aussi viewMode. modelColumn : intLa propri�t� contient l'index de la colonne du mod�le visible. Par d�faut, la propri�t� contient 0, indiquant que la premi�re colonne du mod�le va �tre affich�e. Fonctions d'acc�sint modelColumn () const void setModelColumn ( int column ) movement : MovementLa propri�t� indique si les �l�ments peuvent �tre d�plac�s librement, attach�s � la grille ou encore fixes. La propri�t� d�termine la fa�on dont l'utilisateur va pouvoir d�placer les �l�ments dans la vue. Static signifie que les �l�ments ne peuvent pas �tre d�plac�s. Free signifie que les utilisateurs peuvent glisser/d�poser les �l�ments n'importe o� dans la vue. Snap signifie que l'utilisateur peut glisser/d�poser les �l�ments, mais uniquement aux positions d�termin�es par la grille selon la propri�t� gridSize. La red�finition de cette propri�t� lorsque la vue est visible va provoquer la r�organisation des �l�ments. Par d�faut, la propri�t� est d�finie � Static. Fonctions d'acc�sMovement movement () const void setMovement ( Movement movement ) Voir aussi gridSize, resizeMode et viewMode. resizeMode : ResizeModeLa propri�t� indique si les �l�ments doivent �tre r�organis�s lorsque la vue est redimensionn�e. Si la propri�t� est d�finie � Adjust, les �l�ments vont �tre r�organis�s lors du redimensionnement de la vue. Si la valeur est d�finie � Fixed, les �l�ments ne vont pas �tre r�organis�s lors du redimensionnement de la vue. Par d�faut, la propri�t� est d�finie � Fixed. Fonctions d'acc�sResizeMode resizeMode () const void setResizeMode ( ResizeMode mode ) Voir aussi movement, gridSize et viewMode. selectionRectVisible : boolLa propri�t� indique si le rectangle de s�lection doit �tre visible. Si la propri�t� est d�finie � true, le rectangle de s�lection est visible ; sinon il ne va pas �tre affich�. Note : le rectangle de s�lection va �tre visible seulement si le mode de s�lection est un mode permettant la s�lection de plus d'un �l�ment ; exemple : le rectangle de s�lection n'est pas dessin� si le mode de s�lection est QAbstractItemView::SingleSelection. Par d�faut, la propri�t� est d�finie � false. Cette propri�t� a �t� introduite dans Qt 4.3. Fonctions d'acc�sbool isSelectionRectVisible () const void setSelectionRectVisible ( bool show ) spacing : intLa propri�t� indique l'espace autour des �l�ments. La propri�t� d�finit la taille d'espace vide qui est intercal� autour un �l�ment dans la vue. La red�finition de cette propri�t� lorsque la vue est visible va provoquer la r�organisation des �l�ments. Par d�faut, la propri�t� vaut 0. Fonctions d'acc�sint spacing () const void setSpacing ( int space ) Voir aussi viewMode. uniformItemSizes : boolLa propri�t� indique si tous les �l�ments de la liste ont la m�me taille. La propri�t� devrait �tre d�finie � true seulement s'il est garanti que tous les �l�ments de la vue ont la m�me taille. Cela permet l'activation d'optimisations am�liorant les performances. Par d�faut, la propri�t� est d�finie � false. La propri�t� a �t� introduite dans Qt 4.1. Fonctions d'acc�sbool uniformItemSizes () const void setUniformItemSizes ( bool enable ) viewMode : ViewModeLa propri�t� indique le mode d'affichage de la QListView. La propri�t� va modifier les autres propri�t�s non d�finies afin d'�tre conforme avec le mode d'affichage d�fini. Les propri�t�s sp�cifiques QListView qui ont d�j� �t� d�finies ne vont pas �tre modifi�es tant que clearPropertyFlags() n'a pas �t� appel�. La d�finition du mode d'affichage va activer ou d�sactiver le glisser/d�poser bas� sur le mouvement s�lectionn�. Pour ListMode, le mouvement par d�faut est Static (glisser/d�poser d�sactiv�); pour IconMode, le mouvement pas d�faut est Free (glisser/d�poser activ�). Fonctions d'acc�sViewMode viewMode () const void setViewMode ( ViewMode mode ) Voir aussi isWrapping, spacing, gridSize, flow, movement et resizeMode. wordWrap : boolLa propri�t� indique la politique de retour � la ligne des mots. Si la propri�t� est d�finie � true alors le texte est d�coup� entre les mots, si n�cessaire; sinon, il n'est pas du tout mis � la ligne. La propri�t� est d�finie � false par d�faut. Veuillez noter que la cellule ne va pas �tre �tendue pour laisser de la place au texte m�me si le retour � la ligne est activ�. Cela va afficher une ellipse pour le texte ne pouvant pas �tre affich�, selon la propri�t� de textElideMode. La propri�t� a �t� introduite dans Qt 4.2. Fonctions d'acc�sbool wordWrap () const void setWordWrap ( bool on ) Fonctions membresQListView::QListView ( QWidget * parent = 0 )Cr�e un nouveau QListView avec le parent donn� pour afficher un mod�le. Utilisez setModel() pour d�finir le mod�le. QListView::~QListView ()D�truit la vue. void QListView::clearPropertyFlags ()R�initialise les propri�t�s sp�cifiques de QListView. Voir viewMode. Les propri�t�s h�ritant de QAbstractItemView ne sont pas affect�es par les propri�t�s. Plus pr�cis�ment, dragEnabled et acceptsDrops sont calcul�s par QListView lors de l'appel de setMovement() ou de setViewMode(). void QListView::currentChanged ( const QModelIndex & current, const QModelIndex & previous ) [virtual protected]R�impl�mentation de QAbstractItemView::currentChanged(). void QListView::dataChanged ( const QModelIndex & topLeft, const QModelIndex & bottomRight ) [virtual protected]R�impl�mentation de QAbstractItemView::dataChanged(). void QListView::dragLeaveEvent ( QDragLeaveEvent * e ) [virtual protected]R�impl�mentation de QWidget::dragLeaveEvent(). void QListView::dragMoveEvent ( QDragMoveEvent * e ) [virtual protected]R�impl�mentation de QWidget::dragMoveEvent(). void QListView::dropEvent ( QDropEvent * e ) [virtual protected]R�impl�mentation de QWidget::dropEvent(). bool QListView::event ( QEvent * e ) [virtual protected]R�impl�mentation de QObject::event(). int QListView::horizontalOffset () const [virtual protected]R�impl�mentation de QAbstractItemView::horizontalOffset(). QModelIndex QListView::indexAt ( const QPoint & p ) const [virtual]R�impl�mentation de QAbstractItemView::indexAt(). void QListView::indexesMoved ( const QModelIndexList & indexes ) [signal]Ce signal est �mis lorsque la variable sp�cifi�e indexes est d�plac�e dans la vue. Cette fonction a �t� introduite dans Qt 4.2. bool QListView::isIndexHidden ( const QModelIndex & index ) const [virtual protected]R�impl�mentation de QAbstractItemView::isIndexHidden(). bool QListView::isRowHidden ( int row ) constRetourne true si la ligne row est cach�e ; sinon retourne false. void QListView::mouseMoveEvent ( QMouseEvent * e ) [virtual protected]R�impl�mentation de QWidget::mouseMoveEvent(). void QListView::mouseReleaseEvent ( QMouseEvent * e ) [virtual protected]R�impl�mentation de QWidget::mouseReleaseEvent(). QModelIndex QListView::moveCursor ( CursorAction cursorAction, Qt::KeyboardModifiers modifiers ) [virtual protected]R�impl�mentation de QAbstractItemView::moveCursor(). void QListView::paintEvent ( QPaintEvent * e ) [virtual protected]R�impl�mentation de QWidget::paintEvent(). QRect QListView::rectForIndex ( const QModelIndex & index ) const [protected]Retourne le rectangle de l'�l�ment � la position index dans le mod�le. La rectangle est en coordonn�es du contenu. Voir aussi visualRect(). void QListView::resizeEvent ( QResizeEvent * e ) [virtual protected]R�impl�mentation de QWidget::resizeEvent(). void QListView::rowsAboutToBeRemoved ( const QModelIndex & parent, int start, int end ) [virtual protected]R�impl�mentation de QAbstractItemView::rowsAboutToBeRemoved(). void QListView::rowsInserted ( const QModelIndex & parent, int start, int end ) [virtual protected]R�impl�mentation de QAbstractItemView::rowsInserted(). void QListView::scrollTo ( const QModelIndex & index, ScrollHint hint = EnsureVisible ) [virtual]R�impl�mentation de QAbstractItemView::scrollTo(). QModelIndexList QListView::selectedIndexes () const [virtual protected]R�impl�mentation de QAbstractItemView::selectedIndexes(). void QListView::selectionChanged ( const QItemSelection & selected, const QItemSelection & deselected ) [virtual protected]R�impl�mentation de QAbstractItemView::selectionChanged(). void QListView::setPositionForIndex ( const QPoint & position, const QModelIndex & index ) [protected]D�finit la position du contenu de l'�l�ment � index dans le mod�le � la position donn�e. Si le mode de mouvement de la vue est Static ou que le mode de la vue est ListView, cette fonction n'a aucun effet. Cette fonction a �t� introduite dans Qt 4.1. void QListView::setRowHidden ( int row, bool hide )Si hide est true, alors la ligne row donn�e va �tre cach�e ; sinon la ligne row va �tre affich�e. Voir aussi isRowHidden(). void QListView::setSelection ( const QRect & rect, QItemSelectionModel::SelectionFlags command ) [virtual protected]R�impl�mentation de QAbstractItemView::setSelection(). void QListView::startDrag ( Qt::DropActions supportedActions ) [virtual protected]R�impl�mentation de QAbstractItemView::startDrag(). void QListView::timerEvent ( QTimerEvent * e ) [virtual protected]R�impl�mentation de QObject::timerEvent(). void QListView::updateGeometries () [virtual protected]R�impl�mentation de QAbstractItemView::updateGeometries(). int QListView::verticalOffset () const [virtual protected]R�impl�mentation de QAbstractItemView::verticalOffset(). QStyleOptionViewItem QListView::viewOptions () const [virtual protected]R�impl�mentation de QAbstractItemView::viewOptions(). QRect QListView::visualRect ( const QModelIndex & index ) const [virtual]R�impl�mentation de QAbstractItemView::visualRect(). QRegion QListView::visualRegionForSelection ( const QItemSelection & selection ) const [virtual protected]R�impl�mentation de QAbstractItemView::visualRegionForSelection(). Depuis 4.7, la r�gion retourn�e contient les rectangles qui entrecoupent (ou sont inclus dans) le viewport. RemerciementsMerci � Alexandre Laurent pour la traduction et � Jonathan Courtois ainsi qu'� Maxime Gault pour leur relecture ! |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 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.7 | |
| Copyright © 2025 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 ! | ||
