QAction Class

プロパティのドキュメント

autoRepeat : bool

このプロパティは、アクションを自動繰り返しできるかどうかを指定します

true の場合、システムでキーボードの自動繰り返し機能が有効になっている限り、キーボードショートカットの組み合わせを押し続けている間、アクションが自動的に繰り返されます。デフォルト値は true です。

アクセス関数：

通知シグナル：

checkable : bool

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

トグルアクションとは、オン／オフの状態を持つアクションのことです。たとえば、ワードプロセッサでは、ツールバーの「太字」ボタンがオンまたはオフのいずれかの状態になります。トグルアクションではないアクションはコマンドアクションであり、コマンドアクションは単に実行されるだけです（例：ファイルの保存）。デフォルトでは、このプロパティはfalse に設定されています。

状況によっては、あるトグルアクションの状態が他のトグルアクションの状態に依存する場合があります。 たとえば、「左揃え」、「中央揃え」、「右揃え」のトグルアクションは相互に排他的です。排他的なトグルを実現するには、関連するトグルアクションをQActionGroup に追加し、QActionGroup::exclusiveプロパティをtrueに設定します。

アクセス関数：

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()` を使用してアイコンが定義されていない場合は、ツールバーのボタンでも使用されます。

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

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

アクセス関数:

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.

アクセス関数：

Notifierシグナル：

関連項目: ` icon ` および `QCoreApplication::setAttribute()`。

menuRole : MenuRole

このプロパティは、アクションのメニューロールを保持します

これは、macOSのアプリケーションメニューにおいて、そのアクションがどのような役割を果たすかを示します。デフォルトでは、すべてのアクションに「TextHeuristicRole 」が割り当てられており、これはアクションがそのテキストに基づいてメニューに追加されることを意味します（詳細については、QMenuBar を参照してください）。

メニューロールは、macOSでアクションがメニューバーに配置される前（通常は最初のアプリケーションウィンドウが表示される直前）にのみ変更可能です。

アクセス関数:

Notifierシグナル：

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」キーを押すことでそのメニュー項目に移動できるようになります（実際のアンパサンドを表示するには「&&」を使用してください）。ウィジェットは、指定されたショートカットを受け取り、それに基づいてアクションを実行する場合があります。

アクセス関数：

Notifierシグナル:

iconTextも参照してください 。

toolTip : QString

このプロパティには、アクションのツールチップが格納されます

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

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

アクセス関数：

通知シグナル：

setStatusTip() およびsetShortcut()も参照してください 。

visible : bool

このプロパティは、そのアクションが表示可能かどうか（例：メニューやツールバー内）を示します。

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

表示されないアクションはグレーアウトされることはなく、まったく表示されません。

デフォルトでは、このプロパティは `true `（アクションが表示される）に設定されています。

アクセス関数：

Notifierシグナル：

whatsThis : QString

このプロパティには、アクションの「これは何？」ヘルプテキストが格納されます

「これは何？」テキストは、アクションの簡単な説明を提供するために使用されます。このテキストにはリッチテキストを含めることができます。デフォルトの「これは何？」テキストは存在しません。

アクセス関数:

通知シグナル：

関連項目： QWhatsThis 。