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)

상세 설명

액션은 바로 가기를 가질 수 있고 메뉴 항목 및 도구 모음 버튼에 할당할 수 있는 추상적인 사용자 인터페이스 액션을 나타냅니다.

액션에는 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 상태가 자동으로 동기화됩니다. 예를 들어 워드 프로세서에서 사용자가 '굵게' 도구 모음 버튼을 클릭하면 '굵게' 메뉴 항목이 자동으로 선택됩니다. 버튼과 메뉴 항목은 기본적으로 작업에서 text 및 icon 을 가져옵니다. 컨트롤에 직접 text 또는 icon 을 지정하여 특정 컨트롤에 대해 액션별 text 또는 icon 을 재정의할 수 있습니다.

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

액션은 사용자 인터페이스 액션을 제공하므로 MenuItem, ToolButton 또는 AbstractButton 을 상속하는 다른 컨트롤에 할당되도록 되어 있습니다. 키보드 단축키의 경우 더 간단한 Shortcut 유형이 더 적합합니다.

MenuItem, ToolButton, Shortcut 를참조하세요 .

속성 문서

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

신호 문서

메서드 문서