QToolBox Class
Die QToolBox-Klasse bietet eine Spalte mit Registerkarten-Widgets. Mehr...
| Kopfzeile: | #include <QToolBox> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Vererbungen: | QFrame |
Eigenschaften
- count : const 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) |
Reimplementierte geschützte Funktionen
| virtual void | changeEvent(QEvent *ev) override |
| virtual bool | event(QEvent *e) override |
| virtual void | showEvent(QShowEvent *e) override |
Ausführliche Beschreibung
Ein Werkzeugkasten ist ein Widget, das eine Spalte von Registerkarten übereinander anzeigt, wobei das aktuelle Element unter der aktuellen Registerkarte angezeigt wird. Jede Registerkarte hat eine Indexposition innerhalb der Spalte der Registerkarten. Das Element einer Registerkarte ist ein QWidget.
Jedes Element hat 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 mit setItemEnabled() einzeln aktiviert oder deaktiviert werden.
Elemente werden mit addItem() hinzugefügt oder mit insertItem() an bestimmten Positionen eingefügt. Die Gesamtzahl der Einträge wird mit 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 verschiedene Positionen verschieben.
Der Index des aktuellen Element-Widgets wird mit currentIndex() zurückgegeben und mit setCurrentIndex() gesetzt. Der Index eines bestimmten Elements kann mit indexOf() ermittelt werden, und das Element an einem bestimmten Index wird mit item() zurückgegeben.
Das Signal currentChanged() wird ausgegeben, wenn das aktuelle Element geändert wird.
Siehe auch QTabWidget.
Dokumentation der Eigenschaft
[read-only] count : const int
Diese Eigenschaft enthält die Anzahl der in der Toolbox enthaltenen Elemente.
Standardmäßig hat diese Eigenschaft einen Wert von 0.
Zugriffsfunktionen:
| int | count() const |
currentIndex : int
Diese Eigenschaft enthält den Index des aktuellen Elements
Bei einer leeren Toolbox hat diese Eigenschaft standardmäßig den Wert -1.
Zugriffsfunktionen:
| int | currentIndex() const |
| void | setCurrentIndex(int index) |
Benachrichtigungssignal:
| void | currentChanged(int index) |
Dokumentation der Mitgliedsfunktionen
[explicit] QToolBox::QToolBox(QWidget *parent = nullptr, Qt::WindowFlags f = Qt::WindowFlags())
Konstruiert eine neue Toolbox mit der 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 die Registerkarte widget in einer neuen Registerkarte am unteren Rand des Werkzeugkastens ein. Der Text der neuen Registerkarte wird auf text gesetzt, und die iconSet wird links neben text angezeigt. Gibt den Index der neuen Registerkarte zurück.
int QToolBox::addItem(QWidget *w, const QString &text)
Dies ist eine überladene Funktion.
Fügt das Widget w in einer neuen Registerkarte am unteren Rand der Toolbox ein. Der Text der neuen Registerkarte wird auf text gesetzt. Gibt den Index der neuen Registerkarte zurück.
[override virtual protected] void QToolBox::changeEvent(QEvent *ev)
Reimplements: QFrame::changeEvent(QEvent *ev).
[signal] void QToolBox::currentChanged(int index)
Dieses Signal wird ausgegeben, wenn das aktuelle Element geändert wird. Der Index des neuen aktuellen Elements wird in index übergeben, oder -1, wenn es kein aktuelles Element gibt.
Hinweis: Meldesignal für die Eigenschaft currentIndex.
QWidget *QToolBox::currentWidget() const
Gibt einen Zeiger auf das aktuelle Widget zurück, oder nullptr, wenn es kein solches Element gibt.
Siehe auch currentIndex() und setCurrentWidget().
[override virtual protected] bool QToolBox::event(QEvent *e)
Reimplements: QFrame::event(QEvent *e).
int QToolBox::indexOf(const QWidget *widget) const
Gibt den Index von widget zurück, oder -1, wenn das Element nicht existiert.
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 Ende der Toolbox, wenn index außerhalb des Bereichs liegt. Der Text des neuen Elements wird auf text gesetzt, und icon wird links von text angezeigt. Gibt den Index des neuen Elements zurück.
int QToolBox::insertItem(int index, QWidget *widget, const QString &text)
Dies ist eine überladene Funktion.
Fügt das Element widget an der Position index ein, oder am unteren Ende der Toolbox, wenn index außerhalb des Bereichs liegt. Der Text des neuen Elements wird auf text gesetzt. Gibt den Index des neuen Elements zurück.
bool QToolBox::isItemEnabled(int index) const
Gibt true zurück, wenn das Element an 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 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 von 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 Bereichs liegt.
Siehe auch setItemText().
QString QToolBox::itemToolTip(int index) const
Gibt den Tooltip des Elements an der Position index zurück, oder einen leeren String, wenn index außerhalb des Bereichs liegt.
Siehe auch setItemToolTip().
void QToolBox::removeItem(int index)
Entfernt das Element an der Position index aus der Toolbox. Beachten Sie, dass das Widget nicht gelöscht wird.
[slot] void QToolBox::setCurrentWidget(QWidget *widget)
Machtwidget zum aktuellen Widget. widget muss ein Element in dieser Toolbox sein.
Siehe auch addItem(), setCurrentIndex(), und currentWidget().
void QToolBox::setItemEnabled(int index, bool enabled)
Wenn enabled wahr ist, wird das Element an Position index aktiviert; andernfalls wird das Element an 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 kaufmännisches Und-Zeichen ("&") enthält, wird dafür automatisch eine Eselsbrücke erstellt. Das Zeichen, das auf das "&" folgt, wird als Tastenkürzel verwendet. Jede vorherige Eselsbrücke wird überschrieben oder gelöscht, wenn der Text keine Eselsbrücke enthält. Einzelheiten finden Sie in der Dokumentation QShortcut (um ein echtes kaufmännisches Und darzustellen, 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)
Reimplements: QWidget::showEvent(QShowEvent *event).
QWidget *QToolBox::widget(int index) const
Gibt das Widget an der Position index zurück, oder nullptr, wenn es kein solches Element gibt.
© 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.
