QActionGroup Class

QActionGroup 클래스는 액션을 함께 그룹화합니다. 더 보기...

헤더: #include <QActionGroup>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
이후: Qt 6.0
상속합니다: QObject

공용 형

enum class ExclusionPolicy { None, Exclusive, ExclusiveOptional }

속성

공용 기능

QActionGroup(QObject *parent)
virtual ~QActionGroup()
QList<QAction *> actions() const
QAction *addAction(QAction *action)
QAction *addAction(const QString &text)
QAction *addAction(const QIcon &icon, const QString &text)
QAction *checkedAction() const
QActionGroup::ExclusionPolicy exclusionPolicy() const
bool isEnabled() const
bool isExclusive() const
bool isVisible() const
void removeAction(QAction *action)

공용 슬롯

void setDisabled(bool b)
void setEnabled(bool)
void setExclusionPolicy(QActionGroup::ExclusionPolicy policy)
void setExclusive(bool b)
void setVisible(bool)

신호

void hovered(QAction *action)
void triggered(QAction *action)

상세 설명

QActionGroup은 QAction 객체를 상속하는 클래스를 함께 그룹화하는 클래스를 위한 베이스 클래스입니다.

어떤 상황에서는 QAction 객체를 함께 그룹화하는 것이 유용할 수 있습니다. 예를 들어 Left Align 액션, Right Align 액션, Justify 액션, Center 액션이 있는 경우 이 액션 중 하나만 한 번에 활성화해야 합니다. 이를 달성하는 간단한 방법 중 하나는 QActionGroup을 상속하여 액션 그룹에서 액션을 함께 그룹화하는 것입니다.

QAction참조하세요 .

멤버 유형 문서

enum class QActionGroup::ExclusionPolicy

이 열거형은 그룹이 확인 가능한 작업에 대한 독점 확인을 수행하는 방법을 제어하는 데 사용할 수 있는 다양한 정책을 지정합니다.

Constant설명
QActionGroup::ExclusionPolicy::None0그룹의 작업은 서로 독립적으로 확인할 수 있습니다.
QActionGroup::ExclusionPolicy::Exclusive1한 번에 정확히 하나의 작업만 확인할 수 있습니다. 이것이 기본 정책입니다.
QActionGroup::ExclusionPolicy::ExclusiveOptional2한 번에 최대 하나의 작업만 확인할 수 있습니다. 작업을 모두 선택 해제할 수도 있습니다.

exclusionPolicy참조하세요 .

속성 문서

enabled : bool

이 속성은 작업 그룹이 활성화되었는지 여부를 보유합니다.

그룹의 각 작업은 명시적으로 비활성화하지 않는 한 활성화 또는 비활성화됩니다.

기능에 액세스합니다:

bool isEnabled() const
void setEnabled(bool)

QAction::setEnabled()도 참조하세요 .

exclusionPolicy : QActionGroup::ExclusionPolicy

이 속성은 그룹 독점 확인 정책을 보유합니다.

제외정책이 배타적으로 설정되어 있으면 액션 그룹에서 한 번에 하나의 확인 가능한 액션만 활성화할 수 있습니다. 사용자가 그룹에서 다른 확인 가능한 작업을 선택하면 선택한 작업이 활성화되고 활성화되어 있던 작업은 비활성화됩니다. 제외정책이 제외선택으로 설정된 경우 그룹은 배타적이지만 그룹에서 확인 가능한 활성 작업을 선택 해제하면 그룹은 확인된 작업이 없는 상태로 남을 수 있습니다.

액세스 기능:

QActionGroup::ExclusionPolicy exclusionPolicy() const
void setExclusionPolicy(QActionGroup::ExclusionPolicy policy)

QAction::checkable참조하세요 .

visible : bool

이 속성은 작업 그룹이 표시되는지 여부를 보유합니다.

액션 그룹의 각 액션은 명시적으로 숨겨져 있지 않는 한 이 그룹의 표시 상태와 일치합니다.

함수 액세스:

bool isVisible() const
void setVisible(bool)

QAction::setEnabled()도 참조하세요 .

멤버 함수 문서

[explicit] QActionGroup::QActionGroup(QObject *parent)

parent 개체에 대한 작업 그룹을 구성합니다.

액션 그룹은 기본적으로 독점적입니다. 액션 그룹을 비독점적으로 만들려면 setExclusive(거짓)을 호출합니다. 그룹을 독점적으로 만들되 활성 액션의 선택을 취소하려면 setExclusionPolicy(QActionGroup::ExclusionPolicy::ExclusiveOptional)를 호출합니다.

[virtual noexcept] QActionGroup::~QActionGroup()

액션 그룹을 파괴합니다.

QList<QAction *> QActionGroup::actions() const

이 그룹의 작업 목록을 반환합니다. 비어 있을 수 있습니다.

QAction *QActionGroup::addAction(QAction *action)

이 그룹에 action 을 추가하고 반환합니다.

일반적으로 그룹을 부모로 하여 그룹을 만들면 액션이 그룹에 추가되므로 이 함수는 일반적으로 사용되지 않습니다.

QAction::setActionGroup()도 참조하세요 .

QAction *QActionGroup::addAction(const QString &text)

text 로 액션을 생성하고 반환합니다. 새로 만든 액션은 이 액션 그룹의 자식입니다.

일반적으로 그룹을 부모로 하여 액션을 만들면 그룹에 액션이 추가되므로 이 함수는 일반적으로 사용되지 않습니다.

QAction::setActionGroup()도 참조하세요 .

QAction *QActionGroup::addAction(const QIcon &icon, const QString &text)

texticon 을 사용하여 액션을 만들고 반환합니다. 새로 만든 액션은 이 액션 그룹의 자식입니다.

일반적으로 그룹을 부모로 하여 액션을 만들면 그룹에 액션이 추가되므로 이 함수는 일반적으로 사용되지 않습니다.

QAction::setActionGroup()도 참조하세요 .

QAction *QActionGroup::checkedAction() const

그룹에서 현재 확인된 작업을 반환하거나, 확인된 작업이 없는 경우 nullptr 을 반환합니다.

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

이 신호는 사용자가 메뉴 옵션이나 툴바 버튼 위에 커서를 올려놓고 일시 정지하거나 작업의 바로 가기 키 조합을 누르는 등 작업 그룹에서 지정된 action 을 강조 표시할 때 발생합니다.

QAction::activate()도 참조하세요 .

bool QActionGroup::isExclusive() const

그룹이 독점인 경우 true를 반환합니다.

ExclusionPolicy 이 독점 또는 제외 옵션인 경우 그룹은 독점적입니다.

void QActionGroup::removeAction(QAction *action)

이 그룹에서 action 을 제거합니다. 결과적으로 이 작업에는 부모가 없습니다.

QAction::setActionGroup()도 참조하세요 .

[slot] void QActionGroup::setDisabled(bool b)

이는 enabled 속성의 편의 기능으로, 신호-슬롯 연결에 유용합니다. b 이 참이면 액션 그룹이 비활성화되고, 그렇지 않으면 활성화됩니다.

[slot] void QActionGroup::setExclusive(bool b)

그룹 제외 확인 활성화 또는 비활성화하기

b 이 참이면 setExclusionPolicy(ExclusionPolicy::Exclusive), 그렇지 않으면 setExclusionPolicy(QActionGroup::ExclusionPolicy::None)을 호출하는 편리한 방법입니다.

isExclusive() 및 QActionGroup::exclusionPolicy참조하세요 .

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

이 신호는 사용자가 메뉴 옵션이나 툴바 버튼을 클릭하거나 작업의 바로 가기 키 조합을 누르는 등 작업 그룹에 지정된 action 을 활성화할 때 발생합니다.

명령 동작을 보려면 이 신호에 연결하세요.

QAction::activate()도 참조하세요 .

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.