QToolBar Class

QToolBarクラスは、コントロールのセットを含む移動可能なパネルを提供します。詳細...

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

プロパティ

パブリック機能

QToolBar(QWidget *parent = nullptr)
QToolBar(const QString &title, QWidget *parent = nullptr)
virtual ~QToolBar()
QAction *actionAt(const QPoint &p) const
QAction *actionAt(int x, int y) const
QAction *addSeparator()
QAction *addWidget(QWidget *widget)
Qt::ToolBarAreas allowedAreas() const
void clear()
QSize iconSize() const
QAction *insertSeparator(QAction *before)
QAction *insertWidget(QAction *before, QWidget *widget)
bool isAreaAllowed(Qt::ToolBarArea area) const
bool isFloatable() const
bool isFloating() const
bool isMovable() const
Qt::Orientation orientation() const
void setAllowedAreas(Qt::ToolBarAreas areas)
void setFloatable(bool floatable)
void setMovable(bool movable)
void setOrientation(Qt::Orientation orientation)
QAction *toggleViewAction() const
Qt::ToolButtonStyle toolButtonStyle() const
QWidget *widgetForAction(QAction *action) const

パブリックスロット

void setIconSize(const QSize &iconSize)
void setToolButtonStyle(Qt::ToolButtonStyle toolButtonStyle)

シグナル

void actionTriggered(QAction *action)
void allowedAreasChanged(Qt::ToolBarAreas allowedAreas)
void iconSizeChanged(const QSize &iconSize)
void movableChanged(bool movable)
void orientationChanged(Qt::Orientation orientation)
void toolButtonStyleChanged(Qt::ToolButtonStyle toolButtonStyle)
void topLevelChanged(bool topLevel)
void visibilityChanged(bool visible)

再実装された保護された関数

virtual void actionEvent(QActionEvent *event) override
virtual void changeEvent(QEvent *event) override
virtual bool event(QEvent *event) override
virtual void paintEvent(QPaintEvent *event) override

詳細説明

ツールバーは通常、QMainWindow::addToolBar(const QString &title)を呼び出すことで作成されますが、例えば、QVBoxLayout の最初のウィジェットとして追加することもできます。

ツールバーのボタンは、addAction() またはinsertAction() を使用して、アクションを追加することによって追加されます。ボタンのグループは、addSeparator ()またはinsertSeparator ()を使用して区切ることができます。ツールバー・ボタンが適切でない場合は、addWidget() またはinsertWidget() を使用して、代わりにウィジェットを挿入できます。適切なウィジェットの例は、QSpinBoxQDoubleSpinBoxQComboBox である。ツールバーボタンが押されると、actionTriggered() シグナルを発します。

ツールバーは、特定の領域(ウィンドウの上部など)に固定することも、 ツールバー領域間を移動することもできる。setMovable ()、isMovable ()、allowedAreas ()、isAreaAllowed ()を参照。

ツールバーのサイズが変更され、すべての項目を表示するには小さすぎる場合、拡張ボタンがツールバーの最後の項目として表示されます。拡張ボタンを押すと、現在ツールバーに収まっていない項目を含むメニューがポップアップ表示されます。

QToolBar がQMainWindow の子でない場合、addWidget() を使用してツールバーに追加されたウィジェットで拡張ポップアップをポップアップする機能を失います。代わりに、QWidgetAction を継承し、QWidgetAction::createWidget() を実装することによって作成されたウィジェット・アクションを使用してください。

QToolButton,QMenu,QActionも参照してください

プロパティ・ドキュメント

allowedAreas : Qt::ToolBarAreas

ツールバーを配置できる領域

デフォルトはQt::AllToolBarAreas です。

このプロパティが意味を持つのは、ツールバーがQMainWindow にある場合のみです。

アクセス関数:

Qt::ToolBarAreas allowedAreas() const
void setAllowedAreas(Qt::ToolBarAreas areas)

ノーティファイア・シグナル:

void allowedAreasChanged(Qt::ToolBarAreas allowedAreas)

movableも参照してください

floatable : bool

このプロパティは、ツールバーを独立したウィンドウとしてドラッグ&ドロップできるかどうかを保持します。

デフォルトはtrueです。

アクセス関数:

bool isFloatable() const
void setFloatable(bool floatable)

[read-only] floating : const bool

このプロパティは、ツールバーが独立したウィンドウであるかどうかを保持する。

デフォルトでは、このプロパティはtrue です。

アクセス関数:

bool isFloating() const

QWidget::isWindow()も参照してください

iconSize : QSize

ツールバーのアイコンのサイズ。

デフォルトのサイズはアプリケーションのスタイルによって決定され、QStyle::PM_ToolBarIconSize ピクセルのメトリックから派生します。アイコンの最大サイズです。これより小さいサイズのアイコンは拡大されません。

アクセス関数:

QSize iconSize() const
void setIconSize(const QSize &iconSize)

通知シグナル

void iconSizeChanged(const QSize &iconSize)

movable : bool

このプロパティは、ユーザがツールバー領域内でツールバーを移動できるか、ツールバー領域間でツールバーを移動できるかを保持する。

デフォルトでは、このプロパティはtrue です。

このプロパティは、ツールバーがQMainWindow にある場合にのみ意味を持ちます。

アクセス関数:

bool isMovable() const
void setMovable(bool movable)

ノーティファイア・シグナル:

void movableChanged(bool movable)

allowedAreasも参照してください

orientation : Qt::Orientation

ツールバーの向き

デフォルトはQt::Horizontal です。

ツールバーがQMainWindow で管理されている場合は、この関数を使用しないでください。すでにメイン・ウィンドウに追加されているツールバーを別のQt::ToolBarArea に移動したい場合は、QMainWindow::addToolBar() またはQMainWindow::insertToolBar() を使用できます。

アクセス関数:

Qt::Orientation orientation() const
void setOrientation(Qt::Orientation orientation)

通知シグナル:

void orientationChanged(Qt::Orientation orientation)

toolButtonStyle : Qt::ToolButtonStyle

このプロパティは、ツールバー・ボタンのスタイルを保持します。

このプロパティは、QActionとして追加されるすべてのツールボタンのスタイルを定義します。addWidget() メソッドでQToolButton を追加した場合、このボタンスタイルは得られないことに注意してください。

ツール・ボタンのスタイルをシステム設定に従わせるには、このプロパティをQt::ToolButtonFollowStyle に設定します。Unixでは、デスクトップ環境のユーザー設定が使用されます。他のプラットフォームでは、Qt::ToolButtonFollowStyle はアイコンのみを意味します。

デフォルトはQt::ToolButtonIconOnly です。

アクセス関数:

Qt::ToolButtonStyle toolButtonStyle() const
void setToolButtonStyle(Qt::ToolButtonStyle toolButtonStyle)

Notifier シグナル:

void toolButtonStyleChanged(Qt::ToolButtonStyle toolButtonStyle)

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

[explicit] QToolBar::QToolBar(QWidget *parent = nullptr)

与えられたparent で QToolBar を構築します。

[explicit] QToolBar::QToolBar(const QString &title, QWidget *parent = nullptr)

与えられたparent で QToolBar を構築します。

与えられたウィンドウtitle はツールバーを識別し、QMainWindow によって提供されるコンテキストメニューに表示されます。

setWindowTitle()も参照してください

[virtual noexcept] QToolBar::~QToolBar()

ツールバーを破壊する。

QAction *QToolBar::actionAt(const QPoint &p) const

p におけるアクションを返す。アクションが見つからなかった場合、この関数は0を返す。

QWidget::childAt()も参照

QAction *QToolBar::actionAt(int x, int y) const

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

x,y の点のアクションを返す。アクションが見つからなかった場合、この関数はゼロを返す。

[override virtual protected] void QToolBar::actionEvent(QActionEvent *event)

再実装:QWidget::actionEvent(QActionEvent *event)。

[signal] void QToolBar::actionTriggered(QAction *action)

このシグナルは、ツールバーのアクションがトリガーされたときに発信されます。これは、アクションのツールボタンが押されたときや、ツールバーの外側でアクションがトリガーされたときに発生します。パラメータはトリガーされたaction を保持します。

QAction *QToolBar::addSeparator()

ツールバーの末尾にセパレータを追加する。

insertSeparator()も参照してください

QAction *QToolBar::addWidget(QWidget *widget)

与えられたwidget をツールバーの最後のアイテムとしてツールバーに追加する。

ツールバーはwidget の所有権を持ちます。

このメソッドでQToolButton を追加した場合、ツールバーのQt::ToolButtonStyle は尊重されません。

注: ウィジェットの可視性を変更するには、QAction::setVisible() を使用する必要があります。QWidget::setVisible()、QWidget::show()、QWidget::hide() を使用しても動作しません。

insertWidget()も参照してください

[signal] void QToolBar::allowedAreasChanged(Qt::ToolBarAreas allowedAreas)

このシグナルは、ツールバーが配置可能な領域のコレクションが変更されたときに発行される。ツールバーを配置できる新しい領域は、allowedAreas で指定されます。

注意: allowedAreas プロパティに対するノーティファイア・シグナルです。

allowedAreasも参照してください

[override virtual protected] void QToolBar::changeEvent(QEvent *event)

再実装:QWidget::changeEvent(QEvent *event)。

void QToolBar::clear()

ツールバーからすべてのアクションを削除します。

removeAction()も参照してください

[override virtual protected] bool QToolBar::event(QEvent *event)

再実装:QWidget::event(QEvent *event)。

[signal] void QToolBar::iconSizeChanged(const QSize &iconSize)

このシグナルはアイコンサイズが変更されたときに発行される。iconSize パラメータには、ツールバーの新しいアイコンサイズが格納されます。

注: iconSize プロパティに対するノーティファイア・シグナルです。

iconSize およびQMainWindow::iconSizeも参照してください

QAction *QToolBar::insertSeparator(QAction *before)

before アクションに関連付けられたツールバー項目の前に、セパレータをツールバーに挿入します。

addSeparator()も参照してください

QAction *QToolBar::insertWidget(QAction *before, QWidget *widget)

指定されたwidget を、before アクションに関連付けられたツールバー項目の前に挿入します。

注意: ウィジェットの可視性を変更するには、QAction::setVisible() を使用する必要があります。QWidget::setVisible()、QWidget::show()、QWidget::hide() を使用しても動作しません。

addWidget()も参照してください

bool QToolBar::isAreaAllowed(Qt::ToolBarArea area) const

このツールバーが与えられたarea でドッキング可能であればtrue を返し、そうでなければfalse を返す。

[signal] void QToolBar::movableChanged(bool movable)

このシグナルは、ツールバーが移動可能になったり固定されたりしたときに発せられる。ツールバーを移動できる場合、movable はtrueになり、そうでない場合はfalseになる。

注意: movable プロパティの通知シグナルです。

movableも参照してください

[signal] void QToolBar::orientationChanged(Qt::Orientation orientation)

このシグナルは、ツールバーの向きが変わったときに発せられる。orientation パラメータは、ツールバーの新しい向きを保持する。

注意: orientation プロパティの通知シグナルです。

orientationも参照してください

[override virtual protected] void QToolBar::paintEvent(QPaintEvent *event)

再実装:QWidget::paintEvent(QPaintEvent *event)。

QAction *QToolBar::toggleViewAction() const

このツールバーを表示または非表示にするために使用できるチェック可能なアクションを返します。

アクションのテキストは、ツールバーのウィンドウ・タイトルに設定されます。

QAction::text およびQWidget::windowTitleも参照して ください。

[signal] void QToolBar::toolButtonStyleChanged(Qt::ToolButtonStyle toolButtonStyle)

このシグナルは、ツールボタンのスタイルが変更されたときに発行されます。toolButtonStyle パラメータは、ツールバーの新しいツールボタンのスタイルを保持します。

注: プロパティtoolButtonStyle に対するノーティファイア・シグナルです。

toolButtonStyle およびQMainWindow::toolButtonStyleも参照してください

[signal] void QToolBar::topLevelChanged(bool topLevel)

このシグナルは、floating プロパティが変更されたときに発行される。topLevel パラメータは、ツールバーがフローティングになった場合はtrue、そうでない場合はfalseになります。

isWindow()も参照してください

[signal] void QToolBar::visibilityChanged(bool visible)

このシグナルは、ツールバーがvisible (または不可視)になったときに発せられる。これは、ウィジェットが非表示または表示されたときに発生します。

QWidget *QToolBar::widgetForAction(QAction *action) const

指定されたaction に関連付けられたウィジェットを返す。

addWidget()も参照してください

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