QStandardItem Class
Die Klasse QStandardItem bietet ein Element zur Verwendung mit der Klasse QStandardItemModel. Mehr...
Kopfzeile: | #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) |
Verwandte Nicht-Members
QDataStream & | operator<<(QDataStream &out, const QStandardItem &item) |
QDataStream & | operator>>(QDataStream &in, QStandardItem &item) |
Detaillierte Beschreibung
Elemente enthalten in der Regel Text, Icons oder Kontrollkästchen.
Jedes Element kann einen eigenen Hintergrundpinsel haben, der mit der Funktion setBackground() festgelegt wird. Der aktuelle Hintergrundpinsel kann mit background() ermittelt werden. Die Textbeschriftung für jedes Element kann mit einer eigenen Schriftart und einem eigenen Pinsel gerendert werden. Diese werden mit den Funktionen setFont() und setForeground() festgelegt und mit font() und foreground() ausgelesen.
Standardmäßig sind Elemente aktiviert, bearbeitbar, auswählbar, überprüfbar und können sowohl als Quelle für eine Drag&Drop-Operation als auch als Ablageziel verwendet werden. Die Flags der einzelnen Elemente können durch den Aufruf von setFlags() geändert werden. Ankreuzbare Elemente können mit der Funktion setCheckState() an- und abgehakt werden. Die entsprechende Funktion checkState() zeigt an, ob das Element derzeit geprüft ist.
Sie können anwendungsspezifische Daten in einem Eintrag speichern, indem Sie setData() aufrufen.
Jedes Element kann eine zweidimensionale Tabelle mit untergeordneten Elementen haben. Dadurch ist es möglich, Hierarchien von Einträgen zu erstellen. Die typische Hierarchie ist der Baum, in dem die untergeordnete Tabelle eine Tabelle mit einer einzigen Spalte (eine Liste) ist.
Die Abmessungen der untergeordneten Tabelle können mit setRowCount() und setColumnCount() festgelegt werden. Elemente können in der untergeordneten Tabelle mit setChild() positioniert werden. Einen Zeiger auf ein untergeordnetes Element erhält man mit child(). Neue Zeilen und Spalten von untergeordneten Elementen können auch mit insertRow() und insertColumn() eingefügt oder mit appendRow() und appendColumn() angehängt werden. Wenn Sie die Funktionen zum Anhängen und Einfügen verwenden, wachsen die Abmessungen der untergeordneten Tabelle nach Bedarf.
Eine bestehende Zeile von Untereinträgen kann mit removeRow() oder takeRow() entfernt werden; entsprechend kann eine Spalte mit removeColumn() oder takeColumn() entfernt werden.
Die Kinder eines Elements können durch den Aufruf von sortChildren() sortiert werden.
Unterklassenbildung
Wenn man QStandardItem subclassing, um benutzerdefinierte Elemente bereitzustellen, ist es möglich, neue Typen für sie zu definieren, damit sie von der Basisklasse unterschieden werden können. Die Funktion type() sollte neu implementiert werden, um einen neuen Typwert zurückzugeben, der gleich oder größer als UserType ist.
Reimplementieren Sie data() und setData(), wenn Sie eine benutzerdefinierte Behandlung von Datenabfragen durchführen und/oder steuern möchten, wie die Daten eines Elements dargestellt werden.
Reimplementieren Sie clone(), wenn Sie möchten, dass QStandardItemModel bei Bedarf Instanzen Ihrer benutzerdefinierten Elementklasse erstellen kann (siehe QStandardItemModel::setItemPrototype()).
Reimplementieren Sie read() und write(), wenn Sie steuern möchten, wie Elemente in ihrer serialisierten Form dargestellt werden.
Reimplementieren Sie operator<(), wenn Sie die Semantik des Elementvergleichs steuern wollen. operator<() bestimmt die Sortierreihenfolge beim Sortieren von Elementen mit sortChildren() oder mit QStandardItemModel::sort().
Siehe auch QStandardItemModel, Item View Convenience Classes, und Model/View Programming.
Dokumentation der Mitgliedstypen
enum QStandardItem::ItemType
Diese Aufzählung beschreibt die Typen, die zur Beschreibung von Standardobjekten verwendet werden.
Konstante | Wert | Beschreibung |
---|---|---|
QStandardItem::Type | 0 | Der Standardtyp für Standardartikel. |
QStandardItem::UserType | 1000 | Der Mindestwert für benutzerdefinierte Typen. Werte unterhalb von UserType sind von Qt reserviert. |
Sie können neue Benutzertypen in QStandardItem Unterklassen definieren, um sicherzustellen, dass benutzerdefinierte Elemente speziell behandelt werden, z.B. wenn Elemente sortiert werden.
Siehe auch type().
Dokumentation der Mitgliedsfunktionen
QStandardItem::QStandardItem()
Konstruiert einen Gegenstand.
[explicit]
QStandardItem::QStandardItem(const QString &text)
Konstruiert einen Artikel mit dem angegebenen text.
QStandardItem::QStandardItem(const QIcon &icon, const QString &text)
Konstruiert einen Artikel mit dem angegebenen icon und text.
[explicit]
QStandardItem::QStandardItem(int rows, int columns = 1)
Konstruiert einen Artikel mit rows Zeilen und columns Spalten von untergeordneten Artikeln.
[protected]
QStandardItem::QStandardItem(const QStandardItem &other)
Konstruiert eine Kopie von other. Beachten Sie, dass model() nicht kopiert wird.
Diese Funktion ist nützlich bei der Neuimplementierung von clone().
[virtual noexcept]
QStandardItem::~QStandardItem()
Zerstört den Gegenstand. Dies führt dazu, dass auch die Kinder des Objekts zerstört werden.
QString QStandardItem::accessibleDescription() const
Gibt die zugängliche Beschreibung des Artikels zurück.
Die zugängliche Beschreibung wird von unterstützenden Technologien verwendet (d. h. für Benutzer, die keine konventionellen Interaktionsmittel verwenden können).
Siehe auch setAccessibleDescription() und accessibleText().
QString QStandardItem::accessibleText() const
Gibt den zugänglichen Text des Artikels zurück.
Der zugängliche Text wird von unterstützenden Technologien verwendet (d. h. für Benutzer, die keine konventionellen Interaktionsmittel verwenden können).
Siehe auch setAccessibleText() und accessibleDescription().
void QStandardItem::appendColumn(const QList<QStandardItem *> &items)
Hängt eine Spalte mit items an. Falls erforderlich, wird die Zeilenzahl auf die Größe von items erhöht.
Siehe auch insertColumn().
void QStandardItem::appendRow(const QList<QStandardItem *> &items)
Fügt eine Zeile mit items ein. Falls erforderlich, wird die Spaltenanzahl auf die Größe von items erhöht.
Siehe auch insertRow().
void QStandardItem::appendRow(QStandardItem *item)
Dies ist eine überladene Funktion.
Hängt eine Zeile mit item an.
Beim Aufbau einer Liste oder eines Baums, der nur eine Spalte hat, bietet diese Funktion eine bequeme Möglichkeit, ein einzelnes neues Element anzuhängen.
void QStandardItem::appendRows(const QList<QStandardItem *> &items)
Hängt Zeilen an, die items enthalten. Die Anzahl der Spalten wird nicht geändert.
Siehe auch insertRow().
QBrush QStandardItem::background() const
Gibt den Pinsel zurück, mit dem der Hintergrund des Objekts gerendert wurde.
Siehe auch foreground() und setBackground().
Qt::CheckState QStandardItem::checkState() const
Liefert den Status "geprüft" des Elements.
Siehe auch setCheckState() und isCheckable().
QStandardItem *QStandardItem::child(int row, int column = 0) const
Gibt das untergeordnete Element an (row, column) zurück, wenn eines gesetzt wurde; andernfalls wird nullptr
zurückgegeben.
Siehe auch setChild(), takeChild(), und parent().
void QStandardItem::clearData()
Entfernt 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 Kinder des Elements werden nicht kopiert.
Wenn Sie QStandardItem unterklassifizieren, können Sie diese Funktion neu implementieren, um QStandardItemModel eine Fabrik zur Verfügung zu stellen, mit der es bei Bedarf neue Elemente erstellen kann.
Siehe auch QStandardItemModel::setItemPrototype() und operator=().
int QStandardItem::column() const
Gibt die Spalte zurück, in der sich das Element in der untergeordneten Tabelle des ü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 untergeordneten Elementspalten zurück, die das Element hat.
Siehe auch setColumnCount() und rowCount().
[virtual]
QVariant QStandardItem::data(int role = Qt::UserRole + 1) const
Gibt die Daten des Elements für die angegebene role zurück, oder eine ungültige QVariant, wenn es keine Daten für die Rolle gibt.
Wenn Sie diese Funktion neu implementieren, sollte Ihre Neuimplementierung die Basisimplementierung für Rollen, die Sie nicht behandeln, aufrufen, andernfalls wird das Abrufen von Flags, z. B. durch den Aufruf von flags(), isCheckable(), isEditable() usw., nicht funktionieren.
Hinweis: Die Standardimplementierung behandelt Qt::EditRole und Qt::DisplayRole als auf dieselben Daten bezogen.
Siehe auch setData().
[protected]
void QStandardItem::emitDataChanged()
Veranlasst das mit diesem Element verknüpfte Modell, ein dataChanged()-Signal für dieses Element zu senden.
Normalerweise brauchen Sie diese Funktion nur aufzurufen, wenn Sie QStandardItem subclassed und data() und/oder setData() reimplementiert haben.
Siehe auch setData().
Qt::ItemFlags QStandardItem::flags() const
Gibt die Item-Flags für das Item zurück.
Die Elementflags bestimmen, wie der Benutzer mit dem Element interagieren kann.
Standardmäßig sind Elemente aktiviert, bearbeitbar, auswählbar, überprüfbar und können sowohl als Quelle eines Drag & Drop-Vorgangs als auch als Ablageziel verwendet werden.
Siehe auch setFlags().
QFont QStandardItem::font() const
Gibt die Schriftart zurück, die für die Darstellung des Textes des Elements verwendet wird.
Siehe auch setFont().
QBrush QStandardItem::foreground() const
Gibt den Pinsel zurück, mit dem der Vordergrund des Elements (z. B. Text) dargestellt wird.
Siehe auch setForeground() und background().
bool QStandardItem::hasChildren() const
Gibt true
zurück, wenn dieses Element Kinder hat; andernfalls wird false
zurückgegeben.
Siehe auch rowCount(), columnCount(), und child().
QIcon QStandardItem::icon() const
Gibt das Symbol des Objekts zurück.
Siehe auch setIcon() und iconSize.
QModelIndex QStandardItem::index() const
Gibt die mit diesem Element verbundene QModelIndex zurück.
Wenn Sie in einer QModelIndex-basierten API (z. B. QAbstractItemView) Funktionen für Elemente aufrufen müssen, können Sie diese Funktion aufrufen, um einen Index zu erhalten, der der Position des Elements im Modell entspricht.
Wenn das Element nicht mit einem Modell verbunden ist, wird ein ungültiger QModelIndex zurückgegeben.
Siehe auch model() und QStandardItemModel::itemFromIndex().
void QStandardItem::insertColumn(int column, const QList<QStandardItem *> &items)
Fügt unter column eine Spalte ein, die items enthält. Falls erforderlich, wird die Zeilenzahl auf die Größe von items erhöht.
Siehe auch insertColumns() und insertRow().
void QStandardItem::insertColumns(int column, int count)
Fügt count Spalten von untergeordneten Elementen in die Spalte column ein.
Siehe auch insertColumn() und insertRows().
void QStandardItem::insertRow(int row, const QList<QStandardItem *> &items)
Fügt unter row eine Zeile ein, die 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)
Dies ist eine überladene Funktion.
Fügt eine Zeile auf row ein, die item enthält.
Wenn Sie eine Liste oder einen Baum mit nur einer Spalte erstellen, bietet diese Funktion eine bequeme Möglichkeit, ein einzelnes neues Element einzufügen.
void QStandardItem::insertRows(int row, const QList<QStandardItem *> &items)
Fügt items unter row ein. Die Spaltenanzahl wird nicht geändert.
Siehe auch insertRow() und insertColumn().
void QStandardItem::insertRows(int row, int count)
Fügt count Zeilen von untergeordneten Elementen in die Zeile row ein.
Siehe auch insertRow() und insertColumns().
bool QStandardItem::isAutoTristate() const
Gibt zurück, ob das Element tristate 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 angekreuzt werden kann.
Der Standardwert ist false.
Siehe auch setCheckable(), checkState(), isUserTristate(), und isAutoTristate().
bool QStandardItem::isDragEnabled() const
Gibt zurück, ob das Element zum Ziehen freigegeben ist. Ein Element, das für das Ziehen aktiviert ist, kann vom Benutzer gezogen werden.
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 der Gegenstand Drop-fähig ist. Wenn ein Element Drop-fähig ist, kann es als Drop-Ziel 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 Bearbeitungsauslöser der Ansicht aufruft; 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 mit ihm interagieren. Die möglichen Arten der Interaktion werden durch die anderen Elementflags angegeben, wie isEditable() und isSelectable().
Der Standardwert ist true.
Siehe auch setEnabled() und flags().
bool QStandardItem::isSelectable() const
Gibt zurück, ob das Element vom Benutzer auswählbar ist.
Der Standardwert ist true.
Siehe auch setSelectable() und flags().
bool QStandardItem::isUserTristate() const
Gibt zurück, ob das Element einen dreistufigen Zustand hat, d. h. ob es mit drei verschiedenen Zuständen überprüfbar ist und der Benutzer alle drei Zustände durchlaufen 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 Kind 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 aus diesem Element.
Die Standardimplementierung ruft einfach data() für jede Rolle in der Spanne 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
, wenn das Element kein übergeordnetes Element hat.
Hinweis: Für Toplevel-Elemente gibt parent() nullptr
zurück. Um das übergeordnete Element des Toplevel-Elements 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. Es werden nur die Daten und Flaggen des Elements gelesen, nicht die untergeordneten Elemente.
Siehe auch write().
void QStandardItem::removeColumn(int column)
Entfernt die angegebene column. Die Elemente, die sich in der Spalte befanden, werden gelöscht.
Siehe auch takeColumn(), removeColumns(), und removeRow().
void QStandardItem::removeColumns(int column, int count)
Entfernt count Spalten in 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 count Zeilen in der Zeile 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 des ü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 hat.
Siehe auch setRowCount() und columnCount().
void QStandardItem::setAccessibleDescription(const QString &accessibleDescription)
Setzt die zugängliche Beschreibung des Objekts auf die durch accessibleDescription angegebene Zeichenfolge.
Die zugängliche Beschreibung wird von unterstützenden Technologien verwendet (d. h. für Benutzer, die keine konventionellen Interaktionsmittel verwenden können).
Siehe auch accessibleDescription() und setAccessibleText().
void QStandardItem::setAccessibleText(const QString &accessibleText)
Setzt den zugänglichen Text des Eintrags auf die durch accessibleText angegebene Zeichenfolge.
Der zugängliche Text wird von unterstützenden Technologien verwendet (d. h. für Benutzer, die keine konventionellen Interaktionsmittel verwenden können).
Siehe auch accessibleText() und setAccessibleDescription().
void QStandardItem::setAutoTristate(bool tristate)
Legt fest, dass das Element tristate ist und von QTreeWidget kontrolliert wird, wenn tristate true
ist. Dies ermöglicht die automatische Verwaltung des Zustands übergeordneter Elemente in QTreeWidget (markiert, wenn alle Kinder markiert sind, nicht markiert, wenn alle Kinder nicht markiert sind, oder teilweise markiert, wenn nur einige Kinder markiert sind).
Siehe auch isAutoTristate(), setCheckable(), und setCheckState().
void QStandardItem::setBackground(const QBrush &brush)
Setzt den Hintergrundpinsel des Objekts auf den angegebenen brush.
Siehe auch background() und setForeground().
void QStandardItem::setCheckState(Qt::CheckState state)
Setzt den Prüfstatus des Artikels auf state.
Siehe auch checkState() und setCheckable().
void QStandardItem::setCheckable(bool checkable)
Legt fest, ob der Eintrag vom Benutzer geprüft werden kann. Wenn checkable true ist, kann das Element vom Benutzer überprüft werden; andernfalls kann der Benutzer das Element nicht überprüfen.
Der Elementdelegierte rendert ein abhakbares 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 (row, column) auf item. Dieses Element (das übergeordnete Element) übernimmt das Eigentum an item. Falls erforderlich, werden die Zeilenzahl und die Spaltenzahl erhöht, um das Element anzupassen.
Hinweis: Durch die Übergabe von nullptr
als item wird das Element entfernt.
Siehe auch child().
void QStandardItem::setChild(int row, QStandardItem *item)
Dies ist eine überladene Funktion.
Setzt das Kind auf row auf item.
void QStandardItem::setColumnCount(int columns)
Setzt die Anzahl der untergeordneten Elementspalten auf columns. Ist diese kleiner als columnCount(), werden die Daten in den nicht gewünschten 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.
Wenn Sie QStandardItem unterklassifizieren und diese Funktion neu implementieren, sollte Ihre Neuimplementierung:
- emitDataChanged() aufrufen, wenn Sie nicht die Basisimplementierung von setData() aufrufen. Dadurch wird sichergestellt, dass z.B. Views, die das Modell verwenden, über die Änderungen informiert werden
- die Basisimplementierung für Rollen aufrufen, die Sie nicht behandeln, da sonst das Setzen von Flags, z. B. durch den Aufruf von setFlags(), setCheckable(), setEditable() usw., nicht funktioniert.
Hinweis: Die Standardimplementierung behandelt Qt::EditRole und Qt::DisplayRole als auf dieselben Daten bezogen.
Siehe auch Qt::ItemDataRole, data(), und setFlags().
void QStandardItem::setDragEnabled(bool dragEnabled)
Legt fest, ob das Element zum Ziehen freigegeben ist. Wenn dragEnabled true ist, kann das Element vom Benutzer gezogen werden; andernfalls kann der Benutzer das Element nicht ziehen.
Beachten Sie, dass Sie auch sicherstellen müssen, dass das Ziehen von Objekten in der Ansicht aktiviert ist; siehe QAbstractItemView::dragEnabled.
Siehe auch isDragEnabled(), setDropEnabled(), und setFlags().
void QStandardItem::setDropEnabled(bool dropEnabled)
Legt fest, ob der Gegenstand Drop-fähig ist. Wenn dropEnabled true ist, kann das Element als Drop-Ziel verwendet werden; andernfalls ist dies nicht möglich.
Beachten Sie, dass Sie auch sicherstellen müssen, dass Drops in der Ansicht aktiviert sind; siehe QWidget::acceptDrops(); und dass das Modell die gewünschten Drop-Aktionen unterstützt; siehe QAbstractItemModel::supportedDropActions().
Siehe auch isDropEnabled(), setDragEnabled(), und setFlags().
void QStandardItem::setEditable(bool editable)
Legt fest, ob das Element bearbeitbar ist. Wenn editable true ist, 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. Wenn enabled wahr ist, ist das Element aktiviert, was bedeutet, dass der Benutzer mit dem Element interagieren kann; wenn enabled falsch ist, kann der Benutzer nicht mit dem Element interagieren.
Dieses Flag hat Vorrang vor den anderen Element-Flags; wenn z. B. ein Element 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 Item-Flags für das Item auf flags.
Die Elementflags bestimmen, wie der Benutzer mit dem Element interagieren kann. Dies wird oft verwendet, um ein Element zu deaktivieren.
Siehe auch flags() und setData().
void QStandardItem::setFont(const QFont &font)
Setzt die Schriftart, die für die Anzeige des Textes des Artikels verwendet wird, auf die angegebene font.
Siehe auch font(), setText(), und setForeground().
void QStandardItem::setForeground(const QBrush &brush)
Setzt den Pinsel, mit dem der Vordergrund des Elements (z. B. Text) dargestellt wird, auf den angegebenen brush.
Siehe auch foreground(), setBackground(), und setFont().
void QStandardItem::setIcon(const QIcon &icon)
Setzt das Symbol des Elements auf die angegebene icon.
Siehe auch icon().
void QStandardItem::setRowCount(int rows)
Setzt die Anzahl der untergeordneten Elementzeilen auf rows. Ist diese kleiner als rowCount(), werden die Daten in den nicht gewünschten Zeilen verworfen.
Siehe auch rowCount() und setColumnCount().
void QStandardItem::setSelectable(bool selectable)
Legt fest, ob das Element auswählbar ist. Wenn selectable true 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 steuern, indem Sie die Ansichtseigenschaften manipulieren; 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, das size sein soll. Wenn kein Größenhinweis festgelegt ist, berechnet der Elementdelegierte den Größenhinweis auf der Grundlage der Elementdaten.
Siehe auch sizeHint().
void QStandardItem::setStatusTip(const QString &statusTip)
Setzt den Statustipp des Elements auf die durch statusTip angegebene Zeichenkette.
Siehe auch statusTip(), setToolTip(), und setWhatsThis().
void QStandardItem::setText(const QString &text)
Setzt den Text des Eintrags auf den angegebenen text.
Siehe auch text(), setFont(), und setForeground().
void QStandardItem::setTextAlignment(Qt::Alignment alignment)
Setzt die Textausrichtung für den Text des Elements auf die angegebene alignment.
Siehe auch textAlignment().
void QStandardItem::setToolTip(const QString &toolTip)
Setzt den Tooltip des Elements auf die durch toolTip angegebene Zeichenkette.
Siehe auch toolTip(), setStatusTip(), und setWhatsThis().
void QStandardItem::setUserTristate(bool tristate)
Legt fest, ob das Element einen dreistufigen Zustand hat und vom Benutzer kontrolliert werden kann. Wenn tristate true ist, kann der Benutzer drei verschiedene Zustände durchlaufen; andernfalls ist das Element mit zwei Zuständen kontrollierbar. (Beachten Sie, dass dies auch voraussetzt, dass das Element überprüfbar 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 durch whatsThis angegebene Zeichenkette.
Siehe auch whatsThis(), setStatusTip(), und setToolTip().
QSize QStandardItem::sizeHint() const
Gibt den Größenhinweis zurück, der für das Element festgelegt wurde, oder ein ungültiges QSize, wenn kein Größenhinweis festgelegt wurde.
Wenn kein Größenhinweis festgelegt wurde, berechnet der Elementdelegierte den Größenhinweis auf der Grundlage der Elementdaten.
Siehe auch setSizeHint().
void QStandardItem::sortChildren(int column, Qt::SortOrder order = Qt::AscendingOrder)
Sortiert die Kinder des Eintrags unter Verwendung der angegebenen order nach den Werten in der angegebenen column.
Hinweis: Diese Funktion ist rekursiv, d. h. sie sortiert die Kinder des Eintrags, seine Enkelkinder usw.
Siehe auch operator<().
QString QStandardItem::statusTip() const
Gibt den Statustipp des Elements zurück.
Siehe auch setStatusTip(), toolTip(), und whatsThis().
QStandardItem *QStandardItem::takeChild(int row, int column = 0)
Entfernt das untergeordnete Element an (row, column), ohne es zu löschen, und gibt einen Zeiger auf das Element zurück. War an der angegebenen Stelle kein untergeordnetes Element vorhanden, gibt diese Funktion nullptr
zurück.
Beachten Sie, dass diese Funktion, im Gegensatz zu takeRow() und takeColumn(), die Dimensionen der untergeordneten Tabelle nicht beeinflusst.
Siehe auch child(), takeRow(), und takeColumn().
QList<QStandardItem *> QStandardItem::takeColumn(int column)
Entfernt column, ohne die Spaltenelemente zu löschen, und gibt eine Liste von 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 Zeilenelemente zu löschen, und gibt eine Liste von Zeigern auf die entfernten Elemente zurück. Für Elemente in der Zeile, die nicht gesetzt wurden, lauten die entsprechenden Zeiger in der Liste nullptr
.
Siehe auch removeRow(), insertRow(), und takeColumn().
QString QStandardItem::text() const
Gibt den Text des Artikels 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 wird verwendet, um benutzerdefinierte Elemente von der Basisklasse zu unterscheiden. Wenn Sie QStandardItem unterklassifizieren, sollten Sie diese Funktion reimplementieren und einen neuen Wert zurückgeben, der größer oder gleich UserType ist.
Siehe auch QStandardItem::Type.
QString QStandardItem::whatsThis() const
Gibt die "Was ist das?"-Hilfe des Elements 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 Flaggen 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 das Element Qt::DisplayRole (text()) verwendet, um den Vergleich durchzuführen.
sortChildren() und QStandardItemModel::sort() verwenden diese Funktion beim Sortieren von Elementen. Wenn Sie eine benutzerdefinierte Sortierung wünschen, können Sie die Unterklasse QStandardItem verwenden und diese Funktion neu implementieren.
[protected]
QStandardItem &QStandardItem::operator=(const QStandardItem &other)
Weist die Daten und Flaggen von other diesem Element zu. Beachten Sie, dass type() und model() nicht kopiert werden.
Diese Funktion ist nützlich bei der Neuimplementierung von clone().
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 von Qt-Datentypen.
QDataStream &operator>>(QDataStream &in, QStandardItem &item)
Liest ein QStandardItem aus dem Stream in in item.
Dieser Operator verwendet QStandardItem::read().
Siehe auch Serialisierung von Qt-Datentypen.
© 2025 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.