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 |
プロパティ
- count : const 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) |
保護された関数
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) |
メンバ関数 ドキュメント
[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)
index の位置にwidget を挿入します。index が範囲外の場合は、ツールボックスの一番下に挿入します。新しい項目のテキストはtext に設定され、icon はtext の左に表示されます。
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.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。