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() を使用して、代わりにウィジェットを挿入できます。適切なウィジェットの例は、QSpinBox 、QDoubleSpinBox 、QComboBox である。ツールバーボタンが押されると、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.