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() を使用して、代わりにウィジェットを挿入できます。適切なウィジェットの例は、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 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.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。