QListView Class

Documentation sur les propriétés

batchSize : int

Cette propriété indique le nombre d'éléments affichés dans chaque lot si l'option « layoutMode » est définie sur « Batched ».

La valeur par défaut est 100.

Fonctions d’accès :

flow : Flow

Cette propriété définit le sens dans lequel les éléments doivent s'afficher.

Si cette propriété est définie sur « LeftToRight », les éléments seront disposés de gauche à droite. Si la propriété « isWrapping » est définie sur « true », la disposition s'enroulera lorsqu'elle atteindra le bord droit de la zone visible. Si cette propriété est définie sur « TopToBottom », les éléments seront disposés à partir du haut de la zone visible et s'enrouleront lorsqu'ils atteindront le bas.

La définition de cette propriété lorsque la vue est visible entraînera un réagencement des éléments.

Par défaut, cette propriété est définie sur « TopToBottom ».

Fonctions d’accès :

Voir également viewMode.

gridSize : QSize

Cette propriété définit la taille de la grille de mise en page

Cette propriété correspond à la taille de la grille dans laquelle les éléments sont disposés. La valeur par défaut est une taille nulle, ce qui signifie qu’il n’y a pas de grille et que la mise en page ne s’effectue pas selon une grille. Définir cette propriété sur une taille non nulle active la mise en page en grille. (Lorsqu’une mise en page en grille est active, la propriété ` spacing ` est ignorée.)

La définition de cette propriété lorsque la vue est visible entraîne un réagencement des éléments.

Fonctions d'accès :

Voir également viewMode.

isWrapping : bool

Cette propriété détermine si la mise en page des éléments doit s'ajuster.

Cette propriété détermine si la disposition doit s'ajuster lorsqu'il n'y a plus d'espace disponible dans la zone visible. Le point à partir duquel la disposition s'ajuste dépend de la propriété « flow ».

La définition de cette propriété lorsque la vue est visible entraîne un réagencement des éléments.

Par défaut, cette propriété est définie sur « false ».

Fonctions d'accès :

Voir également viewMode.

itemAlignment : Qt::Alignment

Cette propriété définit l'alignement de chaque élément dans sa cellule

Cette fonctionnalité n'est prise en charge que dans ListMode avec un flux de texte de type « TopToBottom » et lorsque le retour à la ligne automatique est activé. L'alignement par défaut est 0, ce qui signifie qu'un élément occupe entièrement sa cellule.

Fonctions d’accès :

layoutMode : LayoutMode

détermine si la mise en page des éléments doit s'effectuer immédiatement ou être différée.

Cette propriété définit le mode de disposition des éléments. Lorsque le mode est « SinglePass » (par défaut), les éléments sont tous disposés en une seule fois. Lorsque le mode est « Batched », les éléments sont disposés par lots de batchSize éléments, au fur et à mesure du traitement des événements. Cela permet de visualiser et d’interagir instantanément avec les éléments visibles pendant que les autres sont en cours de disposition.

Fonctions d'accès :

Voir également viewMode.

modelColumn : int

Cette propriété indique la colonne du modèle qui est visible

Par défaut, cette propriété contient la valeur 0, ce qui indique que la première colonne du modèle sera affichée.

Fonctions d'accès :

movement : Movement

Cette propriété indique si les éléments peuvent être déplacés librement, s'ils sont alignés sur une grille ou s'ils ne peuvent pas être déplacés du tout.

Cette propriété détermine la manière dont l'utilisateur peut déplacer les éléments dans la vue. « Static » signifie que les éléments ne peuvent pas être déplacés par l'utilisateur. « Free » signifie que l'utilisateur peut glisser-déposer les éléments à n'importe quelle position dans la vue. « Snap » signifie que l'utilisateur peut glisser-déposer les éléments, mais uniquement vers les positions d'une grille imaginaire définie par la propriété « gridSize ».

La définition de cette propriété lorsque la vue est visible entraîne un réagencement des éléments.

Par défaut, cette propriété est définie sur « Static ».

Fonctions d'accès :

Voir également gridSize, resizeMode et viewMode.

resizeMode : ResizeMode

Cette propriété détermine si les éléments sont réorganisés lorsque la taille de la vue est modifiée.

Si cette propriété est définie sur « Adjust », les éléments seront réorganisés lorsque la vue sera redimensionnée. Si la valeur est « Fixed », les éléments ne seront pas réorganisés lorsque la vue sera redimensionnée.

Par défaut, cette propriété est définie sur « Fixed ».

Fonctions d’accès :

Voir également movement, gridSize et viewMode.

selectionRectVisible : bool

si le rectangle de sélection doit être visible

Si cette propriété est définie sur « true », le rectangle de sélection est visible ; dans le cas contraire, il est masqué.

Par défaut, cette propriété est définie sur « false ».

Fonctions d'accès :

spacing : int

Cette propriété définit l'espace autour des éléments dans la mise en page

Cette propriété correspond à la taille de l'espace vide qui entoure un élément dans la mise en page.

La définition de cette propriété lorsque la vue est visible entraîne un réagencement des éléments.

Par défaut, cette propriété a pour valeur 0.

Fonctions d'accès :

Voir également viewMode.

uniformItemSizes : bool

Cette propriété indique si tous les éléments de la liste ont la même taille

Cette propriété ne doit être définie sur « true » que s'il est garanti que tous les éléments de la vue ont la même taille. Cela permet à la vue d'effectuer certaines optimisations à des fins de performances.

Par défaut, cette propriété est définie sur « false ».

Fonctions d'accès :

viewMode : ViewMode

Cette propriété définit le mode d'affichage de l'QListView.

Cette propriété modifie les autres propriétés non définies afin de les adapter au mode d’affichage défini. Les propriétés spécifiques à QListView qui ont déjà été définies ne seront pas modifiées, sauf si la méthode clearPropertyFlags() a été appelée.

La définition du mode d’affichage active ou désactive le glisser-déposer en fonction du mouvement sélectionné. Pour ListMode, le mouvement par défaut est Static (glisser-déposer désactivé) ; pour IconMode, le mouvement par défaut est Free (glisser-déposer activé).

Fonctions d’accès :

Voir également isWrapping, spacing, gridSize, flow, movement et resizeMode.

wordWrap : bool

Cette propriété définit la politique de retour à la ligne du texte de l'élément

Si cette propriété est définie sur « true », le texte de l'élément est renvoyé à la ligne si nécessaire aux points de coupure de mot ; dans le cas contraire, il n'est pas renvoyé à la ligne. Cette propriété est définie par défaut sur « false ».

Veuillez noter que même si le retour à la ligne est activé, la cellule ne sera pas agrandie pour faire de la place au texte. Elle affichera des points de suspension pour le texte qui ne peut pas être affiché, conformément à l'textElideMode de la vue.

Fonctions d'accès :