ActionGroup QML Type

그룹의 동작을 한데 묶습니다. 더 보기...

• 상속된 멤버를 포함한 모든 멤버 목록

속성

• actions : list<Action>
• checkedAction : Action
• enabled : bool
• exclusive : bool

연관 속성

• group : ActionGroup

신호

• triggered(Action action)

방법

• void addAction(Action action)
• void removeAction(Action action)

상세 설명

ActionGroup은 비시각적인 액션 그룹입니다. 상호 배타적( exclusive )인 액션 그룹은 한 번에 하나의 옵션만 선택할 수 있는 액션에 사용됩니다.

ActionGroup을 사용하는 가장 간단한 방법은 액션을 그룹의 자식 요소로 선언하는 것입니다.

ActionGroup {
    id: alignmentGroup

    Action {
        checked: true
        checkable: true
        text: qsTr("Left")
    }

    Action {
        checkable: true
        text: qsTr("Center")
    }

    Action {
        checkable: true
        text: qsTr("Right")
    }
}

또는 group 부착 속성을 사용하여 다른 곳에서 액션을 선언한 후 특정 그룹에 할당할 수도 있습니다.

ActionGroup { id: alignmentGroup }

Action {
    checked: true
    checkable: true
    text: qsTr("Left")
    ActionGroup.group: alignmentGroup
}

Action {
    checkable: true
    text: qsTr("Center")
    ActionGroup.group: alignmentGroup
}

Action {
    checkable: true
    text: qsTr("Right")
    ActionGroup.group: alignmentGroup
}

addAction() 및 removeAction() 메서드를 사용하면 더 복잡한 사용 사례를 처리할 수 있습니다.

Action 및 ButtonGroup도 참조하십시오 .

속성 문서

actions : list<Action> [default]

이 속성은 그룹에 포함된 작업 목록을 저장합니다.

group도 참조하십시오 .

checkedAction : Action

이 속성은 배타적 그룹에 현재 선택된 동작을 저장하며, 해당 그룹이 없거나 비배타적 그룹인 경우에는 ‘ null ’를 저장합니다.

기본적으로, 이 속성은 배타적 작업 그룹에 추가된 첫 번째 선택된 작업입니다.

‘ exclusive’ 항목도 참조하십시오 .

enabled : bool

이 속성은 작업 그룹이 활성화되어 있는지 여부를 나타냅니다. 기본값은 ‘ true ’입니다.

이 속성이 ` false`인 경우, 그룹 내의 모든 액션이 비활성화됩니다. 이 속성이 ` true`인 경우, 명시적으로 비활성화되지 않은 한 그룹 내의 모든 액션이 활성화됩니다.

exclusive : bool

이 속성은 액션 그룹이 배타적인지 여부를 나타냅니다. 기본값은 ‘ true ’입니다.

이 속성이 ' true'인 경우, 그룹 내에서는 한 번에 하나의 액션만 선택된 상태로 유지될 수 있습니다. 사용자는 아무 액션이나 실행하여 선택할 수 있으며, 해당 액션이 그룹 내에서 기존에 선택된 액션을 대체하게 됩니다.

배타적 그룹에서는 사용자가 현재 선택된 액션을 실행하여 선택을 해제할 수 없으며, 대신 그룹 내의 다른 액션을 실행하여 해당 그룹의 새로운 선택된 액션을 설정해야 합니다.

비배타적 그룹에서는 액션을 선택하거나 선택을 해제해도 그룹 내의 다른 액션에는 영향을 미치지 않습니다. 또한, ` checkedAction ` 속성의 값은 ` null`입니다.

부속 속성 설명서

ActionGroup.group : ActionGroup [attached]

이 속성은 액션 그룹에 액션을 연결합니다.

ActionGroup { id: group }

Action {
    checked: true
    text: qsTr("Option A")
    ActionGroup.group: group
}

Action {
    text: qsTr("Option B")
    ActionGroup.group: group
}

actions도 참조하십시오 .

Signal 문서

triggered(Action action)

이 신호는 그룹 내의 특정 작업( action )이 실행되었을 때 발생합니다.

이 신호는 동일한 그룹에 속한 모든 액션에 대해 공통된 신호 핸들러를 구현하는 데 유용합니다.

ActionGroup {
    onTriggered: console.log("triggered:", action.text)

    Action { text: "First" }
    Action { text: "Second" }
    Action { text: "Third" }
}

Action::triggered()도 참조하십시오 .

메서드 문서

void addAction(Action action)

액션 그룹에 ‘ action ’를 추가합니다.

actions 및 group항목도 참조하십시오 .

void removeAction(Action action)

액션 그룹에서 ‘ action ’을 제거합니다.

actions 및 group도 참조하십시오 .