Auf dieser Seite

QStandardItem Class

Die Klasse „QStandardItem“ stellt ein Element zur Verwendung mit der Klasse „ QStandardItemModel “ bereit. Mehr...

Header: #include <QStandardItem>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui

Öffentliche Typen

enum ItemType { Type, UserType }

Öffentliche Funktionen

QStandardItem()
QStandardItem(const QString &text)
QStandardItem(const QIcon &icon, const QString &text)
QStandardItem(int rows, int columns = 1)
virtual ~QStandardItem()
QString accessibleDescription() const
QString accessibleText() const
void appendColumn(const QList<QStandardItem *> &items)
void appendRow(const QList<QStandardItem *> &items)
void appendRow(QStandardItem *item)
void appendRows(const QList<QStandardItem *> &items)
QBrush background() const
Qt::CheckState checkState() const
QStandardItem *child(int row, int column = 0) const
void clearData()
virtual QStandardItem *clone() const
int column() const
int columnCount() const
virtual QVariant data(int role = Qt::UserRole + 1) const
Qt::ItemFlags flags() const
QFont font() const
QBrush foreground() const
bool hasChildren() const
QIcon icon() const
QModelIndex index() const
void insertColumn(int column, const QList<QStandardItem *> &items)
void insertColumns(int column, int count)
void insertRow(int row, const QList<QStandardItem *> &items)
void insertRow(int row, QStandardItem *item)
void insertRows(int row, const QList<QStandardItem *> &items)
void insertRows(int row, int count)
bool isAutoTristate() const
bool isCheckable() const
bool isDragEnabled() const
bool isDropEnabled() const
bool isEditable() const
bool isEnabled() const
bool isSelectable() const
bool isUserTristate() const
QStandardItemModel *model() const
(since 6.0) virtual void multiData(QModelRoleDataSpan roleDataSpan) const
QStandardItem *parent() const
virtual void read(QDataStream &in)
void removeColumn(int column)
void removeColumns(int column, int count)
void removeRow(int row)
void removeRows(int row, int count)
int row() const
int rowCount() const
void setAccessibleDescription(const QString &accessibleDescription)
void setAccessibleText(const QString &accessibleText)
void setAutoTristate(bool tristate)
void setBackground(const QBrush &brush)
void setCheckState(Qt::CheckState state)
void setCheckable(bool checkable)
void setChild(int row, int column, QStandardItem *item)
void setChild(int row, QStandardItem *item)
void setColumnCount(int columns)
virtual void setData(const QVariant &value, int role = Qt::UserRole + 1)
void setDragEnabled(bool dragEnabled)
void setDropEnabled(bool dropEnabled)
void setEditable(bool editable)
void setEnabled(bool enabled)
void setFlags(Qt::ItemFlags flags)
void setFont(const QFont &font)
void setForeground(const QBrush &brush)
void setIcon(const QIcon &icon)
void setRowCount(int rows)
void setSelectable(bool selectable)
void setSizeHint(const QSize &size)
void setStatusTip(const QString &statusTip)
void setText(const QString &text)
void setTextAlignment(Qt::Alignment alignment)
void setToolTip(const QString &toolTip)
void setUserTristate(bool tristate)
void setWhatsThis(const QString &whatsThis)
QSize sizeHint() const
void sortChildren(int column, Qt::SortOrder order = Qt::AscendingOrder)
QString statusTip() const
QStandardItem *takeChild(int row, int column = 0)
QList<QStandardItem *> takeColumn(int column)
QList<QStandardItem *> takeRow(int row)
QString text() const
Qt::Alignment textAlignment() const
QString toolTip() const
virtual int type() const
QString whatsThis() const
virtual void write(QDataStream &out) const
virtual bool operator<(const QStandardItem &other) const

Geschützte Funktionen

QStandardItem(const QStandardItem &other)
void emitDataChanged()
QStandardItem &operator=(const QStandardItem &other)
QDataStream &operator<<(QDataStream &out, const QStandardItem &item)
QDataStream &operator>>(QDataStream &in, QStandardItem &item)

Ausführliche Beschreibung

Elemente enthalten in der Regel Text, Symbole oder Kontrollkästchen.

Jedes Element kann einen eigenen Hintergrundpinsel haben, der mit der Funktion „ setBackground()“ festgelegt wird. Der aktuelle Hintergrundpinsel kann mit „ background()“ abgerufen werden. Die Textbeschriftung für jedes Element kann mit einer eigenen Schriftart und einem eigenen Pinsel dargestellt werden. Diese werden mit den Funktionen „ setFont()“ und „ setForeground()“ festgelegt und mit „ font()“ und „ foreground()“ ausgelesen.

Standardmäßig sind Elemente aktiviert, bearbeitbar, auswählbar, markierbar und können sowohl als Quelle für eine Drag-and-Drop-Operation als auch als Ablageziel verwendet werden. Die Flags jedes Elements können durch Aufruf von ` setFlags()` geändert werden. Markierbare Elemente können mit der Funktion ` setCheckState()` markiert und die Markierung wieder aufgehoben werden. Die entsprechende Funktion ` checkState()` gibt an, ob das Element derzeit markiert ist.

Sie können anwendungsspezifische Daten in einem Element speichern, indem Sie ` setData()` aufrufen.

Jedes Element kann eine zweidimensionale Tabelle mit untergeordneten Elementen besitzen. Dies ermöglicht den Aufbau von Elementhierarchien. Die typische Hierarchie ist der Baum; in diesem Fall ist die untergeordnete Tabelle eine einspaltige Tabelle (eine Liste).

Die Dimensionen der Unterelementtabelle lassen sich mit ` setRowCount()` und ` setColumnCount()` festlegen. Elemente können mit ` setChild()` in der Unterelementtabelle positioniert werden. Mit ` child()` erhält man einen Zeiger auf ein untergeordnetes Element. Neue Zeilen und Spalten mit untergeordneten Elementen können außerdem mit ` insertRow()` und ` insertColumn()` eingefügt oder mit ` appendRow()` und ` appendColumn()` angehängt werden. Bei Verwendung der Funktionen zum Anhängen und Einfügen wird die untergeordnete Tabelle nach Bedarf erweitert.

Eine vorhandene Zeile mit untergeordneten Elementen kann mit ` removeRow()` oder ` takeRow()` entfernt werden; entsprechend kann eine Spalte mit ` removeColumn()` oder ` takeColumn()` entfernt werden.

Die untergeordneten Elemente eines Elements können durch Aufruf von ` sortChildren()` sortiert werden.

Unterklassenbildung

Bei der Unterklassenbildung von `QStandardItem` zur Bereitstellung benutzerdefinierter Elemente ist es möglich, neue Typen für diese zu definieren, damit sie von der Basisklasse unterschieden werden können. Die Funktion ` type()` sollte neu implementiert werden, um einen Wert eines neuen Typs zurückzugeben, der gleich oder größer als ` UserType` ist.

Implementieren Sie „ data()“ und „ setData()“ neu, wenn Sie Datenabfragen benutzerdefiniert verarbeiten und/oder steuern möchten, wie die Daten eines Elements dargestellt werden.

Implementieren Sie ` clone()` neu, wenn Sie möchten, dass ` QStandardItemModel ` bei Bedarf Instanzen Ihrer benutzerdefinierten Elementklasse erstellen kann (siehe ` QStandardItemModel::setItemPrototype()`).

Implementieren Sie „ read()“ und „ write()“ neu, wenn Sie steuern möchten, wie Elemente in ihrer serialisierten Form dargestellt werden.

Implementieren Sie ` operator<()` neu, wenn Sie die Semantik des Elementvergleichs steuern möchten. ` operator<()` bestimmt die Sortierreihenfolge beim Sortieren von Elementen mit ` sortChildren()` oder mit ` QStandardItemModel::sort()`.

Siehe auch ` QStandardItemModel`, Hilfsklassen für die Elementansicht und Modell-/Ansichtsprogrammierung.

Dokumentation zu Mitgliedstypen

enum QStandardItem::ItemType

Diese Enumeration beschreibt die Typen, die zur Beschreibung von Standardelementen verwendet werden.

KonstanteWertBeschreibung
QStandardItem::Type0Der Standardtyp für Standardelemente.
QStandardItem::UserType1000Der Mindestwert für benutzerdefinierte Typen. Werte unterhalb von „UserType“ sind von Qt reserviert.

Sie können neue Benutzertypen in Unterklassen von ` QStandardItem ` definieren, um sicherzustellen, dass benutzerdefinierte Elemente besonders behandelt werden, beispielsweise beim Sortieren von Elementen.

Siehe auch „ type()“.

Dokumentation der Mitgliedsfunktionen

QStandardItem::QStandardItem()

Erstellt ein Element.

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

Erstellt ein Element mit dem angegebenen „ text “.

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

Erstellt ein Element mit den angegebenen Werten „ icon “ und „ text “.

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

Erstellt ein Element mit rows Zeilen und columns Spalten mit untergeordneten Elementen.

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

Erstellt eine Kopie von ` other`. Beachten Sie, dass ` model()` nicht kopiert wird.

Diese Funktion ist nützlich, wenn Sie ` clone()` neu implementieren.

[virtual noexcept] QStandardItem::~QStandardItem()

Zerstört das Element. Dadurch werden auch die untergeordneten Elemente des Elements zerstört.

QString QStandardItem::accessibleDescription() const

Gibt die barrierefreie Beschreibung des Elements zurück.

Die barrierefreie Beschreibung wird von assistiven Technologien verwendet (d. h. für Benutzer, die herkömmliche Interaktionsmöglichkeiten nicht nutzen können).

Siehe auch „ setAccessibleDescription “ () und „ accessibleText “ ().

QString QStandardItem::accessibleText() const

Gibt den barrierefreien Text des Elements zurück.

Der barrierefreie Text wird von assistiven Technologien verwendet (d. h. für Benutzer, die herkömmliche Interaktionsmöglichkeiten nicht nutzen können).

Siehe auch setAccessibleText() und accessibleDescription().

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

Fügt eine Spalte hinzu, die „ items “ enthält. Falls erforderlich, wird die Zeilenanzahl auf die Größe von „ items “ erhöht.

Siehe auch insertColumn().

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

Fügt eine Zeile hinzu, die „ items “ enthält. Falls erforderlich, wird die Spaltenanzahl auf die Größe von „ items “ erhöht.

Siehe auch insertRow().

void QStandardItem::appendRow(QStandardItem *item)

Fügt eine Zeile hinzu, die „ item “ enthält.

Beim Erstellen einer Liste oder eines Baums mit nur einer Spalte bietet diese Funktion eine bequeme Möglichkeit, ein einzelnes neues Element anzuhängen.

Dies ist eine überladene Funktion.

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

Fügt Zeilen hinzu, die „ items “ enthalten. Die Anzahl der Spalten ändert sich nicht.

Siehe auch ` insertRow()`.

QBrush QStandardItem::background() const

Gibt den Pinsel zurück, der zum Rendern des Hintergrunds des Elements verwendet wurde.

Siehe auch foreground() und setBackground().

Qt::CheckState QStandardItem::checkState() const

Gibt den Markierungsstatus des Elements zurück.

Siehe auch setCheckState() und isCheckable().

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

Gibt das untergeordnete Element unter (row, column) zurück, sofern eines festgelegt wurde; andernfalls wird nullptr zurückgegeben.

Siehe auch setChild(), takeChild() und parent().

void QStandardItem::clearData()

Löscht alle Daten aus allen zuvor festgelegten Rollen.

Siehe auch data() und setData().

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

Gibt eine Kopie dieses Elements zurück. Die untergeordneten Elemente des Elements werden nicht kopiert.

Wenn Sie eine Unterklasse von ` QStandardItem` erstellen, können Sie diese Funktion neu implementieren, um ` QStandardItemModel ` eine Factory zur Verfügung zu stellen, mit der neue Elemente bei Bedarf erstellt werden können.

Siehe auch ` QStandardItemModel::setItemPrototype()` und ` operator=()`.

int QStandardItem::column() const

Gibt die Spalte zurück, in der sich das Element in der untergeordneten Tabelle seines übergeordneten Elements befindet, oder -1, wenn das Element kein übergeordnetes Element hat.

Siehe auch row() und parent().

int QStandardItem::columnCount() const

Gibt die Anzahl der Spalten der untergeordneten Elemente des Elements zurück.

Siehe auch „ setColumnCount()“ und „ rowCount()“.

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

Gibt die Daten des Elements für die angegebene Rolle ` role` zurück oder einen ungültigen Wert ` QVariant `, falls keine Daten für die Rolle vorliegen.

Wenn Sie diese Funktion neu implementieren, sollte Ihre Neuanwendung für Rollen, die Sie nicht behandeln, die Basisimplementierung aufrufen; andernfalls funktioniert das Abrufen von Flags, z. B. durch Aufruf von ` flags()`, ` isCheckable()`, ` isEditable()` usw., nicht.

Hinweis: Die Standardimplementierung behandelt Qt::EditRole und Qt::DisplayRole so, als würden sie auf dieselben Daten verweisen.

Siehe auch setData().

[protected] void QStandardItem::emitDataChanged()

Bewirkt, dass das diesem Element zugeordnete Modell ein Signal „ dataChanged()“ für dieses Element aussendet.

Normalerweise müssen Sie diese Funktion nur aufrufen, wenn Sie eine Unterklasse von ` QStandardItem ` erstellt und die Methoden ` data()` und/oder ` setData()` neu implementiert haben.

Siehe auch ` setData()`.

Qt::ItemFlags QStandardItem::flags() const

Gibt die Element-Flags für das Element zurück.

Die Elementflags legen fest, wie der Benutzer mit dem Element interagieren kann.

Standardmäßig sind Elemente aktiviert, bearbeitbar, auswählbar, ankreuzbar und können sowohl als Quelle für einen Drag-and-Drop-Vorgang als auch als Ablageziel verwendet werden.

Siehe auch „ setFlags()“.

QFont QStandardItem::font() const

Gibt die Schriftart zurück, die zum Darstellen des Textes des Elements verwendet wird.

Siehe auch setFont().

QBrush QStandardItem::foreground() const

Gibt den Pinsel zurück, der zum Zeichnen des Vordergrunds des Elements (z. B. Text) verwendet wurde.

Siehe auch setForeground() und background().

bool QStandardItem::hasChildren() const

Gibt „ true “ zurück, wenn dieses Element Unterelemente hat; andernfalls wird „ false “ zurückgegeben.

Siehe auch „ rowCount()“, „ columnCount()“ und „ child()“.

QIcon QStandardItem::icon() const

Gibt das Symbol des Elements zurück.

Siehe auch setIcon() und iconSize.

QModelIndex QStandardItem::index() const

Gibt den mit diesem Element verknüpften „ QModelIndex “ zurück.

Wenn Sie Elementfunktionen in einer auf „ QModelIndex “ basierenden API (z. B. QAbstractItemView) aufrufen müssen, können Sie diese Funktion aufrufen, um einen Index zu erhalten, der der Position des Elements im Modell entspricht.

Ist das Element keinem Modell zugeordnet, wird ein ungültiges „ QModelIndex “ zurückgegeben.

Siehe auch model() und QStandardItemModel::itemFromIndex().

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

Fügt eine Spalte an der Position column ein, die den Wert items enthält. Falls erforderlich, wird die Anzahl der Zeilen auf die Größe von items erhöht.

Siehe auch insertColumns() und insertRow().

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

Fügt count Spalten mit untergeordneten Elementen in Spalte column ein.

Siehe auch insertColumn() und insertRows().

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

Fügt eine Zeile an der Position row ein, die den Wert items enthält. Falls erforderlich, wird die Spaltenanzahl auf die Größe von items erhöht.

Siehe auch insertRows() und insertColumn().

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

Fügt an der Position ` row ` eine Zeile mit dem Wert ` item` ein.

Beim Erstellen einer Liste oder eines Baums, der nur eine Spalte enthält, bietet diese Funktion eine bequeme Möglichkeit, ein einzelnes neues Element einzufügen.

Dies ist eine überladene Funktion.

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

Fügt „ items “ unter row ein. Die Anzahl der Spalten wird dabei nicht geändert.

Siehe auch insertRow() und insertColumn().

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

Fügt count Zeilen mit untergeordneten Elementen in Zeile row ein.

Siehe auch insertRow() und insertColumns().

bool QStandardItem::isAutoTristate() const

Gibt zurück, ob das Element im Tristate-Modus ist und von „ QTreeWidget “ gesteuert wird.

Der Standardwert ist „false“.

Siehe auch „ setAutoTristate()“, „ isCheckable()“ und „ checkState()“.

bool QStandardItem::isCheckable() const

Gibt zurück, ob das Element vom Benutzer überprüft werden kann.

Der Standardwert ist „false“.

Siehe auch setCheckable(), checkState(), isUserTristate() und isAutoTristate().

bool QStandardItem::isDragEnabled() const

Gibt zurück, ob das Element per Drag & Drop verschoben werden kann. Ein Element, das per Drag & Drop verschoben werden kann, lässt sich vom Benutzer verschieben.

Der Standardwert ist „true“.

Beachten Sie, dass das Ziehen von Elementen in der Ansicht aktiviert sein muss, damit das Ziehen funktioniert; siehe QAbstractItemView::dragEnabled.

Siehe auch setDragEnabled(), isDropEnabled() und flags().

bool QStandardItem::isDropEnabled() const

Gibt zurück, ob das Element per Drag & Drop verschoben werden kann. Wenn ein Element per Drag & Drop verschoben werden kann, kann es als Ziel für Drag & Drop verwendet werden.

Der Standardwert ist „true“.

Siehe auch „ setDropEnabled()“, „ isDragEnabled()“ und „ flags()“.

bool QStandardItem::isEditable() const

Gibt zurück, ob das Element vom Benutzer bearbeitet werden kann.

Wenn ein Element bearbeitbar (und aktiviert) ist, kann der Benutzer das Element bearbeiten, indem er einen der Bearbeitungstrigger der Ansicht auslöst; siehe QAbstractItemView::editTriggers.

Der Standardwert ist „true“.

Siehe auch setEditable() und flags().

bool QStandardItem::isEnabled() const

Gibt zurück, ob das Element aktiviert ist.

Wenn ein Element aktiviert ist, kann der Benutzer damit interagieren. Die möglichen Interaktionsarten werden durch die anderen Element-Flags festgelegt, wie z. B. „ isEditable()“ und „ isSelectable()“.

Der Standardwert ist „true“.

Siehe auch ` setEnabled()` und ` flags()`.

bool QStandardItem::isSelectable() const

Gibt zurück, ob das Element vom Benutzer ausgewählt werden kann.

Der Standardwert ist „true“.

Siehe auch „ setSelectable()“ und „ flags()“.

bool QStandardItem::isUserTristate() const

Gibt zurück, ob das Element einen Tristate-Status hat, d. h., ob es drei verschiedene Zustände annehmen kann und der Benutzer zwischen allen drei Zuständen wechseln kann.

Der Standardwert ist „false“.

Siehe auch „ setUserTristate()“, „ isCheckable()“ und „ checkState()“.

QStandardItemModel *QStandardItem::model() const

Gibt die „ QStandardItemModel “ zurück, zu der dieses Element gehört.

Wenn das Element kein untergeordnetes Element eines anderen Elements ist, das zum Modell gehört, gibt diese Funktion „ nullptr “ zurück.

Siehe auch ` index()` .

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

Füllt den Bereich „ roleDataSpan “ mit den Daten dieses Elements.

Die Standardimplementierung ruft einfach für jede Rolle im Bereich „ data “ () auf.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch ` data()`.

QStandardItem *QStandardItem::parent() const

Gibt das übergeordnete Element des Elements zurück oder „ nullptr “, falls das Element kein übergeordnetes Element hat.

Hinweis: Bei Elementen der obersten Ebene gibt `parent()` ` nullptr` zurück. Um das übergeordnete Element eines Elements der obersten Ebene zu erhalten, verwenden Sie stattdessen ` QStandardItemModel::invisibleRootItem()`.

Siehe auch ` child()` und ` QStandardItemModel::invisibleRootItem()`.

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

Liest das Element aus dem Stream in aus. Es werden nur die Daten und Flags des Elements gelesen, nicht die untergeordneten Elemente.

Siehe auch write().

void QStandardItem::removeColumn(int column)

Entfernt die angegebene Spalte „ column “. Die Elemente, die sich in dieser Spalte befanden, werden gelöscht.

Siehe auch takeColumn(), removeColumns() und removeRow().

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

Entfernt die Spalten „ count “ an der Spalte „ column “. Die Elemente, die sich in diesen Spalten befanden, werden gelöscht.

Siehe auch ` removeColumn()` und ` removeRows()`.

void QStandardItem::removeRow(int row)

Entfernt die angegebene „ row “. Die Elemente, die sich in der Zeile befanden, werden gelöscht.

Siehe auch takeRow(), removeRows() und removeColumn().

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

Entfernt die Zeilen „ count “ an der Zeilen row. Die Elemente, die sich in diesen Zeilen befanden, werden gelöscht.

Siehe auch „ removeRow()“ und „ removeColumn()“.

int QStandardItem::row() const

Gibt die Zeile zurück, in der sich das Element in der untergeordneten Tabelle seines übergeordneten Elements befindet, oder -1, wenn das Element kein übergeordnetes Element hat.

Siehe auch „ column()“ und „ parent()“.

int QStandardItem::rowCount() const

Gibt die Anzahl der untergeordneten Elementzeilen zurück, die das Element enthält.

Siehe auch „ setRowCount()“ und „ columnCount()“.

void QStandardItem::setAccessibleDescription(const QString &accessibleDescription)

Setzt die barrierefreie Beschreibung des Elements auf die Zeichenkette, die unter accessibleDescription angegeben ist.

Die barrierefreie Beschreibung wird von assistiven Technologien verwendet (d. h. für Benutzer, die herkömmliche Interaktionsmöglichkeiten nicht nutzen können).

Siehe auch accessibleDescription() und setAccessibleText().

void QStandardItem::setAccessibleText(const QString &accessibleText)

Setzt den barrierefreien Text des Elements auf die Zeichenfolge, die unter „ accessibleText “ angegeben ist.

Der barrierefreie Text wird von assistiven Technologien verwendet (d. h. für Benutzer, die herkömmliche Interaktionsmöglichkeiten nicht nutzen können).

Siehe auch accessibleText() und setAccessibleDescription().

void QStandardItem::setAutoTristate(bool tristate)

Legt fest, dass das Element einen dreistufigen Status hat und von „ QTreeWidget “ gesteuert wird, sofern „ tristate “ auf „ true “ gesetzt ist. Dies ermöglicht die automatische Verwaltung des Status übergeordneter Elemente in „ QTreeWidget “ (markiert, wenn alle untergeordneten Elemente markiert sind; nicht markiert, wenn alle untergeordneten Elemente nicht markiert sind; oder teilweise markiert, wenn nur einige untergeordnete Elemente markiert sind).

Siehe auch isAutoTristate(), setCheckable() und setCheckState().

void QStandardItem::setBackground(const QBrush &brush)

Setzt den Hintergrundpinsel des Elements auf den angegebenen „ brush “.

Siehe auch „ background()“ und „ setForeground()“.

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

Setzt den Markierungsstatus des Elements auf „ state “.

Siehe auch „ checkState()“ und „ setCheckable()“.

void QStandardItem::setCheckable(bool checkable)

Legt fest, ob das Element vom Benutzer markiert werden kann. Ist „ checkable “ auf „true“ gesetzt, kann das Element vom Benutzer markiert werden; andernfalls ist dies nicht möglich.

Der Element-Delegat rendert ein ankreuzbares Element mit einem Kontrollkästchen neben dem Text des Elements.

Siehe auch „ isCheckable()“, „ setCheckState()“, „ setUserTristate()“ und „ setAutoTristate()“.

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

Setzt das untergeordnete Element unter (row, column) auf item. Dieses Element (das übergeordnete Element) übernimmt die Verantwortung für item. Falls erforderlich, werden die Anzahl der Zeilen und Spalten erhöht, um Platz für das Element zu schaffen.

Hinweis: Durch die Übergabe von ` nullptr ` als ` item ` wird das Element entfernt.

Siehe auch child().

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

Setzt das untergeordnete Element unter row auf item.

Dies ist eine überladene Funktion.

void QStandardItem::setColumnCount(int columns)

Legt die Anzahl der Spalten für untergeordnete Elemente auf „ columns “ fest. Ist dieser Wert kleiner als „ columnCount()“, werden die Daten in den nicht benötigten Spalten verworfen.

Siehe auch „ columnCount()“ und „ setRowCount()“.

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

Setzt die Daten des Elements für die angegebene ` role ` auf die angegebene ` value` zurück.

Wenn Sie eine Unterklasse von ` QStandardItem ` erstellen und diese Funktion neu implementieren, sollte Ihre Neuimplementierung Folgendes tun:

  • emitDataChanged() aufrufen, wenn Sie die Basisimplementierung von setData() nicht aufrufen. Dadurch wird sichergestellt, dass z. B. Ansichten, die das Modell verwenden, über die Änderungen informiert werden
  • die Basisimplementierung für Rollen aufrufen, die Sie nicht selbst behandeln; andernfalls funktioniert das Setzen von Flags – z. B. durch Aufruf von ` setFlags()`, ` setCheckable()`, ` setEditable()` usw. – nicht.

Hinweis: Die Standardimplementierung behandelt Qt::EditRole und Qt::DisplayRole so, als würden sie sich auf dieselben Daten beziehen.

Siehe auch Qt::ItemDataRole, data() und setFlags().

void QStandardItem::setDragEnabled(bool dragEnabled)

Legt fest, ob das Element per Drag & Drop verschoben werden kann. Ist „ dragEnabled “ auf „true“ gesetzt, kann das Element vom Benutzer per Drag & Drop verschoben werden; andernfalls ist dies nicht möglich.

Beachten Sie, dass Sie außerdem sicherstellen müssen, dass das Ziehen von Elementen in der Ansicht aktiviert ist; siehe QAbstractItemView::dragEnabled.

Siehe auch „ isDragEnabled()“, „ setDropEnabled()“ und „ setFlags()“.

void QStandardItem::setDropEnabled(bool dropEnabled)

Legt fest, ob das Element für das Ablegen von Elementen freigegeben ist. Ist „ dropEnabled “ auf „true“ gesetzt, kann das Element als Ziel für das Ablegen verwendet werden; andernfalls ist dies nicht möglich.

Beachten Sie, dass Sie außerdem sicherstellen müssen, dass das Ablegen in der Ansicht aktiviert ist; siehe QWidget::acceptDrops(); und dass das Modell die gewünschten Ablegeaktionen unterstützt; siehe QAbstractItemModel::supportedDropActions().

Siehe auch isDropEnabled(), setDragEnabled() und setFlags().

void QStandardItem::setEditable(bool editable)

Legt fest, ob das Element bearbeitbar ist. Ist „ editable “ auf „true“ gesetzt, kann das Element vom Benutzer bearbeitet werden; andernfalls kann der Benutzer das Element nicht bearbeiten.

Wie der Benutzer Elemente in einer Ansicht bearbeiten kann, wird durch die Bearbeitungsauslöser der Ansicht bestimmt; siehe QAbstractItemView::editTriggers.

Siehe auch „ isEditable()“ und „ setFlags()“.

void QStandardItem::setEnabled(bool enabled)

Legt fest, ob das Element aktiviert ist. Ist „ enabled “ auf „true“ gesetzt, ist das Element aktiviert, d. h., der Benutzer kann mit dem Element interagieren; ist „ enabled “ auf „false“ gesetzt, kann der Benutzer nicht mit dem Element interagieren.

Dieses Flag hat Vorrang vor den anderen Element-Flags; wenn ein Element beispielsweise nicht aktiviert ist, kann es vom Benutzer nicht ausgewählt werden, selbst wenn das Flag „ Qt::ItemIsSelectable “ gesetzt wurde.

Siehe auch isEnabled(), Qt::ItemIsEnabled und setFlags().

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

Setzt die Element-Flags für das Element auf „ flags “.

Die Elementflags legen fest, wie der Benutzer mit dem Element interagieren kann. Diese Funktion wird häufig verwendet, um ein Element zu deaktivieren.

Siehe auch „ flags()“ und „ setData()“.

void QStandardItem::setFont(const QFont &font)

Legt die Schriftart fest, die zur Anzeige des Textes des Elements verwendet wird, und zwar auf die angegebene font.

Siehe auch font(), setText() und setForeground().

void QStandardItem::setForeground(const QBrush &brush)

Legt den Pinsel fest, der zur Darstellung des Vordergrunds des Elements (z. B. Text) verwendet wird, auf den angegebenen „ brush “.

Siehe auch „ foreground()“, „ setBackground()“ und „ setFont()“.

void QStandardItem::setIcon(const QIcon &icon)

Legt das Symbol des Elements auf das angegebene „ icon “ fest.

Siehe auch ` icon()`.

void QStandardItem::setRowCount(int rows)

Legt die Anzahl der Zeilen für untergeordnete Elemente auf „ rows “ fest. Liegt dieser Wert unter „ rowCount()“, werden die Daten in den nicht benötigten Zeilen verworfen.

Siehe auch rowCount() und setColumnCount().

void QStandardItem::setSelectable(bool selectable)

Legt fest, ob das Element auswählbar ist. Wenn „ selectable “ auf „true“ gesetzt ist, kann das Element vom Benutzer ausgewählt werden; andernfalls kann der Benutzer das Element nicht auswählen.

Sie können das Auswahlverhalten und den Auswahlmodus durch Anpassen der entsprechenden Ansichtseigenschaften steuern; siehe „ QAbstractItemView::selectionMode “ und „ QAbstractItemView::selectionBehavior “.

Siehe auch „ isSelectable()“ und „ setFlags()“.

void QStandardItem::setSizeHint(const QSize &size)

Legt den Größenhinweis für das Element fest, der unter size zu finden ist. Wenn kein Größenhinweis festgelegt ist, berechnet der Element-Delegat den Größenhinweis auf der Grundlage der Elementdaten.

Siehe auch ` sizeHint()`.

void QStandardItem::setStatusTip(const QString &statusTip)

Setzt den Status-Hinweis des Elements auf die Zeichenkette, die unter statusTip angegeben ist.

Siehe auch statusTip(), setToolTip() und setWhatsThis().

void QStandardItem::setText(const QString &text)

Setzt den Text des Elements auf den angegebenen text.

Siehe auch „ text()“, „ setFont()“ und „ setForeground()“.

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

Legt die Textausrichtung für den Text des Elements auf die angegebene „ alignment “ fest.

Siehe auch textAlignment().

void QStandardItem::setToolTip(const QString &toolTip)

Setzt den Tooltip des Elements auf die Zeichenkette, die unter toolTip angegeben ist.

Siehe auch „ toolTip()“, „ setStatusTip()“ und „ setWhatsThis()“.

void QStandardItem::setUserTristate(bool tristate)

Legt fest, ob das Element einen dreistufigen Status hat und vom Benutzer gesteuert wird. Ist „ tristate “ auf „true“ gesetzt, kann der Benutzer zwischen drei verschiedenen Zuständen wechseln; andernfalls ist das Element mit zwei Zuständen ankreuzbar. (Beachten Sie, dass hierfür außerdem erforderlich ist, dass das Element ankreuzbar ist; siehe „ isCheckable “ ().)

Siehe auch isUserTristate(), setCheckable() und setCheckState().

void QStandardItem::setWhatsThis(const QString &whatsThis)

Setzt die „Was ist das?“-Hilfe des Elements auf die Zeichenfolge, die unter whatsThis angegeben ist.

Siehe auch whatsThis(), setStatusTip() und setToolTip().

QSize QStandardItem::sizeHint() const

Gibt den für das Element festgelegten Größenhinweis zurück oder einen ungültigen ` QSize `, falls kein Größenhinweis festgelegt wurde.

Wenn kein Größenhinweis festgelegt wurde, berechnet der Element-Delegat den Größenhinweis auf der Grundlage der Elementdaten.

Siehe auch ` setSizeHint()`.

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

Sortiert die untergeordneten Elemente des Elements anhand des angegebenen „ order “ nach den Werten in der angegebenen „ column “.

Hinweis: Diese Funktion ist rekursiv, d. h., sie sortiert die Kinder des Elements, deren Enkelkinder usw.

Siehe auch ` operator<()`.

QString QStandardItem::statusTip() const

Gibt den Statushinweis des Elements zurück.

Siehe auch setStatusTip(), toolTip() und whatsThis().

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

Entfernt das untergeordnete Element an der Position (row, column), ohne es zu löschen, und gibt einen Zeiger auf das Element zurück. Wenn an der angegebenen Position kein untergeordnetes Element vorhanden war, gibt diese Funktion „ nullptr “ zurück.

Beachten Sie, dass diese Funktion im Gegensatz zu takeRow() und takeColumn() keinen Einfluss auf die Dimensionen der untergeordneten Tabelle hat.

Siehe auch child(), takeRow() und takeColumn().

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

Entfernt „ column “, ohne die Spaltenelemente zu löschen, und gibt eine Liste mit Zeigern auf die entfernten Elemente zurück. Für Elemente in der Spalte, die nicht gesetzt wurden, lauten die entsprechenden Zeiger in der Liste „ nullptr “.

Siehe auch „ removeColumn()“, „ insertColumn()“ und „ takeRow()“.

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

Entfernt row, ohne die Elemente der Zeile zu löschen, und gibt eine Liste mit Zeigern auf die entfernten Elemente zurück. Für Elemente in der Zeile, die nicht gesetzt wurden, sind die entsprechenden Zeiger in der Liste nullptr.

Siehe auch „ removeRow()“, „ insertRow()“ und „ takeColumn()“.

QString QStandardItem::text() const

Gibt den Text des Elements zurück. Dies ist der Text, der dem Benutzer in einer Ansicht angezeigt wird.

Siehe auch ` setText()`.

Qt::Alignment QStandardItem::textAlignment() const

Gibt die Textausrichtung für den Text des Elements zurück.

Siehe auch ` setTextAlignment()`.

QString QStandardItem::toolTip() const

Gibt den Tooltip des Elements zurück.

Siehe auch setToolTip(), statusTip() und whatsThis().

[virtual] int QStandardItem::type() const

Gibt den Typ dieses Elements zurück. Der Typ dient dazu, benutzerdefinierte Elemente von der Basisklasse zu unterscheiden. Wenn Sie eine Unterklasse von ` QStandardItem` erstellen, sollten Sie diese Funktion neu implementieren und einen neuen Wert zurückgeben, der größer oder gleich ` UserType` ist.

Siehe auch ` QStandardItem::Type`.

QString QStandardItem::whatsThis() const

Gibt die Hilfe „Was ist das?“ für das Element zurück.

Siehe auch setWhatsThis(), toolTip() und statusTip().

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

Schreibt das Element in den Stream out. Es werden nur die Daten und Flags des Elements geschrieben, nicht die untergeordneten Elemente.

Siehe auch read().

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

Gibt „ true “ zurück, wenn dieses Element kleiner als „ other “ ist; andernfalls wird „ false “ zurückgegeben.

Die Standardimplementierung verwendet die Daten für die Sortierrolle des Elements (siehe QStandardItemModel::sortRole), um den Vergleich durchzuführen, wenn das Element zu einem Modell gehört; andernfalls werden die Daten für die Qt::DisplayRole des Elements (text()) für den Vergleich herangezogen.

sortChildren() und QStandardItemModel::sort() verwenden diese Funktion beim Sortieren von Elementen. Wenn Sie eine benutzerdefinierte Sortierung wünschen, können Sie eine Unterklasse von ` QStandardItem ` erstellen und diese Funktion neu implementieren.

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

Weist diesem Element die Daten und Flags von ` other` zu. Beachten Sie, dass ` type()` und ` model()` nicht kopiert werden.

Diese Funktion ist nützlich, wenn „ clone()“ neu implementiert wird.

Verwandte Nicht-Mitglieder

QDataStream &operator<<(QDataStream &out, const QStandardItem &item)

Schreibt die Datei „ QStandardItem “ ( item ) in den Stream „ out “.

Dieser Operator verwendet QStandardItem::write().

Siehe auch „Serialisierung vonQt-Datentypen“.

QDataStream &operator>>(QDataStream &in, QStandardItem &item)

Liest eine „ QStandardItem “ aus dem Stream „ in “ in die „ item “ ein.

Dieser Operator verwendet ` QStandardItem::read()`.

Siehe auch „Serialisierung vonQt-Datentypen“.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.