QToolBar Class

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

Header: #include <QToolBar>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Inherits: 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 pixel metricから派生します。アイコンの最大サイズです。これより小さいサイズのアイコンは拡大されません。

アクセス関数:

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)

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

注意: ウィジェットの可視性を変更するには、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 は真になり、そうでない場合は偽になります。

注意: 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()も参照してください

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