QAction Class

속성 설명서

autoRepeat : bool

이 속성은 해당 동작이 자동 반복될 수 있는지 여부를 나타냅니다.

true인 경우, 시스템에서 키보드 자동 반복 기능이 활성화되어 있다면 키보드 단축키 조합을 길게 누르고 있을 때 해당 작업이 자동으로 반복됩니다. 기본값은 true입니다.

액세스 함수:

알림 신호:

checkable : bool

이 속성은 해당 동작이 토글 동작인지 여부를 나타냅니다.

토글 가능한 액션이란 켜짐/꺼짐 상태를 갖는 액션을 말합니다. 예를 들어, 워드 프로세서에서 굵게(Bold) 도구 모음 버튼은 켜져 있거나 꺼져 있을 수 있습니다. 토글 액션이 아닌 액션은 명령 액션이며, 명령 액션은 단순히 실행되는 액션입니다(예: 파일 저장). 기본적으로 이 속성의 값은 ' false'입니다.

어떤 상황에서는 한 토글 동작의 상태가 다른 토글 동작의 상태에 따라 달라져야 합니다. 예를 들어, “왼쪽 정렬”, “중앙 정렬” 및 “오른쪽 정렬” 토글 액션은 서로 배타적입니다. 배타적인 토글 기능을 구현하려면, QActionGroup::exclusive 속성을 true로 설정한 QActionGroup 에 관련 토글 액션을 추가하십시오.

액세스 함수:

Notifier 신호:

setChecked()도 참조하십시오 .

checked : bool

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

선택 가능한 액션만 선택 상태로 설정할 수 있습니다. 기본적으로 이 값은 false이며(액션은 선택 해제 상태입니다).

액세스 함수:

알림 신호:

checkable 및 toggled()도 참조하십시오 .

enabled : bool

이 속성은 해당 동작이 활성화되어 있는지 여부를 나타냅니다.

사용자는 비활성화된 작업을 선택할 수 없습니다. 이러한 작업은 메뉴나 도구 모음에서 사라지지는 않지만, 사용할 수 없음을 나타내는 방식으로 표시됩니다. 예를 들어, 회색 음영만 사용하여 표시될 수 있습니다.

What's This? QAction::whatsThis 속성이 설정되어 있는 경우, 비활성화된 작업에 대한 도움말은 여전히 사용할 수 있습니다.

QWidget::addAction()을 통해 추가된 모든 위젯이 비활성화되었거나 보이지 않을 경우, 해당 동작은 비활성화됩니다. 동작이 비활성화된 상태에서는 단축키를 통해 해당 동작을 실행할 수 없습니다.

기본적으로 이 속성은 true (액션이 활성화된 상태)입니다.

액세스 함수:

Notifier 신호:

text도 참조하십시오 .

font : QFont

이 속성은 액션의 글꼴을 지정합니다.

font 속성은 QAction 에 설정된 텍스트를 렌더링하는 데 사용됩니다. 이 폰트는 애플리케이션과 스타일에 따라 모든 경우에 참조되지는 않으므로 일종의 참고 정보로 간주할 수 있습니다.

기본적으로 이 속성에는 애플리케이션의 기본 글꼴이 포함됩니다.

액세스 함수:

알림 신호:

setText()도 참조하십시오 .

icon : QIcon

이 속성은 액션의 아이콘을 저장합니다.

도구 모음에서는 이 아이콘이 도구 버튼 아이콘으로 사용되며, 메뉴에서는 ` QAction::iconVisibleInMenu `가 ` true`를 반환하는 경우에만 메뉴 텍스트의 왼쪽에 표시됩니다.

기본 아이콘은 없습니다.

이 함수에 null 아이콘(QIcon::isNull())이 전달되면, 액션의 아이콘이 지워집니다.

액세스 함수:

Notifier 신호:

iconText : QString

이 속성은 액션에 대한 설명성 아이콘 텍스트를 저장합니다.

QToolBar::toolButtonStyle 가 텍스트 표시를 허용하는 값으로 설정된 경우, 이 속성에 정의된 텍스트가 관련 도구 버튼에 레이블로 표시됩니다.

또한, ` setText()` 또는 ` setToolTip()`로 액션이 정의되지 않은 경우 메뉴 및 툴팁의 기본 텍스트로 사용되며, ` setIcon()`를 사용하여 아이콘이 정의되지 않은 경우 툴바 버튼에서도 사용됩니다.

아이콘 텍스트가 명시적으로 설정되지 않은 경우, 해당 액션의 일반 텍스트가 아이콘 텍스트로 사용됩니다.

기본적으로 이 속성은 빈 문자열을 포함합니다.

액세스 함수:

알림 신호:

setToolTip() 및 setStatusTip()도 참조하십시오 .

iconVisibleInMenu : bool

이 속성은 특정 작업이 메뉴에 아이콘을 표시해야 하는지 여부를 결정합니다.

일부 애플리케이션에서는 툴바에는 아이콘이 있는 액션을 표시하되, 메뉴에는 표시하지 않는 것이 적합할 수 있습니다. 이 속성이 true인 경우, 유효한 아이콘이 메뉴에 표시되며, false인 경우 표시되지 않습니다.

기본값은 애플리케이션에 ‘ Qt::AA_DontShowIconsInMenus ’ 속성이 설정되어 있는지 여부에 따릅니다. 이 속성을 명시적으로 설정하면 해당 속성의 유무와 관계없이 이 속성의 설정이 우선 적용됩니다.

예:

QApplication app(argc, argv);
app.setAttribute(Qt::AA_DontShowIconsInMenus);  // Icons are *no longer shown* in menus
// ...
QAction *myAction = new QAction();
// ...
myAction->setIcon(SomeIcon);
myAction->setIconVisibleInMenu(true);   // Icon *will* be shown in menus for *this* action.

액세스 함수:

Notifier 신호:

icon 및 QCoreApplication::setAttribute()도 참조하십시오 .

menuRole : MenuRole

이 속성은 액션의 메뉴 역할을 나타냅니다.

이는 macOS의 애플리케이션 메뉴에서 해당 액션이 어떤 역할을 수행하는지 나타냅니다. 기본적으로 모든 액션은 ' TextHeuristicRole'을 가지며, 이는 액션이 텍스트를 기반으로 메뉴에 추가됨을 의미합니다(자세한 내용은 QMenuBar 참조).

메뉴 역할은 macOS에서 액션이 메뉴 막대에 추가되기 전(일반적으로 첫 번째 애플리케이션 창이 표시되기 직전)에만 변경할 수 있습니다.

액세스 함수:

알림 신호:

priority : Priority

이 속성은 사용자 인터페이스에서 해당 작업의 우선순위를 지정합니다.

이 속성을 설정하여 사용자 인터페이스에서 해당 동작의 우선 순위를 지정할 수 있습니다.

예를 들어, 툴바에 ' Qt::ToolButtonTextBesideIcon ' 모드가 설정된 경우, ' LowPriority '가 설정된 액션에는 텍스트 레이블이 표시되지 않습니다.

액세스 함수:

알림 신호:

shortcut : QKeySequence

이 속성은 액션의 기본 단축키를 저장합니다.

이 속성에 사용할 수 있는 유효한 키코드는 Qt::Key 및 Qt::Modifier 에서 확인할 수 있습니다. 기본 단축키는 없습니다.

액세스 함수:

알림 신호:

shortcutContext : Qt::ShortcutContext

이 속성은 액션의 바로 가기에 대한 컨텍스트를 저장합니다.

이 속성의 유효한 값은 Qt::ShortcutContext 에서 확인할 수 있습니다. 기본값은 Qt::WindowShortcut 입니다.

액세스 함수:

알림 신호:

shortcutVisibleInContextMenu : bool

이 속성은 작업에 대해 컨텍스트 메뉴에 바로 가기 키를 표시할지 여부를 결정합니다.

일부 응용 프로그램에서는 컨텍스트 메뉴에 단축키가 포함된 작업을 표시하는 것이 합리적일 수 있습니다. 이 속성이 true인 경우, 해당 작업이 컨텍스트 메뉴를 통해 표시될 때 (유효한) 단축키가 표시되며, false인 경우에는 표시되지 않습니다.

기본값은 애플리케이션에 ‘ Qt::AA_DontShowShortcutsInContextMenus ’ 속성이 설정되어 있는지 여부에 따릅니다. 이 속성을 명시적으로 설정하면 해당 속성이 무시됩니다.

액세스 함수:

알림 신호:

shortcut 및 QCoreApplication::setAttribute()도 참조하십시오 .

statusTip : QString

이 속성은 액션의 상태 툴팁을 저장합니다

상태 팁은 액션의 최상위 부모 위젯이 제공하는 모든 상태 표시줄에 표시됩니다.

기본적으로 이 속성은 빈 문자열을 포함합니다.

액세스 함수:

Notifier 시그널:

setToolTip() 및 showStatusText()도 참조하십시오 .

text : QString

이 속성은 액션에 대한 설명 텍스트를 저장합니다.

액션이 메뉴에 추가되면, 메뉴 옵션은 아이콘(있는 경우), 텍스트, 단축키(있는 경우)로 구성됩니다. 생성자나 setText()를 통해 텍스트가 명시적으로 설정되지 않은 경우, 액션의 설명 텍스트가 텍스트로 사용됩니다. 기본 텍스트는 없습니다.

메뉴나 버튼과 같은 특정 UI 요소에서는 문자 앞에 '&'를 붙여 해당 문자에 대한 니모닉(단축키)을 자동으로 생성할 수 있습니다. 예를 들어, 메뉴에 "&File"을 지정하면 Alt+F 단축키가 생성되어 파일 메뉴가 열립니다. "E&xit"은 버튼의 경우 Alt+X 단축키를 생성하거나, 메뉴에서는 "x"를 눌러 해당 메뉴 항목으로 이동할 수 있게 합니다. (실제 앰퍼샌드를 표시하려면 '&&'를 사용하십시오). 위젯은 주어진 단축키를 받아 해당 동작을 수행할 수 있습니다.

액세스 함수:

알림 신호:

iconText도 참조하십시오 .

toolTip : QString

이 속성은 액션의 툴팁을 저장합니다.

이 텍스트는 툴팁으로 사용됩니다. 툴팁이 지정되지 않은 경우, 작업의 텍스트가 사용됩니다.

기본적으로 이 속성에는 액션의 텍스트가 포함됩니다.

액세스 함수:

알림 신호:

setStatusTip() 및 setShortcut()도 참조하십시오 .

visible : bool

이 속성은 해당 동작이 (예: 메뉴나 툴바에서) 표시될 수 있는지 여부를 나타냅니다.

visible가 true인 경우, 해당 작업은 (예: 메뉴 및 툴바에서) 표시되며 사용자가 선택할 수 있습니다. visible이 false인 경우, 해당 작업은 표시되지 않으며 사용자가 선택할 수 없습니다.

표시되지 않는 액션은 회색으로 표시 되지 않으며, 아예 나타나지 않습니다.

기본적으로 이 속성은 ‘ true ’입니다(작업이 표시됨).

액세스 함수:

Notifier 신호:

whatsThis : QString

이 속성은 액션의 “이게 뭐죠?” 도움말 텍스트를 저장합니다.

"이 기능에 대해" 텍스트는 해당 작업에 대한 간략한 설명을 제공하는 데 사용됩니다. 이 텍스트에는 서식 있는 텍스트를 포함할 수 있습니다. 기본 "이 기능에 대해" 텍스트는 없습니다.

액세스 함수:

알림 신호:

QWhatsThis도 참조하십시오 .