QMenu Class

メンバ関数ドキュメント

[explicit] QMenu::QMenu(QWidget *parent = nullptr)

親を持つメニューを構築するparent 。

ポップアップメニューは常にトップレベルのウィジェットですが、親が渡された場合、その親が破棄されるとポップアップメニューは削除されます（他のQObject と同様）。

[explicit] QMenu::QMenu(const QString &title, QWidget *parent = nullptr)

title とparent でメニューを構築します。

ポップアップメニューは常にトップレベルのウィジェットですが、親が渡された場合、その親が破棄されるとポップアップメニューは削除されます (他のQObject と同様)。

titleも参照して ください。

[virtual noexcept] QMenu::~QMenu()

メニューを破壊する。

[signal] void QMenu::aboutToHide()

このシグナルは、メニューがユーザーから隠される直前に発せられる。

aboutToShow() およびhide()も参照のこと 。

[signal] void QMenu::aboutToShow()

このシグナルは、メニューがユーザーに表示される直前に発せられる。

aboutToHide() およびshow()も参照のこと 。

QAction *QMenu::actionAt(const QPoint &pt) const

pt にあるアイテムを返す。そこにアイテムがない場合はnullptr を返す。

[override virtual protected] void QMenu::actionEvent(QActionEvent *e)

再実装：QWidget::actionEvent(QActionEvent *event)。

QRect QMenu::actionGeometry(QAction *act) const

アクションのジオメトリを返すact 。

QAction *QMenu::activeAction() const

現在ハイライトされているアクションを返します。現在ハイライトされているアクションがない場合はnullptr を返します。

setActiveAction()も参照 。

QAction *QMenu::addMenu(QMenu *menu)

この便利な関数は、このメニューにサブメニューとしてmenu を追加する。この関数はmenu のmenuAction() を返す。このメニューはmenu の所有権を持たない。

QWidget::addAction() およびQMenu::menuAction()も参照 。

QMenu *QMenu::addMenu(const QString &title)

title を持つ新しいQMenu を menu に追加する。menu はその所有権を持つ。新しいメニューを返す。

QWidget::addAction() およびQMenu::menuAction()も参照 。

QMenu *QMenu::addMenu(const QIcon &icon, const QString &title)

icon とtitle を持つ新しいQMenu をメニューに追加する。menu はその所有権を持つ。新しいメニューを返す。

QWidget::addAction() およびQMenu::menuAction()も参照 。

QAction *QMenu::addSection(const QString &text)

この便利な関数は、新しいセクションアクション、すなわちQAction::isSeparator() が true を返し、かつtext ヒントを持つアクションを作成し、新しいアクションをこのメニューのアクションリストに追加する。この関数は新しく作成されたアクションを返します。

ヒントのレンダリングはスタイルとプラットフォームに依存します。ウィジェットスタイルは、セクションのレンダリングにテキスト情報を使用することも、それを無視して単純なセパレータのようにセクションをレンダリングすることもできます。

QMenu は、返された の所有権を取得します。QAction

QWidget::addAction()も参照してください 。

QAction *QMenu::addSection(const QIcon &icon, const QString &text)

この便利な関数は新しいセクションアクション、すなわちQAction::isSeparator() が true を返し、text とicon のヒントを持つアクションを作成し、新しいアクションをこのメニューのアクションリストに追加する。新しく作成されたアクションを返す。

ヒントのレンダリングはスタイルとプラットフォームに依存します。ウィジェットスタイルは、セクションのレンダリングにテキストとアイコンの情報を使用することも、それらを無視してセクションを単純なセパレータのようにレンダリングすることもできます。

QMenu 返された の所有権を取得します。QAction

QWidget::addAction()も参照してください 。

QAction *QMenu::addSeparator()

この便利な関数は新しいセパレータアクション、すなわちQAction::isSeparator() が true を返すアクションを作成し、新しいアクションをこのメニューのアクションリストに追加する。新しく作成されたアクションを返します。

QMenu 返された の所有権を取得します。QAction

QWidget::addAction()も参照してください 。

[override virtual protected] void QMenu::changeEvent(QEvent *e)

再実装：QWidget::changeEvent(QEvent *event)。

void QMenu::clear()

メニューのすべてのアクションを削除する。メニューが所有し、他のウィジェットに表示されていないアクションは削除されます。

removeAction()も参照してください 。

[protected] int QMenu::columnCount() const

メニューが画面に収まらない場合は、収まるようにレイアウトされます。レイアウトが何を意味するかはスタイルに依存する（例えば、Windowsでは複数のカラムを使用する）。

この関数は必要なカラム数を返します。

QAction *QMenu::defaultAction() const

現在のデフォルトのアクションを返します。

setDefaultAction()も参照ください 。

[override virtual protected] void QMenu::enterEvent(QEnterEvent *)

再インプリメント：QWidget::enterEvent(QEnterEvent *event).

[override virtual protected] bool QMenu::event(QEvent *e)

再実装：QWidget::event(QEvent *event)。

QAction *QMenu::exec()

このメニューを同期的に実行する。

これはexec(pos()) と同じである。

これはポップアップメニューまたはそのサブメニューのいずれかでトリガーされたQAction 、トリガーされた項目がない場合はnullptr （通常はユーザーがEscを押したため）を返します。

ほとんどの場合、現在のマウスの位置など、自分で位置を指定したいでしょう：

exec(QCursor::pos());

または、ウィジェットにアライメントされている場合：

exec(somewidget.mapToGlobal(QPoint(0,0)));

または、QMouseEvent *e.に反応した場合などです：

exec(e->globalPosition().toPoint());

QAction *QMenu::exec(const QPoint &p, QAction *action = nullptr)

これはオーバーロードされた関数です。

このメニューを同期的に実行する。

指定されたグローバル位置p にアクションaction が来るようにメニューをポップアップします。ウィジェットのローカル座標をグローバル座標に変換するには、QWidget::mapToGlobal() を使用します。

これは、ポップアップメニューまたはそのサブメニューのいずれかでトリガーされたQAction を返し、アイテムがトリガーされなかった場合はnullptr を返します（通常は、ユーザーが Esc キーを押したため）。

すべてのシグナルは通常通り発せられることに注意してください。QAction 、スロットに接続してメニューのexec()を呼び出すと、シグナルとスロットの接続とexec()の戻り値の両方で結果が得られます。

一般的な使い方は、現在のマウス位置にメニューを配置することです：

exec(QCursor::pos());

または、ウィジェットにアライメントする：

exec(somewidget.mapToGlobal(QPoint(0, 0)));

または、QMouseEvent *eに反応することです：

exec(e->globalPosition().toPoint());

exec()やpopup()でメニューを配置する場合、メニューの現在のsize()に依存することはできないことに注意してください。パフォーマンス上の理由から、メニューは必要なときだけサイズを変更します。そのため、多くの場合、表示前と表示後ではサイズが異なります。代わりに、メニューの現在の内容に応じて適切なサイズを計算するsizeHint() を使用する。

popup() およびQWidget::mapToGlobal()も参照の こと。

[static] QAction *QMenu::exec(const QList<QAction *> &actions, const QPoint &pos, QAction *at = nullptr, QWidget *parent = nullptr)

これはオーバーロードされた関数である。

メニューを同期的に実行する。

メニューのアクションはactions のリストで指定される。メニューは指定されたアクションat がグローバルな位置pos に現れるようにポップアップする。at が指定されない場合、メニューはpos の位置に表示されます。parent はメニューの親ウィジェットです。親を指定することで、pos だけではメニューの移動先を決定できない場合（複数のデスクトップがある場合や、親がQGraphicsView に埋め込まれている場合など）にコンテキストを提供します。

この関数は、ポップアップメニューまたはそのサブメニューのいずれかでトリガーされたQAction を返し、アイテムがトリガーされなかった場合はnullptr を返します（通常はユーザーが Esc キーを押したため）。

これは以下と等価である：

QMenu menu;
QAction *at = actions[0]; // Assumes actions is not empty
for (QAction *a : std::as_const(actions))
    menu.addAction(a);
menu.exec(pos, at);

popup() およびQWidget::mapToGlobal()も参照 。

[override virtual protected] bool QMenu::focusNextPrevChild(bool next)

再インプリメント：QWidget::focusNextPrevChild(bool next).

[override virtual protected] void QMenu::hideEvent(QHideEvent *)

再実装：QWidget::hideEvent(QHideEvent *event).

void QMenu::hideTearOffMenu()

この関数は、ちぎれたメニューを強制的に非表示にし、ユーザーのデスクトップから消えるようにする。

showTearOffMenu(),isTearOffMenuVisible(),isTearOffEnabled()も参照のこと 。

[signal] void QMenu::hovered(QAction *action)

このシグナルは、メニューアクションがハイライトされたときに発せられる。action は、シグナルが発せられる原因となったアクションである。

多くの場合、これはステータス情報を更新するために使われる。

triggered() およびQAction::hovered()も参照の こと。

[virtual protected] void QMenu::initStyleOption(QStyleOptionMenuItem *option, const QAction *action) const

このメニューの値とaction の情報でoption を初期化する。このメソッドは、サブクラスがQStyleOptionMenuItem を必要とするが、すべての情報を自分で入力したくない場合に便利である。

QStyleOption::initFrom() およびQMenuBar::initStyleOption()も参照 。

QAction *QMenu::insertMenu(QAction *before, QMenu *menu)

この便利な関数は、menu をアクションbefore の前に挿入し、メニューmenuAction() を返す。

QWidget::insertAction() およびaddMenu()も参照のこと 。

QAction *QMenu::insertSection(QAction *before, const QString &text)

この便利な関数は新しいタイトルアクション、すなわちQAction::isSeparator() が真を返し、かつtext ヒントを持つアクションを作成します。この関数は、新しく作成されたアクションをアクションbefore の前に挿入して返します。

ヒントのレンダリングはスタイルとプラットフォームに依存します。ウィジェットスタイルは、セクションのレンダリングにテキスト情報を使用することも、それを無視してセクションを単純なセパレータのようにレンダリングすることもできます。

QMenu は、返された の所有権を持つ。QAction

QWidget::insertAction() およびaddSection()も参照のこと 。

QAction *QMenu::insertSection(QAction *before, const QIcon &icon, const QString &text)

この便利な関数は新しいタイトルアクション、すなわちQAction::isSeparator() が真を返し、text とicon のヒントを持つアクションを作成します。この関数は、新しく作成されたアクションをアクションbefore の前に挿入して返します。

ヒントのレンダリングはスタイルとプラットフォームに依存します。ウィジェットスタイルは、セクションのレンダリングにテキストとアイコンの情報を使用することも、それらを無視してセクションを単純なセパレータのようにレンダリングすることもできます。

QMenu 返された の所有権を取得します。QAction

QWidget::insertAction() およびaddSection()も参照のこと 。

QAction *QMenu::insertSeparator(QAction *before)

この便利な関数は、新しいセパレーターアクション、すなわちQAction::isSeparator() が真を返すアクションを作成します。この関数は、新しく作成されたアクションを、このメニューのアクションリストに、アクションbefore の前に挿入して返します。

QMenu この関数は、返された の所有権を持ちます。QAction

QWidget::insertAction() およびaddSeparator()も参照 。

bool QMenu::isEmpty() const

メニューに可視アクションが挿入されていない場合はtrue を返し、そうでない場合は false を返します。

QWidget::actions()も参照 。

bool QMenu::isTearOffMenuVisible() const

メニューが引き裂かれると、メニューの内容を新しいウィンドウに表示するために、2番目のメニューが表示される。メニューがこのモードにあり、メニューが表示されている場合はtrue を返し、そうでない場合は false を返す。

showTearOffMenu(),hideTearOffMenu(),isTearOffEnabled()も参照の こと。

[override virtual protected] void QMenu::keyPressEvent(QKeyEvent *e)

再実装：QWidget::keyPressEvent(QKeyEvent *event)。

[override virtual protected] void QMenu::leaveEvent(QEvent *)

再実装：QWidget::leaveEvent(QEvent *event)。

QAction *QMenu::menuAction() const

このメニューに関連付けられたアクションを返します。

[static] QMenu *QMenu::menuInAction(const QAction *action)

action が含むメニュー、またはaction がメニューを含まない場合はnullptr を返す。

ウィジェットアプリケーションでは、メニューを含むアクションを使用して、サブメニューを持つメニュー項目を作成したり、ツールバーに挿入して、ポップアップメニューを持つボタンを作成することができます。

[override virtual protected] void QMenu::mouseMoveEvent(QMouseEvent *e)

再実装：QWidget::mouseMoveEvent(QMouseEvent *event)。

[override virtual protected] void QMenu::mousePressEvent(QMouseEvent *e)

再実装：QWidget::mousePressEvent(QMouseEvent *event)。

[override virtual protected] void QMenu::mouseReleaseEvent(QMouseEvent *e)

再実装：QWidget::mouseReleaseEvent(QMouseEvent *event)。

[override virtual protected] void QMenu::paintEvent(QPaintEvent *e)

再実装：QWidget::paintEvent(QPaintEvent *event)。

void QMenu::popup(const QPoint &p, QAction *atAction = nullptr)

アクションatAction が指定されたグローバル位置p に来るようにメニューを表示する。ウィジェットのローカル座標をグローバル座標に変換するには、QWidget::mapToGlobal() を使用します。

exec() や popup() でメニューを配置する場合、メニューの現在のsize() に依存できないことに注意してください。パフォーマンス上の理由から、メニューは必要なときだけサイズを変更するので、多くの場合、表示前と表示後のサイズは異なります。代わりに、メニューの現在の内容に応じて適切なサイズを計算するsizeHint() を使用する。

QWidget::mapToGlobal() およびexec()も参照の こと。

void QMenu::setActiveAction(QAction *act)

現在ハイライトされているアクションをact に設定する。

activeAction()も参照 。

void QMenu::setAsDockMenu()

アプリケーションのドックアイコンをオプションクリックすると表示されるドックメニューに設定します。macOSでのみ利用可能です。

void QMenu::setDefaultAction(QAction *act)

これは、デフォルトのアクションをact に設定する。 デフォルトのアクションは、現在のQStyle に応じて、視覚的なキューを持つことができる。デフォルトアクションは通常、ドロップが発生したときにデフォルトで何が起こるかを示します。

defaultAction()も参照してください 。

void QMenu::showTearOffMenu(const QPoint &pos)

この関数は、引き裂かれたメニューを強制的に表示し、指定されたグローバル位置pos にユーザーのデスクトップ上に表示させる。

hideTearOffMenu(),isTearOffMenuVisible(),isTearOffEnabled()も参照のこと 。

void QMenu::showTearOffMenu()

これはオーバーロードされた関数です。

この関数は、強制的にちぎれたメニューを表示し、マウスカーソルの下にあるユーザーのデスクトップに表示させる。

hideTearOffMenu(),isTearOffMenuVisible(),isTearOffEnabled()も参照のこと 。

[override virtual] QSize QMenu::sizeHint() const

QWidget::sizeHint 。

[override virtual protected] void QMenu::timerEvent(QTimerEvent *e)

再実装：QObject::timerEvent(QTimerEvent *event).

NSMenu *QMenu::toNSMenu()

このメニューのネイティブ NSMenu を返します。macOS でのみ利用可能です。

[signal] void QMenu::triggered(QAction *action)

このシグナルは、このメニューのアクションがトリガーされたときに発せられる。

action はシグナルが発せられる原因となったアクションです。

通常は、各メニューアクションのtriggered() シグナルをそれぞれのカスタムスロットに接続します。しかし、例えば、"left justify"、"center"、"right justify "のような密接に関連したアクションのグループがある場合など、複数のアクションを1つのスロットに接続したいことがあります。

hovered() およびQAction::triggered()も参照の こと。

[override virtual protected] void QMenu::wheelEvent(QWheelEvent *e)

再実装：QWidget::wheelEvent(QWheelEvent *event)。