QStandardItem Class

Documentation des fonctions membres

QStandardItem::QStandardItem()

Crée un élément.

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

Crée un élément à partir de l'text on fournie.

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

Crée un élément avec les propriétés « icon » et « text » indiquées.

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

Crée un élément comportant rows lignes et columns colonnes d'éléments enfants.

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

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

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

[virtual noexcept] QStandardItem::~QStandardItem()

Détruit l'élément. Cela entraîne également la destruction de ses éléments enfants.

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 recourir aux moyens d'interaction classiques).

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 recourir aux moyens d'interaction classiques).

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 également 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 également insertRow().

void QStandardItem::appendRow(QStandardItem *item)

Ajoute une ligne contenant item.

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

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

Ajoute des lignes contenant items. Le nombre de colonnes ne changera pas.

Voir également insertRow().

QBrush QStandardItem::background() const

Renvoie le pinceau utilisé pour afficher l'arrière-plan de l'élément.

Voir également foreground() et setBackground().

Qt::CheckState QStandardItem::checkState() const

Renvoie l'état de sélection de l'élément.

Voir également setCheckState() et isCheckable().

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

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

Voir également setChild(), takeChild() et parent().

void QStandardItem::clearData()

Supprime toutes les données associées à 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 éléments enfants de cet élément ne sont pas copiés.

Lorsque vous sous-classez ` QStandardItem`, vous pouvez réimplémenter cette fonction afin de fournir à ` QStandardItemModel ` une fabrique qu’il pourra utiliser pour créer de nouveaux éléments à la demande.

Voir également ` QStandardItemModel::setItemPrototype()` et ` operator=()`.

int QStandardItem::column() const

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

Voir également row() et parent().

int QStandardItem::columnCount() const

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

Voir également setColumnCount() et rowCount().

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

Renvoie les données de l'élément pour l'role donné, ou un QVariant non valide s'il n'existe aucune donnée pour ce rôle.

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

Voir également setData().

[protected] void QStandardItem::emitDataChanged()

Provoque l'émission par le modèle associé à cet élément d'un signal dataChanged() pour cet élément.

En règle générale, vous n'avez besoin d'appeler cette fonction que si vous avez créé une sous-classe de ` QStandardItem ` et réimplémenté ` data()` et/ou ` setData()`.

Voir également setData().

Qt::ItemFlags QStandardItem::flags() const

Renvoie les indicateurs associés à l'élément.

Les indicateurs d'élément déterminent la manière dont l'utilisateur peut interagir avec l'élément.

Par défaut, les éléments sont activés, modifiables, sélectionnables, cochables et peuvent servir à la fois de source et de cible pour une opération de glisser-déposer.

Voir également setFlags().

QFont QStandardItem::font() const

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

Voir aussi setFont().

QBrush QStandardItem::foreground() const

Renvoie le pinceau utilisé pour afficher le premier plan de l'élément (par exemple, du texte).

Voir également setForeground() et background().

bool QStandardItem::hasChildren() const

Renvoie « true » si cet élément possède des enfants ; sinon, renvoie « false ».

Voir également rowCount(), columnCount() et child().

QIcon QStandardItem::icon() const

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

Voir également setIcon() et iconSize.

QModelIndex QStandardItem::index() const

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

Lorsque vous devez invoquer une fonctionnalité d'élément dans une API basée sur l'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, un QModelIndex invalide est renvoyé.

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

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

Insère une colonne à l'adresse 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 count colonnes d'éléments enfants à la colonne column.

Voir également insertColumn() et insertRows().

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

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

Voir également insertRows() et insertColumn().

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

Insère une ligne à l'adresse row contenant item.

Lors de la création d'une liste ou d'une arborescence 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 la table « items » à l'adresse row. Le nombre de colonnes ne sera pas modifié.

Voir également insertRow() et insertColumn().

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

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

Voir également insertRow() et insertColumns().

bool QStandardItem::isAutoTristate() const

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

La valeur par défaut est « false ».

Voir également setAutoTristate(), isCheckable() et checkState().

bool QStandardItem::isCheckable() const

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

La valeur par défaut est « false ».

Voir également setCheckable(), checkState(), isUserTristate() et isAutoTristate().

bool QStandardItem::isDragEnabled() const

Indique si l'élément peut être déplacé par glisser-déposer. Un élément pour lequel cette fonctionnalité est activée peut être déplacé par l'utilisateur.

La valeur par défaut est true.

Notez que le glissement des éléments doit être activé dans la vue pour que cette fonctionnalité fonctionne ; voir QAbstractItemView::dragEnabled.

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

bool QStandardItem::isDropEnabled() const

Indique si l'objet peut recevoir des objets. Lorsqu'un objet peut recevoir des objets, il peut servir de 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 déclenchant l'un des déclencheurs d'édition 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ément, 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 de type « tristate » ; c'est-à-dire s'il peut être coché avec trois états distincts et si l'utilisateur peut passer d'un état à l'autre.

La valeur par défaut est « false ».

Voir également setUserTristate(), isCheckable() et checkState().

QStandardItemModel *QStandardItem::model() const

Renvoie l'QStandardItemModel à laquelle cet élément appartient.

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

Voir aussi index().

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

Remplit la plage « roleDataSpan » avec les données de cet élément.

L'implémentation par défaut appelle simplement la fonction ` data()` pour chaque rôle de la portée.

Cette fonction a été introduite dans Qt 6.0.

Voir également ` data()`.

QStandardItem *QStandardItem::parent() const

Renvoie l'élément parent de l'élément, ou « nullptr » si celui-ci n'a pas de parent.

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

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

Lit l'élément à partir du flux in. Seules les données et les indicateurs de l'élément sont lus, et non ses éléments enfants.

Voir également write().

void QStandardItem::removeColumn(int column)

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

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

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

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

Voir également removeColumn() et removeRows().

void QStandardItem::removeRow(int row)

Supprime l'row on indiquée. Les éléments qui se trouvaient dans la ligne sont supprimés.

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

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

Supprime les lignes count à partir de la ligne row. Les éléments qui figuraient dans ces lignes sont supprimés.

Voir également removeRow() et removeColumn().

int QStandardItem::row() const

Renvoie la ligne 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 également column() et parent().

int QStandardItem::rowCount() const

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

Voir également setRowCount() et columnCount().

void QStandardItem::setAccessibleDescription(const QString &accessibleDescription)

Définit la description accessible de l'élément sur 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 recourir aux moyens d'interaction classiques).

Voir également accessibleDescription() et setAccessibleText().

void QStandardItem::setAccessibleText(const QString &accessibleText)

Définit le texte accessible de l'élément sur 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 recourir aux moyens d'interaction classiques).

Voir également accessibleText() et setAccessibleDescription().

void QStandardItem::setAutoTristate(bool tristate)

Détermine que l'élément est à trois états et contrôlé par QTreeWidget si tristate vaut true. Cela permet la gestion automatique de 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 également isAutoTristate(), setCheckable() et setCheckState().

void QStandardItem::setBackground(const QBrush &brush)

Définit le pinceau d'arrière-plan de l'élément sur l'brush spécifié.

Voir également background() et setForeground().

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

Définit l'état de sélection de l'élément sur « state ».

Voir également checkState() et setCheckable().

void QStandardItem::setCheckable(bool checkable)

Détermine si l'élément peut être coché par l'utilisateur. Si la propriété ` checkable ` est définie sur `true`, l'élément peut être coché par l'utilisateur ; dans le cas contraire, l'utilisateur ne peut pas le cocher.

Le délégué de l'élément affichera un élément cochable 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 situé à l'adresse (row, column) sur item. Cet élément (l'élément parent) devient propriétaire de item. Si nécessaire, le nombre de lignes et de colonnes est augmenté pour s'adapter à cet élément.

Voir également child().

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

Remplace l'élément enfant situé à l'adresse row par item.

void QStandardItem::setColumnCount(int columns)

Définit le nombre de colonnes d'éléments enfants sur columns. Si cette valeur est inférieure à columnCount(), les données des colonnes non souhaitées sont ignoré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'role donné sur la valeur spécifiée value.

Si vous créez une sous-classe de ` 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 soient informées des modifications
• appeler l’implémentation de base pour les rôles que vous ne gérez pas ; sinon, la définition d’indicateurs, par exemple en appelant setFlags(), setCheckable(), setEditable() etc., ne fonctionnera pas.

Voir également Qt::ItemDataRole, data() et setFlags().

void QStandardItem::setDragEnabled(bool dragEnabled)

Détermine si le glissement de l'élément est autorisé. Si la propriété « dragEnabled » est définie sur « true », l'utilisateur peut faire glisser l'élément ; dans le cas contraire, il ne peut pas le faire glisser.

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

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

void QStandardItem::setDropEnabled(bool dropEnabled)

Détermine si l'élément autorise le glisser-déposer. Si la valeur de ` dropEnabled ` est `true`, l'élément peut servir de cible de glisser-déposer ; dans le cas contraire, ce n'est pas possible.

Notez que vous devez également vous assurer que les déposes sont activées 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)

Détermine si l'élément est modifiable. Si la propriété « editable » est définie sur « true », l'utilisateur peut modifier l'élément ; dans le cas contraire, il ne peut pas le modifier.

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

Voir également isEditable() et setFlags().

void QStandardItem::setEnabled(bool enabled)

Détermine si l'élément est activé. Si enabled est à « true », l'élément est activé, ce qui signifie que l'utilisateur peut interagir avec celui-ci ; si enabled est à « false », l'utilisateur ne peut pas interagir avec l'élément.

Cet indicateur a priorité sur les autres indicateurs de l'élément ; 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é défini.

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

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

Définit les indicateurs de l'élément sur « flags ».

Les indicateurs d'élément déterminent la manière dont 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 sur la police spécifiée font.

Voir également font(), setText() et setForeground().

void QStandardItem::setForeground(const QBrush &brush)

Définit le pinceau utilisé pour afficher le premier plan de l'élément (par exemple, du texte) sur l'brush spécifiée.

Voir également foreground(), setBackground() et setFont().

void QStandardItem::setIcon(const QIcon &icon)

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

Voir aussi icon().

void QStandardItem::setRowCount(int rows)

Définit le nombre de lignes d'éléments enfants à rows. Si cette valeur est inférieure à rowCount(), les données des lignes non souhaitées sont ignorées.

Voir également rowCount() et setColumnCount().

void QStandardItem::setSelectable(bool selectable)

Détermine si l'élément est sélectionnable. Si la propriété « selectable » est définie sur « true », l'utilisateur peut sélectionner l'élément ; dans le cas contraire, il ne peut pas le sélectionner.

Vous pouvez contrôler le comportement et le mode de sélection en modifiant les propriétés d’affichage correspondantes ; voir QAbstractItemView::selectionMode et QAbstractItemView::selectionBehavior.

Voir également isSelectable() et setFlags().

void QStandardItem::setSizeHint(const QSize &size)

Définit la valeur indicative de taille de l'élément sur size. Si aucune valeur indicative de taille n'est définie, le délégué de l'élément calculera cette valeur en fonction des données de l'élément.

Voir également sizeHint().

void QStandardItem::setStatusTip(const QString &statusTip)

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

Voir également statusTip(), setToolTip() et setWhatsThis().

void QStandardItem::setText(const QString &text)

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

Voir également text(), setFont() et setForeground().

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

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

Voir également textAlignment().

void QStandardItem::setToolTip(const QString &toolTip)

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

Voir également toolTip(), setStatusTip() et setWhatsThis().

void QStandardItem::setUserTristate(bool tristate)

Détermine si l'élément est à trois états et contrôlé par l'utilisateur. Si tristate est défini sur « true », l'utilisateur peut passer d'un état à l'autre parmi les trois états disponibles ; dans le cas contraire, l'élément est cochable et ne comporte que deux états. (Notez que cela nécessite également que l'élément soit cochable ; 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 sur la chaîne spécifiée par whatsThis.

Voir également whatsThis(), setStatusTip() et setToolTip().

QSize QStandardItem::sizeHint() const

Renvoie l'indicateur de taille défini pour l'élément, ou une valeur « QSize » (non valide) si aucun indicateur de taille n'a été défini.

Si aucune indication de taille n’a été définie, le délégué de l’élément calculera l’indication 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 à l'aide de l'order fournie, selon les valeurs contenues dans l'column fournie.

Voir également operator<().

QString QStandardItem::statusTip() const

Renvoie l'info-bulle relative au statut de l'élément.

Voir également setStatusTip(), toolTip() et whatsThis().

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

Supprime l'élément enfant situé à l'adresse (row, column) sans le supprimer, et renvoie un pointeur vers cet élément. S'il n'y avait pas d'élément enfant à l'emplacement indiqué, cette fonction renvoie nullptr.

Notez que cette fonction, contrairement à ` takeRow()` et ` takeColumn()`, n’affecte pas les dimensions de la table enfant.

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

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

Supprime column sans effacer 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 effacer 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 affiché à l'utilisateur dans une vue.

Voir également 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 également setToolTip(), statusTip() et whatsThis().

[virtual] int QStandardItem::type() const

Renvoie le type de cet élément. Ce type sert à distinguer les éléments personnalisés de la classe de base. Lorsque vous créez une sous-classe de ` 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 également 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 indicateurs de l'élément sont écrits, et non ses é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, ce sont les données relatives au Qt::DisplayRole de l’élément (text()) qui sont utilisées pour effectuer la comparaison.

sortChildren() et QStandardItemModel::sort() utilisent cette fonction lors du tri des éléments. Si vous souhaitez un tri personnalisé, vous pouvez créer une sous-classe de QStandardItem et réimplémenter cette fonction.

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

Attribue les données et les indicateurs 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()`.