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 } |
속성
- enabled : bool
- exclusionPolicy : QActionGroup::ExclusionPolicy
- visible : bool
공개 함수
| 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) |
신호
상세 설명
QActionGroup은 ` QAction ` 객체를 상속하는 클래스들을 한데 묶는 클래스의 기저 클래스입니다.
어떤 상황에서는 ` QAction ` 객체들을 함께 그룹화하는 것이 유용합니다. 예를 들어, ` Left Align ` 액션, ` Right Align ` 액션, ` Justify ` 액션, ` Center ` 액션이 있는 경우, 한 번에 이 액션들 중 하나만 활성화되어야 합니다. 이를 달성하는 간단한 방법 중 하나는 `QActionGroup`을 상속하여 액션들을 액션 그룹으로 묶는 것입니다.
QAction도 참조하십시오 .
멤버 유형 문서
enum class QActionGroup::ExclusionPolicy
이 열거형은 그룹이 확인 가능한 작업에 대해 배타적 확인을 수행하는 방식을 제어하는 데 사용할 수 있는 다양한 정책을 지정합니다.
| 상수 | 값 | 설명 |
|---|---|---|
QActionGroup::ExclusionPolicy::None | 0 | 그룹 내의 액션은 서로 독립적으로 체크될 수 있습니다. |
QActionGroup::ExclusionPolicy::Exclusive | 1 | 한 번에 정확히 하나의 작업만 선택할 수 있습니다. 이것이 기본 정책입니다. |
QActionGroup::ExclusionPolicy::ExclusiveOptional | 2 | 한 번에 최대 하나의 작업만 선택할 수 있습니다. 모든 작업의 선택을 해제할 수도 있습니다. |
exclusionPolicy도 참조하십시오 .
속성 문서
enabled : bool
이 속성은 액션 그룹이 활성화되어 있는지 여부를 나타냅니다.
그룹 내의 각 액션은 명시적으로 비활성화되지 않은 한 활성화되거나 비활성화됩니다.
액세스 함수:
| bool | isEnabled() const |
| void | setEnabled(bool) |
QAction::setEnabled()도 참조하십시오 .
exclusionPolicy : QActionGroup::ExclusionPolicy
이 속성은 그룹 배타적 확인 정책을 적용합니다.
exclusionPolicy가 Exclusive로 설정된 경우, 해당 액션 그룹 내에서는 언제든지 하나의 확인 가능한 액션만 활성화될 수 있습니다. 사용자가 그룹 내의 다른 선택 가능한 항목을 선택하면, 선택한 항목이 활성 상태가 되고 이전에 활성 상태였던 항목은 비활성 상태가 됩니다. exclusionPolicy가 ExclusionOptional로 설정된 경우, 그룹은 배타적이지만 그룹 내의 활성 선택 가능한 항목의 선택을 해제할 수 있어 그룹에 선택된 항목이 하나도 없는 상태가 될 수 있습니다.
액세스 함수:
| 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(false)`를 호출하십시오. 그룹을 배타적으로 유지하되 활성 액션의 선택을 해제할 수 있도록 하려면 대신 ` 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)
text 와 icon 를 가진 액션을 생성하여 반환합니다. 새로 생성된 액션은 이 액션 그룹의 하위 액션이 됩니다.
일반적으로 액션은 해당 그룹을 상위 액션으로 지정하여 생성함으로써 그룹에 추가되므로, 이 함수는 보통 사용되지 않습니다.
QAction::setActionGroup()도 참조하십시오 .
QAction *QActionGroup::checkedAction() const
그룹에서 현재 선택된 액션을 반환하거나, 선택된 액션이 없는 경우 ` nullptr `를 반환합니다.
[signal] void QActionGroup::hovered(QAction *action)
이 신호는 액션 그룹 내의 지정된 action 가 사용자에 의해 강조 표시될 때 발생합니다. 예를 들어, 사용자가 메뉴 옵션이나 툴바 버튼 위에 커서를 올려놓고 잠시 머무르거나, 액션의 단축키 조합을 누를 때입니다.
QAction::activate()도 참조하십시오 .
bool QActionGroup::isExclusive() const
그룹이 배타적인 경우 true를 반환합니다.
ExclusionPolicy 의 값이 Exclusive이거나 ExclusionOptional인 경우, 해당 그룹은 배타적입니다.
void QActionGroup::removeAction(QAction *action)
이 그룹에서 ‘ action ’를 제거합니다. 이로 인해 해당 액션은 상위 액션이 없어집니다.
QAction::setActionGroup()도 참조하십시오 .
[slot] void QActionGroup::setDisabled(bool b)
이 함수는 ` enabled ` 속성을 위한 편의 함수로, 신호-슬롯 연결에 유용합니다. ` b `가 true인 경우 액션 그룹이 비활성화되고, 그렇지 않은 경우 활성화됩니다.
[slot] void QActionGroup::setExclusive(bool b)
그룹 제외 확인 기능 활성화 또는 비활성화
이 메서드는 b 가 true인 경우 setExclusionPolicy(ExclusionPolicy::Exclusive)를 호출하고, 그렇지 않은 경우 setExclusionPolicy(QActionGroup::ExclusionPolicy::None)를 호출하는 편의 메서드입니다.
isExclusive() 및 QActionGroup::exclusionPolicy도 참조하십시오 .
[signal] void QActionGroup::triggered(QAction *action)
이 신호는 액션 그룹 내의 지정된 action 이 사용자에 의해 활성화될 때 발생합니다. 예를 들어, 사용자가 메뉴 옵션이나 툴바 버튼을 클릭하거나, 액션의 단축키 조합을 누를 때 발생합니다.
명령 액션의 경우 이 신호에 연결하십시오.
QAction::activate()도 참조하십시오 .
© 2026 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.