QAction Class

プロパティの説明

autoRepeat : bool

このプロパティは、アクションが自動的に繰り返されるかどうかを保持します。

trueの場合、キーボードのオートリピートがシステムで有効になっていれば、キーボードショートカットの組み合わせが押し下げられたときに、アクションは自動的に繰り返されます。デフォルト値はtrueです。

アクセス関数：

通知シグナル

checkable : bool

このプロパティは、アクションがチェック可能なアクションであるかどうかを保持する。

チェック可能なアクションとは、オン/オフの状態を持つものです。例えば、ワードプロセッサでは、ボールドツールバーボタンはオンかオフのどちらかになります。トグルアクションでないアクションは、コマンドアクションです。コマンドアクションは、例えばファイル保存のように、単に実行されます。デフォルトでは、このプロパティはfalse です。

状況によっては、1つのトグルアクションの状態は、他のアクションの状態に依存する必要があります。例えば、"Left Align"、"Center"、"Right Align "のトグルアクションは互いに排他的です。排他的なトグルを実現するには、QActionGroup::exclusiveプロパティをtrueに設定して、関連するトグルアクションをQActionGroup 。

アクセス関数

通知シグナル：

setChecked()も参照してください 。

checked : bool

このプロパティは、アクションがチェックされるかどうかを保持する。

チェック可能なアクションのみがチェックされます。デフォルトでは、これはfalseです（アクションはチェックされていません）。

アクセス関数：

ノーティファイア・シグナル：

checkable およびtoggled()も参照のこと 。

enabled : bool

このプロパティは、アクションが有効かどうかを保持します。

無効にされたアクションは、ユーザーが選択することはできません。メニューやツールバーから消えるわけではないが、利用できないことを示す方法で表示される。例えば、灰色で表示されます。

What's This? 無効にされたアクションのヘルプは、 プロパティが設定されていれば、まだ利用可能です。QAction::whatsThis

アクションは、(QWidget::addAction()で)追加されたすべてのウィジェットが無効化されるか、表示されなくなると無効になります。アクションが無効になると、そのショートカットからアクションをトリガすることができなくなります。

デフォルトでは、このプロパティはtrue （アクションは有効）です。

アクセス関数：

Notifier シグナル：

textも参照してください 。

font : QFont

このプロパティはアクションのフォントを保持する。

フォント・プロパティは、QAction に設定されたテキストをレンダリングするために使用されます。アプリケーションとスタイルに基づいてすべてのケースで参照されるわけではないので、フォントはヒントと考えることができます。

デフォルトでは、このプロパティはアプリケーションのデフォルトフォントを含みます。

アクセス関数：

通知シグナル：

setText()も参照 。

icon : QIcon

このプロパティはアクションのアイコンを保持します。

ツールバーでは、アイコンはツールボタンアイコンとして使用されます。メニューでは、QAction::iconVisibleInMenu がtrue を返す限り、メニューテキストの左に表示されます。

デフォルトのアイコンはありません。

null アイコン (QIcon::isNull()) がこの関数に渡された場合、アクションのアイコンはクリアされます。

アクセス関数：

通知シグナル：

iconText : QString

このプロパティは、アクションの説明アイコンテキストを保持する。

QToolBar::toolButtonStyle 、テキスト表示を許可する値に設定されている場合、このプロパティで定義されたテキストは、関連するツールボタンのラベルとして表示されます。

また、setText （）またはsetToolTip （）でアクションが定義されていない場合は、メニューやツールチップのデフォルトテキストとして機能し、setIcon （）を使用してアイコンが定義されていない場合は、ツールバーボタンでも使用されます。

アイコンテキストが明示的に設定されていない場合、アクションの通常のテキストがアイコンテキストとして使用されます。

デフォルトでは、このプロパティには空の文字列が含まれます。

アクセス関数：

Notifier シグナル：

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.

アクセス関数：

通知シグナル：

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 属性が設定されているかどうかに従います。このプロパティを明示的に設定すると、属性が上書きされます。

アクセス関数

Notifier シグナル：

shortcut およびQCoreApplication::setAttribute()も参照のこと 。

statusTip : QString

このプロパティは、アクションのステータスチップを保持します。

ステータスチップは、アクションのトップレベルの親ウィジェットによって提供されるすべてのステータスバーに表示されます。

デフォルトでは、このプロパティは空の文字列を含みます。

アクセス関数

Notifier シグナル：

setToolTip() およびshowStatusText()も参照してください 。

text : QString

このプロパティは、アクションの説明テキストを保持します。

アクションがメニューに追加された場合、メニューオプションはアイコン (もしあれば)、テキスト、ショートカット (もしあれば) から構成されます。コンストラクタや setText() でテキストが明示的に設定されていない場合は、 アクションの説明アイコンテキストがテキストとして使用されます。デフォルトのテキストはありません。

メニューやボタンなどの特定の UI 要素では、文字の前に '&' を置くことで、その文字のニーモニック (ショートカット) を自動的に作成することができます。例えば、メニューに"&File "を使用すると、Alt+F というショートカットが作成され、Fileメニューが開きます。「E&exit」はボタンのショートカットAlt+X 、メニューでは「x」を押してメニュー項目に移動できるようにします。(実際のアンパサンドを表示するには'&&'を使用)。ウィジェットは、与えられたショートカットを消費し、アクションを実行するかもしれません。

アクセス関数

通知シグナル：

iconTextも参照してください 。

toolTip : QString

このプロパティは、アクションのツールチップを保持します。

このテキストはツールチップに使用されます。ツールチップが指定されていない場合、アクションのテキストが使用されます。

デフォルトでは、このプロパティはアクションのテキストを含みます。

アクセス関数

Notifier シグナル：

setStatusTip() およびsetShortcut()も参照 。

visible : bool

このプロパティは、アクションが（メニューやツールバーなどで）見ることができるかどうかを保持します。

visibleがtrueの場合、アクションは（メニューやツールバーなどで）見ることができ、ユーザーが選択することができます。visibleがfalseの場合、アクションは見ることができず、ユーザーが選択することもできません。

visibleがfalseの場合、ユーザーはアクションを見ることも選択することもできません。visibleでないアクションはグレーアウトされず、まったく表示されません。

デフォルトでは、このプロパティはtrue （アクションは可視）です。

アクセス関数

通知シグナル：

whatsThis : QString

このプロパティは、アクションの "What's This? "ヘルプテキストを保持します。

What's This? "テキストは、アクションの簡単な説明を提供するために使用されます。テキストはリッチテキストを含むことができる。デフォルトの "What's This? "テキストはありません。

アクセス関数

通知シグナル：

QWhatsThisも参照 。