ツールバー

見出し

QMainWindow クラス - ツールバー

QMainWindow クラスのツールバー関係の機能を紹介しています。
公式リファレンス

Qtにおけるツールバー

ツールバーは QToolBar クラスで実装されています。

継承関係

QObject
QPaintDevice
┗QWidget
　┣QMainWindow
　┗QToolBar

関連するメソッド

ツールバーを追加する

void QMainWindow::addToolBar(Qt::ToolBarArea area, QToolBar * toolbar)

メインウィンドウに指定ツールバーを指定領域に追加します。
追加したツールバーは既に存在するツールバーの後ろに配置されます。

パラメータ

• area ツールバーを追加する領域
• toolbar メインウィンドウに追加するツールバー

メインウィンドウに既に指定ツールバーが存在する場合は、ツールバーを指定領域に移動させます。

enum Qt::ToolBarArea
flags Qt::ToolBarAreas

キー	値	説明
Qt::LeftToolBarArea	0x1	左のツールバーエリア
Qt::RightToolBarArea	0x2	右のツールバーエリア
Qt::TopToolBarArea	0x4	上のツールバーエリア
Qt::BottomToolBarArea	0x8	下のツールバーエリア
Qt::AllToolBarAreas	ToolBarArea_Mask	使用しません
Qt::NoToolBarArea	0	Null

---

void QMainWindow::addToolBar(QToolBar * toolbar)

メインウィンドウに指定ツールバーを上側に追加します。
追加したツールバーは既に存在するツールバーの後ろに配置されます。

パラメータ

• toolbar メインウィンドウに追加するツールバー

メインウィンドウに既に指定ツールバーが存在する場合は、ツールバーを上側に移動させます。
addToolBar(Qt::TopToolBarArea, toolbar) と同じです。

---

QToolBar * QMainWindow::addToolBar(const QString & title)

QToolBar オブジェクトを生成してメインウィンドウの上側に追加します。
メインウィンドウのタイトルに指定文字列を設定します。

パラメータ

• title メインウィンドウのタイトル

---

void QMainWindow::insertToolBar(QToolBar * before, QToolBar * toolbar)

指定ツールバーをツールバー before が存在する領域に追加します。
追加したツールバーは既にツールバー before の前に配置されます。

ツールバーを解除する

void QMainWindow::removeToolBar(QToolBar * toolbar)

このメインウィンドウから指定ツールバーを解除して見えなくします。

注意

指定ツールバーが削除されるわけではありません。

区切りを追加する

void QMainWindow::addToolBarBreak(Qt::ToolBarArea area = Qt::TopToolBarArea)

指定領域の配置されているすべてのツールバーの後に区切りを挿入します。

パラメータ

• area この領域に配置されているすべてのツールバーの後に区切りを挿入します

---

void QMainWindow::insertToolBarBreak(QToolBar * before)

指定ツールバーの前に区切りを挿入します。

パラメータ

• before このツールバーの前に区切りを挿入します

区切りを削除する

void QMainWindow::removeToolBarBreak(QToolBar * before)

指定ツールバーの前に挿入されている区切りを削除します。

その他

Qt::ToolBarArea QMainWindow::toolBarArea(QToolBar * toolbar) const

指定ツールバーが配置されている領域を返します。
指定ツールバーがこのメインウィンドウに追加されていない場合は Qt::NoToolBarArea を返します。

パラメータ

• toolbar チェックするツールバー

---

bool QMainWindow::toolBarBreak(QToolBar * toolbar) const

指定ツールバーの前に区切りが挿入されている場合はtrue、そうでない場合はfalseを返します。

パラメータ

• toolbar チェックするツールバー

ツールバーのアイコン

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

このメインウィンドウに配置されているツールバーのボタンの大きさを取得及び設定します。

---

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

このメインウィンドウに配置されているツールバーのボタンの大きさが変更された際に送出されます。
変更後のボタンの大きさは iconSize で取得できます。

---

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

このメインウィンドウに配置されているツールバーのボタンのスタイルを取得及び設定します。
デフォルト値は Qt::ToolButtonIconOnly です。

enum Qt::ToolButtonStyle

キー	値	説明
Qt::ToolButtonIconOnly	0	アイコンのみ表示します。
Qt::ToolButtonTextOnly	1	テキストのみ表示します。
Qt::ToolButtonTextBesideIcon	2	アイコンの脇にテキストを表示します。
Qt::ToolButtonTextUnderIcon	3	アイコンの下にテキストを表示します。
Qt::ToolButtonFollowStyle	4	スタイルに従います。

---

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

このメインウィンドウに配置されているツールバーのボタンのスタイルが変更された際に送出されます。
変更後のスタイルは toolButtonStyle で取得できます。

---