QToolBox Class
Die Klasse „QToolBox“ stellt eine Spalte mit Widget-Elementen in Form von Registerkarten bereit. Mehr...
| Überschrift: | #include <QToolBox> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Erbt von: | QFrame |
Eigenschaften
- count : int
- currentIndex : int
Öffentliche Funktionen
| QToolBox(QWidget *parent = nullptr, Qt::WindowFlags f = Qt::WindowFlags()) | |
| virtual | ~QToolBox() |
| int | addItem(QWidget *widget, const QIcon &iconSet, const QString &text) |
| int | addItem(QWidget *w, const QString &text) |
| int | count() const |
| int | currentIndex() const |
| QWidget * | currentWidget() const |
| int | indexOf(const QWidget *widget) const |
| int | insertItem(int index, QWidget *widget, const QIcon &icon, const QString &text) |
| int | insertItem(int index, QWidget *widget, const QString &text) |
| bool | isItemEnabled(int index) const |
| QIcon | itemIcon(int index) const |
| QString | itemText(int index) const |
| QString | itemToolTip(int index) const |
| void | removeItem(int index) |
| void | setItemEnabled(int index, bool enabled) |
| void | setItemIcon(int index, const QIcon &icon) |
| void | setItemText(int index, const QString &text) |
| void | setItemToolTip(int index, const QString &toolTip) |
| QWidget * | widget(int index) const |
Öffentliche Slots
| void | setCurrentIndex(int index) |
| void | setCurrentWidget(QWidget *widget) |
Signale
| void | currentChanged(int index) |
Geschützte Funktionen
| virtual void | itemInserted(int index) |
| virtual void | itemRemoved(int index) |
Neu implementierte geschützte Funktionen
| virtual void | changeEvent(QEvent *ev) override |
| virtual bool | event(QEvent *e) override |
| virtual void | showEvent(QShowEvent *e) override |
Ausführliche Beschreibung
Eine Toolbox ist ein Widget, das eine Spalte mit übereinander angeordneten Registerkarten anzeigt, wobei das aktuelle Element unterhalb der aktuellen Registerkarte dargestellt wird. Jede Registerkarte hat eine Indexposition innerhalb der Registerkartenspalte. Das Element einer Registerkarte ist ein „ QWidget “.
Jedes Element verfügt über ein „ itemText “ (), ein optionales „ itemIcon “ (), ein optionales „ itemToolTip “ () und ein „ widget “ (). Die Attribute des Elements können mit „ setItemText “ (), „ setItemIcon “ () und „ setItemToolTip “ () geändert werden. Jedes Element kann einzeln mit „ setItemEnabled “ () aktiviert oder deaktiviert werden.
Elemente werden mit ` addItem()` hinzugefügt oder mit ` insertItem()` an bestimmten Positionen eingefügt. Die Gesamtzahl der Elemente wird durch ` count()` angegeben. Elemente können mit `delete` gelöscht oder mit ` removeItem()` aus der Toolbox entfernt werden. Durch die Kombination von ` removeItem()` und ` insertItem()` können Sie Elemente an andere Positionen verschieben.
Der Index des aktuellen Element-Widgets wird von „ currentIndex()“ zurückgegeben und mit „ setCurrentIndex()“ festgelegt. Der Index eines bestimmten Elements kann mit „ indexOf()“ ermittelt werden, und das Element an einem bestimmten Index wird von „item()“ zurückgegeben.
Das Signal „ currentChanged()“ wird ausgelöst, wenn sich das aktuelle Element ändert.
Siehe auch „ QTabWidget “.
Dokumentation zu den Eigenschaften
[read-only] count : int
Diese Eigenschaft gibt die Anzahl der in der Werkzeugbox enthaltenen Elemente an.
Standardmäßig hat diese Eigenschaft den Wert 0.
Zugriffsfunktionen:
| int | count() const |
currentIndex : int
Diese Eigenschaft enthält den Index des aktuellen Elements
Standardmäßig hat diese Eigenschaft bei einer leeren Toolbox den Wert -1.
Zugriffsfunktionen:
| int | currentIndex() const |
| void | setCurrentIndex(int index) |
Benachrichtigungssignal:
| void | currentChanged(int index) |
Dokumentation zu den Member-Funktionen
[explicit] QToolBox::QToolBox(QWidget *parent = nullptr, Qt::WindowFlags f = Qt::WindowFlags())
Erstellt eine neue Toolbox mit dem angegebenen „ parent “ und den Flags „ f “.
[virtual noexcept] QToolBox::~QToolBox()
Zerstört den Werkzeugkasten.
int QToolBox::addItem(QWidget *widget, const QIcon &iconSet, const QString &text)
Fügt den „ widget “ in einem neuen Reiter am unteren Rand der Toolbox hinzu. Der Text des neuen Reiters lautet „ text “, und die „ iconSet “ wird links neben der „ text “ angezeigt. Gibt den Index des neuen Reiters zurück.
int QToolBox::addItem(QWidget *w, const QString &text)
Fügt das Widget „ w “ in einem neuen Reiter am unteren Rand der Toolbox hinzu. Der Text des neuen Reiters wird auf „ text “ gesetzt. Gibt den Index des neuen Reiters zurück.
Dies ist eine überladene Funktion.
[override virtual protected] void QToolBox::changeEvent(QEvent *ev)
Implementiert: ` QFrame::changeEvent(QEvent *ev)`.
[signal] void QToolBox::currentChanged(int index)
Dieses Signal wird ausgelöst, wenn das aktuelle Element geändert wird. Der Index des neuen aktuellen Elements wird in „ index “ übergeben, oder -1, falls kein aktuelles Element vorhanden ist.
Hinweis: Notifier -Signal für die Eigenschaft „ currentIndex “.
QWidget *QToolBox::currentWidget() const
Gibt einen Zeiger auf das aktuelle Widget zurück oder „ nullptr “, falls kein solches Element vorhanden ist.
Siehe auch „ currentIndex()“ und „ setCurrentWidget()“.
[override virtual protected] bool QToolBox::event(QEvent *e)
Implementiert: ` QFrame::event(QEvent *e)`.
int QToolBox::indexOf(const QWidget *widget) const
Gibt den Index von „ widget “ zurück oder -1, wenn das Element nicht vorhanden ist.
int QToolBox::insertItem(int index, QWidget *widget, const QIcon &icon, const QString &text)
Fügt das Element „ widget “ an der Position „ index “ ein oder am unteren Rand der Toolbox, falls „ index “ außerhalb des zulässigen Bereichs liegt. Der Text des neuen Elements wird auf „ text “ gesetzt, und die „ icon “ wird links neben dem „ text “ angezeigt. Gibt den Index des neuen Elements zurück.
int QToolBox::insertItem(int index, QWidget *widget, const QString &text)
Fügt das Element „ widget “ an der Position „ index “ ein oder am unteren Rand der Toolbox, falls „ index “ außerhalb des zulässigen Bereichs liegt. Der Text des neuen Elements wird auf „ text “ gesetzt. Gibt den Index des neuen Elements zurück.
Dies ist eine überladene Funktion.
bool QToolBox::isItemEnabled(int index) const
Gibt „ true “ zurück, wenn das Element an der Position „ index “ aktiviert ist; andernfalls wird „ false “ zurückgegeben.
QIcon QToolBox::itemIcon(int index) const
Gibt das Symbol des Elements an der Position index zurück oder ein Null-Symbol, wenn index außerhalb des zulässigen Bereichs liegt.
Siehe auch setItemIcon().
[virtual protected] void QToolBox::itemInserted(int index)
Dieser virtuelle Handler wird aufgerufen, nachdem ein neues Element an der Position index hinzugefügt oder eingefügt wurde.
Siehe auch itemRemoved().
[virtual protected] void QToolBox::itemRemoved(int index)
Dieser virtuelle Handler wird aufgerufen, nachdem ein Element aus der Position „ index “ entfernt wurde.
Siehe auch itemInserted().
QString QToolBox::itemText(int index) const
Gibt den Text des Elements an der Position „ index “ zurück oder eine leere Zeichenkette, wenn „ index “ außerhalb des zulässigen Bereichs liegt.
Siehe auch setItemText().
QString QToolBox::itemToolTip(int index) const
Gibt den Tooltip des Elements an der Position „ index “ zurück oder eine leere Zeichenfolge, wenn „ index “ außerhalb des zulässigen Bereichs liegt.
Siehe auch setItemToolTip().
void QToolBox::removeItem(int index)
Entfernt das Element an der Position „ index “ aus der Werkzeugbox. Beachten Sie, dass das Widget dabei nicht gelöscht wird.
[slot] void QToolBox::setCurrentWidget(QWidget *widget)
Macht „widget “ zum aktuellen Widget. „ widget “ muss ein Element in dieser Werkzeugleiste sein.
Siehe auch addItem(), setCurrentIndex() und currentWidget().
void QToolBox::setItemEnabled(int index, bool enabled)
Wenn „ enabled “ wahr ist, ist das Element an der Position „ index “ aktiviert; andernfalls ist das Element an der Position „ index “ deaktiviert.
Siehe auch isItemEnabled().
void QToolBox::setItemIcon(int index, const QIcon &icon)
Setzt das Symbol des Elements an der Position index auf icon.
Siehe auch itemIcon().
void QToolBox::setItemText(int index, const QString &text)
Setzt den Text des Elements an der Position index auf text.
Wenn der angegebene Text ein Und-Zeichen („&“) enthält, wird automatisch eine Tastenkombination dafür erstellt. Das Zeichen, das auf das „&“ folgt, wird als Tastenkürzel verwendet. Eine eventuell zuvor festgelegte Tastenkombination wird überschrieben oder gelöscht, wenn durch den Text keine Tastenkombination definiert ist. Weitere Informationen finden Sie in der Dokumentation zu QShortcut (um ein tatsächliches Und-Zeichen anzuzeigen, verwenden Sie „&&“).
Siehe auch itemText().
void QToolBox::setItemToolTip(int index, const QString &toolTip)
Setzt den Tooltip des Elements an der Position index auf toolTip.
Siehe auch itemToolTip().
[override virtual protected] void QToolBox::showEvent(QShowEvent *e)
Implementiert: ` QWidget::showEvent(QShowEvent *event)`.
QWidget *QToolBox::widget(int index) const
Gibt das Widget an der Position „ index “ zurück oder „ nullptr “, falls kein entsprechendes Element vorhanden ist.
© 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.
