ACCELERATORS リソース

[アーティクル]
06/13/2023

アプリケーションの 1 つ以上のアクセラレータを定義します。アクセラレータは、ユーザーがタスクを迅速に実行する方法を提供するためにアプリケーションによって定義されるキーストロークです。

acctablename ACCELERATORS [optional-statements] {event, idvalue, [type] [options]... }

パラメーター

acctablename

リソースを識別する一意の名前または 16 ビット符号なし整数値。

optional-statements

次のステートメントの 0 個以上。

ステートメント	説明
CHARACTERISTICSdword	リソースファイルの読み取りと書き込みを行うツールで使用できるリソースに関するユーザー定義情報。詳細については、「 CHARACTERISTICS」を参照してください。
LANGUAGE言語、サブ言語	リソースの言語を指定します。詳細については、「 LANGUAGE」を参照してください。
VERSIONdword	リソースファイルの読み取りと書き込みを行うツールで使用できるリソースのユーザー定義バージョン番号。詳細については、「 VERSION」を参照してください。

イベント

アクセラレータとして使用するキーストローク。次のいずれかの文字型を指定できます。

型	Description
"char"	二重引用符 (") で囲まれた 1 文字。文字の前にキャレット (^) を付けることができます。つまり、文字は制御文字です。
文字	文字を表す整数値。型パラメーターは ASCII である必要があります。
virtual-key 文字	仮想キーを表す整数値。英数字キーの仮想キーは、大文字または数字を二重引用符 ("9" や "C" など) で指定することで指定できます。型パラメーターは VIRTKEY である必要があります。

idvalue

アクセラレータを識別する 16 ビット符号なし整数値。

型

イベント パラメーターが文字または仮想キー文字の場合にのみ必要です。型パラメーターは、ASCII または VIRTKEY を指定します。イベントの整数値は、それに応じて解釈されます。 VIRTKEY を指定し、event に文字列が含まれている場合、イベントは大文字である必要があります。

オプション

アクセラレータを定義するオプション。このパラメーターには、次の 1 つ以上の値を指定できます。

オプション	説明
NOINVERT	アクセラレータの使用時に最上位のメニュー項目が強調表示されていないことを指定します。これは、メニュー項目に対応しないスクロールなどのアクションのアクセラレータを定義する場合に便利です。 NOINVERT を省略すると、アクセラレータの使用時に最上位メニュー項目が強調表示されます (可能な場合)。この属性は古く、16 ビット Windows 用に設計されたリソースファイルとの下位互換性のためにのみ保持されています。
Alt	ALT キーがダウンしている場合にのみアクセラレータをアクティブにします。仮想キーにのみ適用されます。
シフト	SHIFT キーがダウンしている場合にのみアクセラレータをアクティブにします。仮想キーにのみ適用されます
コントロール	文字を制御文字として定義します (アクセラレータは、CONTROL キーがダウンしている場合にのみアクティブになります)。これは、イベントパラメーターでアクセラレータ文字の前にキャレット (^) を使用する場合と同じ効果があります。仮想キーにのみ適用されます

一部の属性は、下位互換性のためにもサポートされています。詳細については、「共通リソース属性」を参照してください。

解説

TranslateAccelerator 関数は、アクセラレータメッセージをアプリケーションキューから WM_COMMAND または WM_SYSCOMMAND メッセージに変換するために使用されます。

例

次の例では、アクセラレータキーの使用を示します。

1 ACCELERATORS
{
  "^C",  IDDCLEAR         ; control C
  "K",   IDDCLEAR         ; shift K
  "k",   IDDELLIPSE, ALT  ; alt k
  98,    IDDRECT, ASCII   ; b
  66,    IDDSTAR, ASCII   ; B (shift b)
  "g",   IDDRECT          ; g
  "G",   IDDSTAR          ; G (shift G)
  VK_F1, IDDCLEAR, VIRTKEY                ; F1
  VK_F1, IDDSTAR, CONTROL, VIRTKEY        ; control F1
  VK_F1, IDDELLIPSE, SHIFT, VIRTKEY       ; shift F1
  VK_F1, IDDRECT, ALT, VIRTKEY            ; alt F1
  VK_F2, IDDCLEAR, ALT, SHIFT, VIRTKEY    ; alt shift F2
  VK_F2, IDDSTAR, CONTROL, SHIFT, VIRTKEY ; ctrl shift F2
  VK_F2, IDDRECT, ALT, CONTROL, VIRTKEY   ; alt control F2
}

ACCELERATORS リソース

パラメーター

解説

例

関連項目

フィードバック

フィードバック

その他のリソース