QToolBox Class
QToolBox クラスは、タブ付きのウィジェット項目が並んだ列を提供します。詳細...
| ヘッダー: | #include <QToolBox> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| 継承元: | QFrame |
プロパティ
- count : int
- currentIndex : int
パブリック関数
| 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 |
パブリックスロット
| void | setCurrentIndex(int index) |
| void | setCurrentWidget(QWidget *widget) |
シグナル
| void | currentChanged(int index) |
protected 関数
| virtual void | itemInserted(int index) |
| virtual void | itemRemoved(int index) |
再実装されたプロテクトされた関数
| virtual void | changeEvent(QEvent *ev) override |
| virtual bool | event(QEvent *e) override |
| virtual void | showEvent(QShowEvent *e) override |
詳細な説明
ツールボックスは、タブを縦に並べて表示するウィジェットであり、現在のタブの下に現在の項目が表示されます。各タブには、タブの列内でのインデックス位置が割り当てられています。タブの項目は、QWidget です。
各項目には、itemText()、オプションのitemIcon()、オプションのitemToolTip()、およびwidget()があります。項目の属性は、setItemText()、setItemIcon()、およびsetItemToolTip()を使用して変更できます。各項目は、setItemEnabled()を使用して個別に有効または無効にできます。
項目の追加にはaddItem() を使用し、特定の位置への挿入にはinsertItem() を使用します。項目の総数はcount() で取得できます。項目の削除には delete を使用し、ツールボックスからの削除にはremoveItem() を使用します。removeItem() とinsertItem() を組み合わせることで、項目を別の位置に移動させることができます。
現在のアイテムウィジェットのインデックスは、currentIndex() によって返され、setCurrentIndex() によって設定されます。特定のアイテムのインデックスはindexOf() を使用して取得でき、指定されたインデックスのアイテムは item() によって返されます。
currentChanged() シグナルは、現在のアイテムが変更されたときに発火します。
QTabWidgetも参照してください 。
プロパティのドキュメント
[read-only] count : int
このプロパティには、ツールボックスに含まれる項目の数が格納されます。
デフォルトでは、このプロパティの値は 0 です。
アクセス関数:
| int | count() const |
currentIndex : int
このプロパティは、現在の項目のインデックスを保持します
デフォルトでは、空のツールボックスの場合、このプロパティの値は -1 になります。
アクセス関数:
| int | currentIndex() const |
| void | setCurrentIndex(int index) |
通知シグナル:
| void | currentChanged(int index) |
メンバ関数のドキュメント
[explicit] QToolBox::QToolBox(QWidget *parent = nullptr, Qt::WindowFlags f = Qt::WindowFlags())
指定されたparent とフラグf を使用して、新しいツールボックスを作成します。
[virtual noexcept] QToolBox::~QToolBox()
ツールボックスを破壊する。
int QToolBox::addItem(QWidget *widget, const QIcon &iconSet, const QString &text)
ツールボックスの下部に、新しいタブとして「widget 」を追加します。新しいタブのテキストは「text 」に設定され、「iconSet 」は「text 」の左側に表示されます。新しいタブのインデックスを返します。
int QToolBox::addItem(QWidget *w, const QString &text)
ツールボックスの下部に、新しいタブとしてウィジェット「w 」を追加します。新しいタブのテキストは「text 」に設定されます。新しいタブのインデックスを返します。
これはオーバーロードされた関数です。
[override virtual protected] void QToolBox::changeEvent(QEvent *ev)
QFrame::changeEvent(QEvent *ev) を再実装します。
[signal] void QToolBox::currentChanged(int index)
このシグナルは、現在の項目が変更されたときに発火します。新しい現在の項目のインデックスが `index` に渡されます。現在の項目がない場合は -1 が渡されます。
注: プロパティ `currentIndex` に対する通知 シグナルです。
QWidget *QToolBox::currentWidget() const
現在のウィジェットへのポインタを返します。該当する項目がない場合は、nullptr を返します。
currentIndex() およびsetCurrentWidget()も参照してください 。
[override virtual protected] bool QToolBox::event(QEvent *e)
QFrame::event(QEvent *e) を再実装しています。
int QToolBox::indexOf(const QWidget *widget) const
widget のインデックスを返します。項目が存在しない場合は-1を返します。
int QToolBox::insertItem(int index, QWidget *widget, const QIcon &icon, const QString &text)
widget を位置index に挿入します。index が範囲外の場合は、ツールボックスの最下部に挿入されます。新しい項目のテキストはtext に設定され、icon はtext の左側に表示されます。新しい項目のインデックスを返します。
int QToolBox::insertItem(int index, QWidget *widget, const QString &text)
widget を位置index に挿入します。ただし、index が範囲外の場合は、ツールボックスの最下部に挿入されます。新しい項目のテキストはtext に設定されます。新しい項目のインデックスを返します。
これはオーバーロードされた関数です。
bool QToolBox::isItemEnabled(int index) const
位置index にある項目が有効な場合はtrue を返し、そうでない場合はfalse を返します。
QIcon QToolBox::itemIcon(int index) const
位置index にあるアイテムのアイコンを返します。index が範囲外の場合は、nullのアイコンを返します。
setItemIcon()も参照してください 。
[virtual protected] void QToolBox::itemInserted(int index)
この仮想ハンドラは、index の位置に新しい項目が追加または挿入された後に呼び出されます。
itemRemoved()も参照してください 。
[virtual protected] void QToolBox::itemRemoved(int index)
この仮想ハンドラは、index の位置から項目が削除された後に呼び出されます。
itemInserted()も参照してください 。
QString QToolBox::itemText(int index) const
位置index にある項目のテキストを返します。index が範囲外の場合は、空の文字列を返します。
setItemText()も参照してください 。
QString QToolBox::itemToolTip(int index) const
位置index にあるアイテムのツールチップを返します。index が範囲外の場合は空の文字列を返します。
setItemToolTip()も参照してください 。
void QToolBox::removeItem(int index)
index の位置にあるアイテムをツールボックスから削除します。なお、ウィジェット自体は削除されませんのでご注意ください。
[slot] void QToolBox::setCurrentWidget(QWidget *widget)
widget を現在のウィジェットに設定します。widget は、このツールボックス内のアイテムでなければなりません。
addItem()、setCurrentIndex()、およびcurrentWidget()も参照してください 。
void QToolBox::setItemEnabled(int index, bool enabled)
enabled が true の場合、位置index にある項目が有効になります。そうでない場合は、位置index にある項目が無効になります。
isItemEnabled()も参照してください 。
void QToolBox::setItemIcon(int index, const QIcon &icon)
位置index にある項目のアイコンをicon に設定します。
itemIcon()も参照してください 。
void QToolBox::setItemText(int index, const QString &text)
位置index にある項目のテキストをtext に設定します。
指定されたテキストにアンパサンド('&')が含まれている場合、自動的にニーモニックが作成されます。'&' の後に続く文字がショートカットキーとして使用されます。以前に設定されていたニーモニックは上書きされます。また、テキストにニーモニックが定義されていない場合は、ニーモニックはクリアされます。 詳細については、QShortcut のドキュメントを参照してください(実際のアンパサンドを表示するには、「&&」を使用してください)。
itemText()も参照してください 。
void QToolBox::setItemToolTip(int index, const QString &toolTip)
位置index にあるアイテムのツールチップを、toolTip に設定します。
itemToolTip()も参照してください 。
[override virtual protected] void QToolBox::showEvent(QShowEvent *e)
QWidget::showEvent(QShowEvent *event) を再実装します。
QWidget *QToolBox::widget(int index) const
位置index にあるウィジェットを返します。該当する項目がない場合は、nullptr を返します。
© 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.