QAction Class

プロパティ Documentation

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 （アクションは有効）です。

アクセス関数：

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

textも参照してください 。

font : QFont

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

フォントプロパティは、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.

アクセス関数：

通知シグナル：

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も参照 。