QAction Class

속성 문서

autoRepeat : bool

이 속성은 동작이 자동 반복될 수 있는지 여부를 보유합니다.

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

액세스 기능:

알림 신호:

checkable : bool

이 속성은 액션이 체크 가능한 액션인지 여부를 보유합니다.

체크 가능한 동작은 켜짐/꺼짐 상태가 있는 동작입니다. 예를 들어 워드 프로세서에서 볼드 도구 모음 버튼은 켜져 있거나 꺼져 있을 수 있습니다. 토글 동작이 아닌 동작은 명령 동작이며, 명령 동작은 파일 저장과 같이 단순히 실행되는 동작입니다. 기본적으로 이 속성은 false 입니다.

어떤 상황에서는 한 토글 동작의 상태가 다른 토글 동작의 상태에 따라 달라져야 합니다. 예를 들어 '왼쪽 정렬', '가운데 정렬' 및 '오른쪽 정렬' 토글 동작은 상호 배타적입니다. 배타적 토글을 달성하려면 관련 토글 액션을 QActionGroup::exclusive 속성을 true로 설정한 QActionGroup 에 추가합니다.

함수에 액세스합니다:

알림 신호:

setChecked()도 참조하세요 .

checked : bool

이 속성은 작업의 확인 여부를 보유합니다.

체크 가능한 작업만 체크할 수 있습니다. 기본적으로 이 속성은 거짓입니다(동작이 선택되지 않음).

함수 액세스

알림 신호:

checkable 및 toggled()도 참조하세요 .

enabled : bool

이 속성은 작업의 활성화 여부를 보유합니다.

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

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

동작이 추가된 모든 위젯( QWidget::addAction() 포함)이 비활성화되거나 표시되지 않으면 동작이 비활성화됩니다. 동작이 비활성화되면 해당 바로가기를 통해 동작을 트리거할 수 없습니다.

기본적으로 이 속성은 true (동작이 활성화됨)입니다.

기능에 액세스합니다:

알림 신호:

text 를참조하세요 .

font : QFont

이 속성은 액션의 글꼴을 보유합니다.

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

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

기능에 액세스합니다:

알림 신호:

setText()도 참조하세요 .

icon : QIcon

이 속성은 작업의 아이콘을 보유합니다.

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

기본 아이콘은 없습니다.

이 함수에 널 아이콘(QIcon::isNull())이 전달되면 작업의 아이콘이 지워집니다.

함수에 접근합니다:

알림 신호:

iconText : QString

이 속성에는 작업의 설명 아이콘 텍스트가 저장됩니다.

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

또한 setText() 또는 setToolTip()로 동작이 정의되지 않은 경우 메뉴 및 도구 설명의 기본 텍스트로 사용되며, setIcon()로 아이콘이 정의되지 않은 경우 도구 모음 버튼에도 사용됩니다.

아이콘 텍스트가 명시적으로 설정되어 있지 않으면 작업의 일반 텍스트가 아이콘 텍스트에 사용됩니다.

기본적으로 이 속성에는 빈 문자열이 포함됩니다.

함수 액세스

알림 신호:

setToolTip() 및 setStatusTip()도 참조하세요 .

iconVisibleInMenu : bool

이 속성은 동작이 메뉴에 아이콘을 표시할지 여부를 나타냅니다.

일부 애플리케이션에서는 도구 모음에는 아이콘이 있는 동작이 있지만 메뉴에는 없는 것이 합리적일 수 있습니다. 참이면 메뉴에 아이콘(유효한 경우)이 표시되고, 거짓이면 아이콘이 표시되지 않습니다.

기본값은 애플리케이션에 대해 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.

액세스 기능:

알림 신호:

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

이 속성은 동작이 컨텍스트 메뉴에 바로 가기를 표시할지 여부를 보유합니다.

일부 애플리케이션에서는 컨텍스트 메뉴에 바로가기가 있는 액션을 표시하는 것이 합리적일 수 있습니다. 참이면 동작이 컨텍스트 메뉴를 통해 표시될 때 바로 가기(유효한 경우)가 표시되고, 거짓이면 바로 가기가 표시되지 않습니다.

기본값은 애플리케이션에 대해 Qt::AA_DontShowShortcutsInContextMenus 속성이 설정되어 있는지 여부를 따르는 것입니다. 이 속성을 명시적으로 설정하면 이 속성이 재정의됩니다.

액세스 기능:

알림 신호:

shortcut 및 QCoreApplication::setAttribute()도 참조하세요 .

statusTip : QString

이 속성에는 작업의 상태 팁이 저장됩니다.

상태 팁은 작업의 최상위 상위 위젯에서 제공하는 모든 상태 표시줄에 표시됩니다.

기본적으로 이 속성에는 빈 문자열이 포함됩니다.

함수에 액세스합니다:

알림 신호:

setToolTip() 및 showStatusText()도 참조하세요 .

text : QString

이 속성에는 작업의 설명 텍스트가 들어 있습니다.

동작이 메뉴에 추가되면 메뉴 옵션은 아이콘(있는 경우), 텍스트 및 바로 가기(있는 경우)로 구성됩니다. 생성자에서 텍스트를 명시적으로 설정하지 않거나 setText()를 사용하여 설정하지 않으면 작업의 설명 아이콘 텍스트가 텍스트로 사용됩니다. 기본 텍스트는 없습니다.

메뉴나 버튼과 같은 특정 UI 요소는 문자 앞에 '&'를 사용하여 해당 문자에 대한 니모닉(바로 가기)을 자동으로 만들 수 있습니다. 예를 들어 메뉴의 '&파일'은 파일 메뉴를 여는 바로 가기 Alt+F 를 만듭니다. "E&xit"은 버튼에 대한 바로 가기 Alt+X 를 만들거나 메뉴에서 "x"를 눌러 메뉴 항목으로 이동할 수 있도록 합니다. (실제 앰퍼샌드를 표시하려면 '&&'를 사용하세요). 위젯은 지정된 바로가기를 사용하여 작업을 수행할 수 있습니다.

기능에 액세스합니다:

알림 신호:

iconText 를참조하세요 .

toolTip : QString

이 속성에는 작업의 도구 설명이 저장됩니다.

이 텍스트가 도구 설명에 사용됩니다. 툴팁을 지정하지 않으면 작업의 텍스트가 사용됩니다.

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

기능에 액세스합니다:

알림 신호:

setStatusTip() 및 setShortcut()도 참조하세요 .

visible : bool

이 속성은 메뉴 및 도구 모음에서 작업을 볼 수 있는지 여부를 나타냅니다(예: 메뉴 및 도구 모음).

표시됨이 참이면 사용자가 메뉴 및 도구 모음에서 작업을 보고 선택할 수 있으며, 표시되지 않음은 거짓이면 사용자가 작업을 보거나 선택할 수 없습니다.

표시되지 않는 작업은 회색으로 표시되지 않으며 전혀 표시되지 않습니다.

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

기능에 액세스합니다:

알림 신호:

whatsThis : QString

이 속성에는 작업의 "이게 뭐죠?" 도움말 텍스트가 포함됩니다.

"이게 뭐죠?" 텍스트는 작업에 대한 간략한 설명을 제공하는 데 사용됩니다. 텍스트에는 서식 있는 텍스트가 포함될 수 있습니다. 기본 "이게 뭐야?" 텍스트는 없습니다.

기능에 접근합니다:

알림 신호:

QWhatsThis 를참조하세요 .