Action QML Type

추상 사용자 인터페이스 동작. 더 보기...

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

속성

• checkable : bool
• checked : bool
• enabled : bool
• icon
  • icon.cache : bool
  • icon.color : color
  • icon.height : int
  • icon.name : string
  • icon.source : url
  • icon.width : int
• shortcut : keysequence
• text : string

신호

• toggled(QtObject source)
• triggered(QtObject source)

방법

• void toggle(QtObject source)
• void trigger(QtObject source)

상세 설명

Action은 단축키를 가질 수 있으며 메뉴 항목 및 툴바 버튼에 할당될 수 있는 추상적인 사용자 인터페이스 동작을 나타냅니다.

액션(Action)에는 키 입력( text), 키 입력 이벤트( icon), 키 입력 이벤트 대상( shortcut)이 포함될 수 있습니다. 액션은 일반적으로 메뉴 항목, 툴바 버튼 또는 키보드 단축키를 통해 사용자가 실행( triggered )합니다. 키 입력 이벤트가 있는 액션( checkable )은 트리거될 때 해당 이벤트 상태( checked )를 전환합니다.

Action {
    id: copyAction
    text: qsTr("&Copy")
    icon.name: "edit-copy"
    shortcut: StandardKey.Copy
    onTriggered: window.activeFocusItem.copy()
}

액션은 일반적으로 메뉴 항목, 도구 모음 버튼 및 키보드 단축키를 통해 호출할 수 있는 애플리케이션 명령을 구현하는 데 사용됩니다. 사용자는 사용하는 사용자 인터페이스에 관계없이 명령이 동일한 방식으로 실행되기를 기대하므로, 명령을 공유 가능한 액션으로 표현하는 것이 유용합니다.

액션은 논리와 시각적 표현을 분리하는 데에도 사용할 수 있습니다. 예를 들어, .ui.qml 파일에 버튼과 메뉴 항목을 선언할 때, 액션은 다른 곳에서 선언하여 외부에서 할당할 수 있습니다.

ToolButton {
    id: toolButton
    action: copyAction
}

액션이 버튼 및 메뉴 항목과 연결되면 enabled, checkable, checked 상태가 자동으로 동기화됩니다. 예를 들어, 워드 프로세서에서 사용자가 도구 모음의 “굵게(Bold)” 버튼을 클릭하면 “굵게(Bold)” 메뉴 항목이 자동으로 선택됩니다. 기본적으로 버튼과 메뉴 항목은 해당 액션에서 text 및 icon 값을 가져옵니다. 특정 컨트롤에 대해 액션별 text 또는 icon 값을 재정의하려면, 해당 컨트롤에 직접 text 또는 icon 를 지정하면 됩니다.

MenuItem {
    id: menuItem
    action: copyAction
    text: qsTr("&Copy selected Text")
}

Action은 사용자 인터페이스 동작을 나타내므로, MenuItem, ToolButton 또는 AbstractButton 를 상속하는 다른 컨트롤에 할당되도록 설계되었습니다. 키보드 단축키의 경우, 더 간단한 Shortcut 유형이 더 적합합니다.

MenuItem, ToolButton 및 Shortcut도 참조하십시오 .

속성 설명서

checkable : bool

이 속성은 해당 액션이 선택 가능한지 여부를 나타냅니다. 기본값은 ‘ false ’입니다.

선택 가능한 액션은 트리거될 때 선택됨(켜짐)과 선택 해제됨(꺼짐) 상태를 번갈아 가며 전환합니다.

checked도 참조하십시오 .

checked : bool

이 속성은 해당 항목이 선택되었는지 여부를 나타냅니다.

checkable도 참조하십시오 .

enabled : bool

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

icon group

shortcut : keysequence

이 속성은 액션의 단축키를 저장합니다. 키 시퀀스는 standard keyboard shortcuts 중 하나로 설정할 수 있으며(예: StandardKey.Copy), 또는 단축키를 실행하는 데 필요한 최대 4개의 키 입력 순서가 포함된 문자열로 정의할 수도 있습니다.

Action {
    shortcut: "Ctrl+E,Ctrl+W"
    onTriggered: edit.wrapMode = TextEdit.Wrap
}

text : string

이 속성에는 해당 작업에 대한 텍스트 설명이 포함됩니다.

Signal 문서

toggled(QtObject source)

이 신호는 액션이 토글될 때 발생합니다. ` source ` 인수는 액션을 토글한 객체를 식별합니다.

예를 들어, 액션이 메뉴 항목과 툴바 버튼에 할당된 경우, 컨트롤이 토글되거나 단축키가 활성화되거나 toggle()이 직접 호출될 때 액션이 토글됩니다.

triggered(QtObject source)

이 신호는 액션이 트리거될 때 발생합니다. ` source ` 인수는 액션을 트리거한 객체를 식별합니다.

예를 들어, 액션이 메뉴 항목과 툴바 버튼에 할당된 경우, 컨트롤을 클릭하거나 단축키를 실행하거나 trigger()을 직접 호출하면 액션이 트리거됩니다.

메서드 설명서

void toggle(QtObject source)

해당 동작을 켜거나 끕니다. 활성화된 경우, 선택적으로 정의된 ` source ` 객체를 사용하여 ` toggled()`를 호출합니다.

void trigger(QtObject source)

액션을 트리거하고, 활성화된 경우 triggered()를 호출하며, 선택적으로 정의된 source 객체를 전달합니다.