QMenu


※上記の広告は60日以上更新のないWIKIに表示されています。更新することで広告が下部へ移動します。

見出し


QMenu クラス

QMenu クラスはメニュー、コンテキストメニュー及び他のポップアップメニューで使用するためのメニューを提供します。
公式リファレンス

継承関係


プロパティ

icon
  • 型 … QIcon
  • 説明
    • このメニューのアイコンを保持します。
    • menuAction() の QAction::icon プロパティと同じです。
  • デフォルト
    • デフォルトでは、アイコンは設定されていません。Nullの QIcon オブジェクトが設定されています。
  • アクセサー
    • 取得 … QIcon icon() const
    • 設定 …void setIcon(const QIcon & icon)

separatorsCollapsible
  • 型 … bool
  • 説明
    • このプロパティがtrueの場合は、このメニューの連続する2つ以上の区切りは一つだけ表示します。
    • メニューの先頭及び末尾の区切りは表示しません。
  • デフォルト
    • デフォルトでは、trueです。
  • アクセサー
    • 取得 … bool separatorsCollapsible() const
    • 設定 …void setSeparatorsCollapsible(bool collapse)

tearOffEnabled
  • 型 … bool
  • 説明
  • デフォルト
    • デフォルトでは、falseです。
  • アクセサー
    • 取得 … bool isTearOffEnabled() const
    • 設定 …void setTearOffEnabled(bool)

title
  • 型 … QString
  • 説明
    • このメニューのタイトルを保持します。
    • menuAction() の QAction::text プロパティと同じです。
  • アクセサー
    • 取得 … QString title() const
    • 設定 …void setTitle(const QString & title)

toolTipsVisible
  • 型 … bool
  • 説明
    • このメニューのアクション項目にツールチップを表示するかどうかを保持します。
  • デフォルト
    • デフォルトでは、falseです。
  • アクセサー
    • 取得 … bool toolTipsVisible() const
    • 設定 …void setToolTipsVisible(bool visible)

メンバ関数

コンストラクタ

QMenu::QMenu(QWidget * parent = 0)
  • 説明
    • 指定した親を持つメニューを作成します。
  • パラメータ
    • parent … このメニューを所持する親ウィジェット
  • 注意
    • ポップアップメニューはトップレベルのウィジェットですが、親を設定した場合は、親が破棄されるとこのメニューも破棄されてしまいます。

QMenu::QMenu(const QString & title, QWidget * parent = 0)
  • 説明
    • 指定した親及びタイトルを持つメニューを作成します。
  • パラメータ
    • title … このメニューのタイトル
    • parent … このメニューを所持する親ウィジェット
  • 注意
    • ポップアップメニューはトップレベルのウィジェットですが、親を設定した場合は、親が破棄されるとこのメニューも破棄されてしまいます。

デストラクタ

QMenu::~QMenu()
  • 説明
    • このメニューを破棄します。

メニューを取得する

+ ...

メニューにサブメニューを追加する

+ ...

メニューにアクションを追加する

+ ...

区切りを追加する

+ ...

メニューからアクションを削除する

void QMenu::clear()
  • 説明
    • このメニューからすべてのアクションを削除します。
    • メニューが所有している他のウィジェットで表示されていないアクションを削除します。
  • 注意
    • MacOS Xでは注意が必要

メニューが空かどうかを調べる

bool QMenu::isEmpty() const
  • 説明
    • このメニューに表示できるアクションがひとつもない場合はtrue、そうでない場合はfalseを返します。
  • 返り値
    • このメニューに表示できるアクションがあるかどうか

このメニューのアクションを取得する

QAction * QMenu::menuAction() const
かんすう
  • 説明
    • このメニューに関連するアクションを返します。
  • 返り値
    • このメニューに関連するアクション

メニューの列数を取得する

QMenu::columnCount() const [protected]
  • 説明
    • メニューがスクリーンに収まらない場合は、収まるようにメニューを2列にするなどして表示します。その際の列数を返します。
  • パラメータ
    • パラメータ … 説明
    • パラメータ … 説明
  • 返り値
  • 注意
    • そうした場合にメニューのレイアウトをどのようにするかはプラットフォーム依存です。(Windows では複数行で表示されます)

ハイライトされたアクションを取得及び設定する

+ ...

メニューを実行する

+ ...

保留

void QMenu::hideTearOffMenu()
  • 説明
    • ユーザーのデスクトップからはみ出したメニューを強制的に隠します。

bool QMenu::isTearOffMenuVisible() const
  • 説明
    • メニューがちぎれた場合は2つ目のメニューをメニューの項目を新しいウィンドウに表示するために表示します。
    • メニューがこのモードであり、表示できる場合はtrue、そうでない場合はfalseを返します。

保留

void QMenu::initStyleOption(QStyleOptionMenuItem * option, const QAction * action) const [protected]
  • 説明
    • 保留
  • パラメータ
    • option … 説明
    • action … 説明
  • 注意
    • 保留

再実装

QSize QMenu::sizeHint() const [virtual]
  • 説明
    • QWidget::sizeHint() の再実装です。

bool QMenu::focusNextPrevChild(bool next) [virtual protected]
  • 説明
    • QWidget::focusNextPrevChild() の再実装です。

一部のOSのみサポートされている機能

デフォルトアクションを取得及び設定する

+ ...

NSメニューに変換する

MacOS Xでのみ利用できます。
NSMenu * QMenu::toNSMenu()
  • 説明
    • このメニューをNSメニューに変換して返します。
  • 返り値
    • NSメニュー

ドックメニューとして設定する

MacOS Xでのみ利用できます。
void QMenu::setAsDockMenu()
このメニューをドックメニューに設定します。
ドックメニューとはアプリケーションのドックアイコンをクリックすることで利用できるメニューです。

シグナル

void QMenu::aboutToHide() [signal]
  • 説明
    • メニューがユーザーから隠される前に送出されます。

void QMenu::aboutToShow() [signal]
  • 説明
    • メニューがユーザーから見えるよう表示される前に送出されます。

void QMenu::hovered(QAction * action) [signal]
  • 説明
    • このメニューのアクションにマウスオーバーした際に送出されます。
  • パラメータ
    • action … マウスオーバーされたアクション

void QMenu::triggered(QAction * action) [signal]
  • 説明
    • このメニューにあるメニューのアクションがマウスでクリックされた際に送出されます。
  • パラメータ
    • action … クリックされたアクション
  • 注意
    • 通常はメニューのアクションごとの QAction::triggered() シグナルをそれぞれの動作に対応したスロットに接続します。
    • このシグナルはこのメニューのメニューにあるすべてのアクションを一つのスロットにまとめて接続したい場合などに便利です。

スロット

void QMenu::setVisible(bool visible) [virtual slot]
  • 説明
    • QWidget::setVisible() の再実装です。

イベント

void QMenu::timerEvent(QTimerEvent * e) [virtual protected]
  • 説明
    • QObject::timerEvent() の再実装です。

void QMenu::changeEvent(QEvent * e) [virtual protected]
  • 説明
    • QWidget::changeEvent() の再実装です。

bool QMenu::event(QEvent * e) [virtual protected]
  • 説明
    • QObject::event() の再実装です。

void QMenu::keyPressEvent(QKeyEvent * e) [virtual protected]
  • 説明
    • QWidget::keyPressEvent() の再実装です。

void QMenu::mouseMoveEvent(QMouseEvent * e) [virtual protected]
  • 説明
    • QWidget::mouseMoveEvent() の再実装です。

void QMenu::mousePressEvent(QMouseEvent * e) [virtual protected]
  • 説明
    • QWidget::mousePressEvent() の再実装です。

void QMenu::mouseReleaseEvent(QMouseEvent * e) [virtual protected]
  • 説明
    • QWidget::mouseReleaseEvent() の再実装です。

void QMenu::leaveEvent(QEvent *) [virtual protected]
  • 説明
    • QWidget::leaveEvent() の再実装です。

QSize QMenu::minimumSizeHint() const [virtual]
  • 説明
    • QWidget::minimumSizeHint() の再実装です。

void QMenu::actionEvent(QActionEvent * e) [virtual protected]
  • 説明
    • QWidget::actionEvent() の再実装です。

void QMenu::paintEvent(QPaintEvent * e) [virtual protected]
  • 説明
    • QWidget::paintEvent() の再実装です。

void QMenu::resizeEvent(QResizeEvent *) [virtual protected]
  • 説明
    • QWidget::resizeEvent() の再実装です。

void QMenu::focusInEvent(QFocusEvent *) [virtual protected]
  • 説明
    • QWidget::focusInEvent() の再実装です。

void QMenu::focusOutEvent(QFocusEvent *) [virtual protected]
  • 説明
    • QWidget::focusOutEvent() の再実装です。

void QMenu::wheelEvent(QWheelEvent * e) [virtual protected]
  • 説明
    • QWidget::wheelEvent() の再実装です。

void QMenu::hideEvent(QHideEvent *) [virtual protected]
  • 説明
    • QWidget::hideEvent() の再実装です。