QToolBox Class

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

Header: #include <QToolBox>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Inherits: 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)

保護された関数

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 : const 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 に設定され、iconSettext の左に表示されます。

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)

index の位置にwidget を挿入します。index が範囲外の場合は、ツールボックスの一番下に挿入します。新しい項目のテキストはtext に設定され、icontext の左に表示されます。

int QToolBox::insertItem(int index, QWidget *widget, const QString &text)

これはオーバーロードされた関数です。

index の位置にwidget を挿入します。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 が真の場合、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 を返します。

本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。