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 를 메뉴에 추가합니다. 이 메뉴는 해당 메뉴의 소유권을 인수합니다. 새로운 메뉴를 반환합니다.

QWidget::addAction() 및 QMenu::menuAction()도 참조하십시오 .

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

icon 및 title 을 포함하는 새로운 QMenu 객체를 메뉴에 추가합니다. 이 메뉴는 해당 메뉴의 소유권을 인수합니다. 새로운 메뉴를 반환합니다.

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 `를 반환하거나, 트리거된 항목이 없는 경우(일반적으로 사용자가 Esc 키를 누른 경우) ` nullptr `를 반환합니다.

대부분의 경우, 예를 들어 현재 마우스 위치와 같이 위치를 직접 지정하고 싶을 것입니다:

exec(QCursor::pos());

또는 위젯에 맞춰 정렬된 위치:

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

QMouseEvent *e에 반응하여:

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

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

이 메뉴를 동기식으로 실행합니다.

action 액션이 지정된 전역 위치 p 에 오도록 메뉴를 표시합니다. 위젯의 국소 좌표를 전역 좌표로 변환하려면 QWidget::mapToGlobal()를 사용하십시오.

이 함수는 팝업 메뉴나 그 하위 메뉴 중 하나에서 트리거된 QAction 를 반환하거나, 트리거된 항목이 없는 경우(일반적으로 사용자가 Esc 키를 누른 경우) nullptr 를 반환합니다.

모든 신호는 평소와 같이 발송된다는 점에 유의하십시오. 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 를 반환하거나, 트리거된 항목이 없는 경우(일반적으로 사용자가 Esc 키를 누른 경우) nullptr 를 반환합니다.

이는 다음 코드와 동일합니다:

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)

이 편의 함수는 action before 앞에 menu 을 삽입하고, menuAction() 메뉴를 반환합니다.

QWidget::insertAction() 및 addMenu()도 참조하십시오 .

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

이 편의 함수는 새로운 제목 액션을 생성합니다. 즉, ` QAction::isSeparator()`가 true를 반환하지만 ` text ` 힌트도 갖는 액션을 말합니다. 이 함수는 새로 생성된 액션을 이 메뉴의 액션 목록에서 ` before ` 액션 앞에 삽입한 후, 해당 메뉴를 반환합니다.

힌트의 렌더링 방식은 스타일과 플랫폼에 따라 달라집니다. 위젯 스타일은 렌더링 시 섹션에 텍스트 정보를 사용할 수도 있고, 이를 무시하고 섹션을 단순한 구분선처럼 렌더링하도록 선택할 수도 있습니다.

QMenu 반환된 ` QAction`의 소유권을 인수합니다.

QWidget::insertAction() 및 addSection()도 참조하십시오 .

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

이 편의 함수는 새로운 제목 액션을 생성합니다. 즉, ` QAction::isSeparator()`가 true를 반환하지만 ` text ` 및 ` icon ` 힌트를 함께 갖는 액션입니다. 이 함수는 새로 생성된 액션을 이 메뉴의 액션 목록에서 ` before ` 액션 바로 앞에 삽입한 후, 해당 메뉴를 반환합니다.

힌트의 렌더링 방식은 스타일과 플랫폼에 따라 다릅니다. 위젯 스타일은 섹션을 렌더링할 때 텍스트 및 아이콘 정보를 사용할 수도 있고, 이를 무시하고 섹션을 단순한 구분선처럼 렌더링할 수도 있습니다.

QMenu 반환된 ` QAction`의 소유권을 인수합니다.

QWidget::insertAction() 및 addSection()도 참조하십시오 .

QAction *QMenu::insertSeparator(QAction *before)

이 편의 함수는 새로운 구분자 액션을 생성합니다. 즉, ` QAction::isSeparator()`가 true를 반환하는 액션입니다. 이 함수는 새로 생성된 액션을 이 메뉴의 액션 목록에서 ` before ` 액션 바로 앞에 삽입한 후, 해당 메뉴를 반환합니다.

QMenu 반환된 ` QAction`의 소유권을 가져옵니다.

QWidget::insertAction() 및 addSeparator()도 참조하십시오 .

bool QMenu::isEmpty() const

메뉴에 표시되는 액션이 삽입되어 있지 않으면 true 를 반환하고, 그렇지 않으면 false를 반환합니다.

QWidget::actions()도 참조하십시오 .

bool QMenu::isTearOffMenuVisible() const

메뉴가 떼어지면, 메뉴 내용을 새 창에 표시하기 위해 두 번째 메뉴가 나타납니다. 메뉴가 이 모드에 있고 메뉴가 표시되어 있을 때 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()

이 메뉴를 애플리케이션 도크 아이콘을 Option 키를 누른 채 클릭했을 때 표시되는 도크 메뉴로 설정합니다. 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() 신호를 해당 액션의 사용자 정의 슬롯에 연결하지만, 예를 들어 “왼쪽 정렬”, “중앙 정렬”, “오른쪽 정렬”과 같이 밀접하게 관련된 액션 그룹이 있는 경우 등에는 여러 액션을 하나의 슬롯에 연결하고 싶을 때가 있습니다.

hovered() 및 QAction::triggered()도 참조하십시오 .

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

QWidget::wheelEvent(QWheelEvent *event)를 재구현합니다.