このページでは

QToolBox Class

QToolBox クラスは、タブ付きのウィジェット項目が並んだ列を提供します。詳細...

ヘッダー: #include <QToolBox>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
継承元: QFrame

プロパティ

パブリック関数

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)

関連項目: indexOf() およびwidget()。

メンバ関数のドキュメント

[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.