QStandardItem Class

Documentation des fonctions membres

QStandardItem::QStandardItem()

Construit un élément.

[explicit] QStandardItem::QStandardItem(const QString &text)

Construit un élément avec l'adresse text.

QStandardItem::QStandardItem(const QIcon &icon, const QString &text)

Construit un élément avec les données icon et text.

[explicit] QStandardItem::QStandardItem(int rows, int columns = 1)

Construit un élément avec rows lignes et columns colonnes d'éléments enfants.

[protected] QStandardItem::QStandardItem(const QStandardItem &other)

Construit une copie de other. Notez que model() n'est pas copié.

Cette fonction est utile pour réimplémenter clone().

[virtual noexcept] QStandardItem::~QStandardItem()

Détruit l'élément. Les enfants de l'élément sont également détruits.

QString QStandardItem::accessibleDescription() const

Renvoie la description accessible de l'élément.

La description accessible est utilisée par les technologies d'assistance (c'est-à-dire pour les utilisateurs qui ne peuvent pas utiliser les moyens d'interaction conventionnels).

Voir également setAccessibleDescription() et accessibleText().

QString QStandardItem::accessibleText() const

Renvoie le texte accessible de l'élément.

Le texte accessible est utilisé par les technologies d'assistance (c'est-à-dire pour les utilisateurs qui ne peuvent pas utiliser les moyens d'interaction conventionnels).

Voir également setAccessibleText() et accessibleDescription().

void QStandardItem::appendColumn(const QList<QStandardItem *> &items)

Ajoute une colonne contenant items. Si nécessaire, le nombre de lignes est augmenté pour atteindre la taille de items.

Voir aussi insertColumn().

void QStandardItem::appendRow(const QList<QStandardItem *> &items)

Ajoute une ligne contenant items. Si nécessaire, le nombre de colonnes est augmenté pour atteindre la taille de items.

Voir aussi insertRow().

void QStandardItem::appendRow(QStandardItem *item)

Ajoute une ligne contenant item.

Lors de la construction d'une liste ou d'un arbre ne comportant qu'une seule colonne, cette fonction offre un moyen pratique d'ajouter un seul nouvel élément.

void QStandardItem::appendRows(const QList<QStandardItem *> &items)

Ajoute les lignes contenant items. Le nombre de colonnes ne change pas.

Voir aussi insertRow().

QBrush QStandardItem::background() const

Renvoie la brosse utilisée pour rendre l'arrière-plan de l'élément.

Voir aussi foreground() et setBackground().

Qt::CheckState QStandardItem::checkState() const

Renvoie l'état vérifié de l'élément.

Voir aussi setCheckState() et isCheckable().

QStandardItem *QStandardItem::child(int row, int column = 0) const

Renvoie l'élément enfant à (row, column) s'il a été défini ; sinon, renvoie nullptr.

Voir aussi setChild(), takeChild(), et parent().

void QStandardItem::clearData()

Supprime toutes les données de tous les rôles précédemment définis.

Voir également data() et setData().

[virtual] QStandardItem *QStandardItem::clone() const

Renvoie une copie de cet élément. Les enfants de l'élément ne sont pas copiés.

Lorsque vous sous-classez QStandardItem, vous pouvez réimplémenter cette fonction pour fournir à QStandardItemModel une usine qu'il peut utiliser pour créer de nouveaux éléments à la demande.

Voir aussi QStandardItemModel::setItemPrototype() et operator=().

int QStandardItem::column() const

Renvoie la colonne où se trouve l'élément dans la table enfant de son parent, ou -1 si l'élément n'a pas de parent.

Voir aussi row() et parent().

int QStandardItem::columnCount() const

Renvoie le nombre de colonnes d'éléments enfants que l'élément possède.

Voir aussi setColumnCount() et rowCount().

[virtual] QVariant QStandardItem::data(int role = Qt::UserRole + 1) const

Renvoie les données de l'élément pour le role donné, ou un QVariant invalide s'il n'y a pas de données pour le rôle.

Si vous réimplémentez cette fonction, vous devez appeler l'implémentation de base pour les rôles que vous ne gérez pas, sinon l'obtention de drapeaux, par exemple en appelant flags(), isCheckable(), isEditable(), etc. ne fonctionnera pas.

Voir aussi setData().

[protected] void QStandardItem::emitDataChanged()

Demande au modèle associé à cet élément d'émettre un signal dataChanged() pour cet élément.

Vous ne devez normalement appeler cette fonction que si vous avez sous-classé QStandardItem et réimplémenté data() et/ou setData().

Voir également setData().

Qt::ItemFlags QStandardItem::flags() const

Renvoie les drapeaux de l'élément.

Les indicateurs de l'élément déterminent comment l'utilisateur peut interagir avec l'élément.

Par défaut, les éléments sont activés, modifiables, sélectionnables, vérifiables et peuvent être utilisés à la fois comme source d'une opération de glisser-déposer et comme cible de dépôt.

Voir également setFlags().

QFont QStandardItem::font() const

Renvoie la police utilisée pour rendre le texte de l'élément.

Voir aussi setFont().

QBrush QStandardItem::foreground() const

Renvoie la brosse utilisée pour rendre l'avant-plan de l'élément (par exemple, le texte).

Voir aussi setForeground() et background().

bool QStandardItem::hasChildren() const

Renvoie true si cet élément a des enfants ; sinon, renvoie false.

Voir aussi rowCount(), columnCount(), et child().

QIcon QStandardItem::icon() const

Renvoie l'icône de l'élément.

Voir aussi setIcon() et iconSize.

QModelIndex QStandardItem::index() const

Renvoie l'adresse QModelIndex associée à cet élément.

Lorsque vous devez invoquer la fonctionnalité d'un élément dans une API basée sur QModelIndex(par exemple QAbstractItemView), vous pouvez appeler cette fonction pour obtenir un index correspondant à l'emplacement de l'élément dans le modèle.

Si l'élément n'est pas associé à un modèle, une adresse QModelIndex invalide est renvoyée.

Voir également model() et QStandardItemModel::itemFromIndex().

void QStandardItem::insertColumn(int column, const QList<QStandardItem *> &items)

Insère une colonne à column contenant items. Si nécessaire, le nombre de lignes est augmenté pour atteindre la taille de items.

Voir également insertColumns() et insertRow().

void QStandardItem::insertColumns(int column, int count)

Insère les colonnes count des éléments enfants à la colonne column.

Voir aussi insertColumn() et insertRows().

void QStandardItem::insertRow(int row, const QList<QStandardItem *> &items)

Insère une ligne à row contenant items. Si nécessaire, le nombre de colonnes est augmenté pour atteindre la taille de items.

Voir également insertRows() et insertColumn().

void QStandardItem::insertRow(int row, QStandardItem *item)

Insère une ligne à row contenant item.

Lors de la construction d'une liste ou d'un arbre ne comportant qu'une seule colonne, cette fonction offre un moyen pratique d'insérer un seul nouvel élément.

void QStandardItem::insertRows(int row, const QList<QStandardItem *> &items)

Insère items à row. Le nombre de colonnes ne sera pas modifié.

Voir aussi insertRow() et insertColumn().

void QStandardItem::insertRows(int row, int count)

Insère count rangées d'éléments enfants à la ligne row.

Voir également insertRow() et insertColumns().

bool QStandardItem::isAutoTristate() const

Indique si l'élément est tristate et s'il est contrôlé par QTreeWidget.

La valeur par défaut est false.

Voir aussi setAutoTristate(), isCheckable() et checkState().

bool QStandardItem::isCheckable() const

Indique si l'élément est contrôlable par l'utilisateur.

La valeur par défaut est false.

Voir aussi setCheckable(), checkState(), isUserTristate() et isAutoTristate().

bool QStandardItem::isDragEnabled() const

Indique si l'élément peut être déplacé. L'utilisateur peut faire glisser un élément dont la fonction de glissement est activée.

La valeur par défaut est true.

Notez que le glissement d'élément doit être activé dans la vue pour que le glissement fonctionne ; voir QAbstractItemView::dragEnabled.

Voir également setDragEnabled(), isDropEnabled() et flags().

bool QStandardItem::isDropEnabled() const

Retourne si l'élément est autorisé à être déposé. Lorsqu'un élément est autorisé à être déposé, il peut être utilisé comme cible de dépôt.

La valeur par défaut est true.

Voir également setDropEnabled(), isDragEnabled() et flags().

bool QStandardItem::isEditable() const

Indique si l'élément peut être modifié par l'utilisateur.

Lorsqu'un élément est modifiable (et activé), l'utilisateur peut le modifier en invoquant l'un des déclencheurs de modification de la vue ; voir QAbstractItemView::editTriggers.

La valeur par défaut est true.

Voir également setEditable() et flags().

bool QStandardItem::isEnabled() const

Indique si l'élément est activé.

Lorsqu'un élément est activé, l'utilisateur peut interagir avec lui. Les types d'interaction possibles sont spécifiés par les autres indicateurs d'éléments, tels que isEditable() et isSelectable().

La valeur par défaut est true.

Voir également setEnabled() et flags().

bool QStandardItem::isSelectable() const

Indique si l'élément peut être sélectionné par l'utilisateur.

La valeur par défaut est true.

Voir également setSelectable() et flags().

bool QStandardItem::isUserTristate() const

Indique si l'élément est tristate, c'est-à-dire s'il est contrôlable avec trois états distincts et si l'utilisateur peut passer d'un état à l'autre.

La valeur par défaut est false.

Voir aussi setUserTristate(), isCheckable() et checkState().

QStandardItemModel *QStandardItem::model() const

Renvoie le site QStandardItemModel auquel appartient cet élément.

Si l'élément n'est pas un enfant d'un autre élément appartenant au modèle, cette fonction renvoie nullptr.

Voir également index().

[virtual, since 6.0] void QStandardItem::multiData(QModelRoleDataSpan roleDataSpan) const

Remplit le span roleDataSpan avec les données de cet élément.

L'implémentation par défaut appelle simplement data() pour chaque rôle dans le span.

Cette fonction a été introduite dans Qt 6.0.

Voir aussi data().

QStandardItem *QStandardItem::parent() const

Renvoie l'élément parent de l'élément, ou nullptr si l'élément n'a pas de parent.

Voir également child() et QStandardItemModel::invisibleRootItem().

[virtual] void QStandardItem::read(QDataStream &in)

Lit l'élément dans le flux in. Seules les données et les drapeaux de l'élément sont lus, pas les éléments enfants.

Voir également write().

void QStandardItem::removeColumn(int column)

Supprime la colonne column. Les éléments qui se trouvaient dans la colonne sont supprimés.

Voir aussi takeColumn(), removeColumns() et removeRow().

void QStandardItem::removeColumns(int column, int count)

Supprime les colonnes count à la colonne column. Les éléments qui se trouvaient dans ces colonnes sont supprimés.

Voir aussi removeColumn() et removeRows().

void QStandardItem::removeRow(int row)

Supprime le site row. Les éléments qui se trouvaient dans la ligne sont supprimés.

Voir aussi takeRow(), removeRows() et removeColumn().

void QStandardItem::removeRows(int row, int count)

Supprime les lignes count à la ligne row. Les éléments qui se trouvaient dans ces lignes sont supprimés.

Voir aussi removeRow() et removeColumn().

int QStandardItem::row() const

Renvoie la ligne où se trouve l'élément dans la table des enfants de son parent, ou -1 si l'élément n'a pas de parent.

Voir aussi column() et parent().

int QStandardItem::rowCount() const

Renvoie le nombre de lignes d'éléments enfants que l'élément possède.

Voir aussi setRowCount() et columnCount().

void QStandardItem::setAccessibleDescription(const QString &accessibleDescription)

Définit la description accessible de l'élément à la chaîne spécifiée par accessibleDescription.

La description accessible est utilisée par les technologies d'assistance (c'est-à-dire pour les utilisateurs qui ne peuvent pas utiliser les moyens d'interaction conventionnels).

Voir également accessibleDescription() et setAccessibleText().

void QStandardItem::setAccessibleText(const QString &accessibleText)

Fixe le texte accessible de l'élément à la chaîne spécifiée par accessibleText.

Le texte accessible est utilisé par les technologies d'assistance (c'est-à-dire pour les utilisateurs qui ne peuvent pas utiliser les moyens d'interaction conventionnels).

Voir également accessibleText() et setAccessibleDescription().

void QStandardItem::setAutoTristate(bool tristate)

Détermine que l'élément est tristate et contrôlé par QTreeWidget si tristate est true. Cela permet de gérer automatiquement l'état des éléments parents dans QTreeWidget (coché si tous les enfants sont cochés, décoché si tous les enfants sont décochés, ou partiellement coché si seuls certains enfants sont cochés).

Voir aussi isAutoTristate(), setCheckable() et setCheckState().

void QStandardItem::setBackground(const QBrush &brush)

Définit la brosse d'arrière-plan de l'élément à la valeur spécifiée brush.

Voir également background() et setForeground().

void QStandardItem::setCheckState(Qt::CheckState state)

Définit l'état de vérification de l'élément à state.

Voir également checkState() et setCheckable().

void QStandardItem::setCheckable(bool checkable)

Indique si l'élément est contrôlable par l'utilisateur. Si checkable est vrai, l'élément peut être vérifié par l'utilisateur ; dans le cas contraire, l'utilisateur ne peut pas vérifier l'élément.

Le délégué de l'élément rendra un élément vérifiable avec une case à cocher à côté du texte de l'élément.

Voir également isCheckable(), setCheckState(), setUserTristate() et setAutoTristate().

void QStandardItem::setChild(int row, int column, QStandardItem *item)

Définit l'élément enfant à (row, column) en item. Cet élément (l'élément parent) devient propriétaire de item. Si nécessaire, le nombre de lignes et le nombre de colonnes sont augmentés pour s'adapter à l'élément.

Voir aussi child().

void QStandardItem::setChild(int row, QStandardItem *item)

Définit l'enfant situé à row à item.

void QStandardItem::setColumnCount(int columns)

Fixe le nombre de colonnes d'éléments enfants à columns. Si ce nombre est inférieur à columnCount(), les données contenues dans les colonnes non désirées sont supprimées.

Voir également columnCount() et setRowCount().

[virtual] void QStandardItem::setData(const QVariant &value, int role = Qt::UserRole + 1)

Définit les données de l'élément pour l'adresse role donnée à l'adresse value spécifiée.

Si vous sous-classez QStandardItem et réimplémentez cette fonction, votre réimplémentation doit :

• appeler emitDataChanged() si vous n'appelez pas l'implémentation de base de setData(). Cela garantira que, par exemple, les vues utilisant le modèle seront informées des changements.
• appeler l'implémentation de base pour les rôles que vous ne gérez pas, sinon la définition des drapeaux, par exemple en appelant setFlags(), setCheckable(), setEditable(), etc. ne fonctionnera pas.

Voir aussi Qt::ItemDataRole, data(), et setFlags().

void QStandardItem::setDragEnabled(bool dragEnabled)

Indique si l'élément peut être déplacé. Si dragEnabled est vrai, l'utilisateur peut faire glisser l'élément ; dans le cas contraire, l'utilisateur ne peut pas faire glisser l'élément.

Notez que vous devez également vous assurer que le glissement d'élément est activé dans la vue ; voir QAbstractItemView::dragEnabled.

Voir également isDragEnabled(), setDropEnabled() et setFlags().

void QStandardItem::setDropEnabled(bool dropEnabled)

Définit si l'objet peut être déposé. Si dropEnabled est vrai, l'élément peut être utilisé comme cible de dépôt ; sinon, il ne peut pas l'être.

Notez que vous devez également vous assurer que les dépôts sont activés dans la vue (voir QWidget::acceptDrops()) et que le modèle prend en charge les actions de dépôt souhaitées (voir QAbstractItemModel::supportedDropActions()).

Voir également isDropEnabled(), setDragEnabled() et setFlags().

void QStandardItem::setEditable(bool editable)

Indique si l'élément est modifiable. Si editable est vrai, l'élément peut être modifié par l'utilisateur ; sinon, l'utilisateur ne peut pas modifier l'élément.

La manière dont l'utilisateur peut modifier les éléments d'une vue est déterminée par les déclencheurs de modification de la vue ; voir QAbstractItemView::editTriggers.

Voir également isEditable() et setFlags().

void QStandardItem::setEnabled(bool enabled)

Définit si l'élément est activé. Si enabled est vrai, l'élément est activé, ce qui signifie que l'utilisateur peut interagir avec l'élément ; si enabled est faux, l'utilisateur ne peut pas interagir avec l'élément.

Cet indicateur est prioritaire sur les autres indicateurs d'éléments ; par exemple, si un élément n'est pas activé, il ne peut pas être sélectionné par l'utilisateur, même si l'indicateur Qt::ItemIsSelectable a été activé.

Voir également isEnabled(), Qt::ItemIsEnabled, et setFlags().

void QStandardItem::setFlags(Qt::ItemFlags flags)

Définit les drapeaux de l'élément à flags.

Les indicateurs de l'élément déterminent comment l'utilisateur peut interagir avec l'élément. Cette fonction est souvent utilisée pour désactiver un élément.

Voir également flags() et setData().

void QStandardItem::setFont(const QFont &font)

Définit la police utilisée pour afficher le texte de l'élément à la police donnée font.

Voir aussi font(), setText() et setForeground().

void QStandardItem::setForeground(const QBrush &brush)

Définit la brosse utilisée pour afficher l'avant-plan de l'élément (par exemple, le texte) à l'adresse brush.

Voir aussi foreground(), setBackground() et setFont().

void QStandardItem::setIcon(const QIcon &icon)

Définit l'icône de l'élément à l'adresse icon spécifiée.

Voir aussi icon().

void QStandardItem::setRowCount(int rows)

Fixe le nombre de lignes de l'élément enfant à rows. Si ce nombre est inférieur à rowCount(), les données des lignes non désirées sont supprimées.

Voir également rowCount() et setColumnCount().

void QStandardItem::setSelectable(bool selectable)

Indique si l'élément est sélectionnable. Si selectable est vrai, l'élément peut être sélectionné par l'utilisateur ; dans le cas contraire, l'utilisateur ne peut pas sélectionner l'élément.

Vous pouvez contrôler le comportement et le mode de sélection en manipulant leurs propriétés d'affichage ; voir QAbstractItemView::selectionMode et QAbstractItemView::selectionBehavior.

Voir également isSelectable() et setFlags().

void QStandardItem::setSizeHint(const QSize &size)

Définit l'indice de taille de l'élément à size. Si aucun indice de taille n'est défini, le délégué de l'élément calculera l'indice de taille en fonction des données de l'élément.

Voir également sizeHint().

void QStandardItem::setStatusTip(const QString &statusTip)

Définit l'astuce d'état de l'élément à la chaîne spécifiée par statusTip.

Voir aussi statusTip(), setToolTip() et setWhatsThis().

void QStandardItem::setText(const QString &text)

Définit le texte de l'élément à l'adresse text spécifiée.

Voir aussi text(), setFont() et setForeground().

void QStandardItem::setTextAlignment(Qt::Alignment alignment)

Définit l'alignement du texte de l'élément à l'adresse alignment spécifiée.

Voir aussi textAlignment().

void QStandardItem::setToolTip(const QString &toolTip)

Définit l'info-bulle de l'élément à la chaîne spécifiée par toolTip.

Voir aussi toolTip(), setStatusTip() et setWhatsThis().

void QStandardItem::setUserTristate(bool tristate)

Indique si l'élément est tristable et contrôlé par l'utilisateur. Si tristate est vrai, l'utilisateur peut parcourir trois états distincts ; sinon, l'élément est contrôlable avec deux états. (Il faut également que l'élément soit contrôlable ; voir isCheckable().)

Voir également isUserTristate(), setCheckable() et setCheckState().

void QStandardItem::setWhatsThis(const QString &whatsThis)

Définit l'aide "Qu'est-ce que c'est ?" de l'élément à la chaîne spécifiée par whatsThis.

Voir aussi whatsThis(), setStatusTip() et setToolTip().

QSize QStandardItem::sizeHint() const

Renvoie l'indice de taille défini pour l'élément, ou une adresse QSize invalide si aucun indice de taille n'a été défini.

Si aucun indice de taille n'a été défini, le délégué de l'élément calculera l'indice de taille en fonction des données de l'élément.

Voir également setSizeHint().

void QStandardItem::sortChildren(int column, Qt::SortOrder order = Qt::AscendingOrder)

Trie les enfants de l'élément utilisant l'adresse order, selon les valeurs de l'adresse column.

Voir aussi operator<().

QString QStandardItem::statusTip() const

Renvoie l'avis d'état de l'élément.

Voir aussi setStatusTip(), toolTip() et whatsThis().

QStandardItem *QStandardItem::takeChild(int row, int column = 0)

Supprime l'élément enfant à (row, column) sans l'effacer, et renvoie un pointeur sur l'élément. S'il n'y avait pas d'enfant à l'emplacement donné, cette fonction renvoie nullptr.

Notez que cette fonction, contrairement à takeRow() et takeColumn(), n'affecte pas les dimensions du tableau enfant.

Voir également child(), takeRow() et takeColumn().

QList<QStandardItem *> QStandardItem::takeColumn(int column)

Supprime column sans supprimer les éléments de la colonne et renvoie une liste de pointeurs vers les éléments supprimés. Pour les éléments de la colonne qui n'ont pas été définis, les pointeurs correspondants dans la liste seront nullptr.

Voir également removeColumn(), insertColumn() et takeRow().

QList<QStandardItem *> QStandardItem::takeRow(int row)

Supprime row sans supprimer les éléments de la ligne et renvoie une liste de pointeurs vers les éléments supprimés. Pour les éléments de la ligne qui n'ont pas été définis, les pointeurs correspondants dans la liste seront nullptr.

Voir également removeRow(), insertRow() et takeColumn().

QString QStandardItem::text() const

Renvoie le texte de l'élément. Il s'agit du texte présenté à l'utilisateur dans une vue.

Voir aussi setText().

Qt::Alignment QStandardItem::textAlignment() const

Renvoie l'alignement du texte de l'élément.

Voir aussi setTextAlignment().

QString QStandardItem::toolTip() const

Renvoie l'info-bulle de l'élément.

Voir aussi setToolTip(), statusTip() et whatsThis().

[virtual] int QStandardItem::type() const

Renvoie le type de cet élément. Le type est utilisé pour distinguer les éléments personnalisés de la classe de base. Lorsque vous sous-classez QStandardItem, vous devez réimplémenter cette fonction et renvoyer une nouvelle valeur supérieure ou égale à UserType.

Voir également QStandardItem::Type.

QString QStandardItem::whatsThis() const

Renvoie l'aide "Qu'est-ce que c'est ?" de l'élément.

Voir aussi setWhatsThis(), toolTip() et statusTip().

[virtual] void QStandardItem::write(QDataStream &out) const

Écrit l'élément dans le flux out. Seules les données et les drapeaux de l'élément sont écrits, pas les éléments enfants.

Voir également read().

[virtual] bool QStandardItem::operator<(const QStandardItem &other) const

Renvoie true si cet élément est inférieur à other; sinon, renvoie false.

L'implémentation par défaut utilise les données relatives au rôle de tri de l'élément (voir QStandardItemModel::sortRole) pour effectuer la comparaison si l'élément appartient à un modèle ; sinon, les données relatives au rôle de tri de l'élément Qt::DisplayRole (text()) sont utilisées pour effectuer la comparaison.

sortChildren() et QStandardItemModel::sort() utilisent cette fonction pour trier les éléments. Si vous souhaitez un tri personnalisé, vous pouvez sous-classer QStandardItem et réimplémenter cette fonction.

[protected] QStandardItem &QStandardItem::operator=(const QStandardItem &other)

Attribue les données et les drapeaux de other à cet élément. Notez que type() et model() ne sont pas copiés.

Cette fonction est utile lors de la réimplémentation de clone().