次の方法で共有

Command.Keytip プロパティ

  • [アーティクル]

コントロールのキーヒントを表します。

使用法

<Command.Keytip>
  child elements
</Command.Keytip>

属性

属性はありません。

子要素

要素 説明
String
 最大で 1 回発生する可能性があります

親要素

要素
コマンド

解説

省略可能。

Command 要素ごとに、最大で 1 回発生する可能性があります。

Command.Keytip には、空白を含む Unicode 文字のシーケンスに制約された xs:string 型の値を含めることができます。

Command.Keytip は、Tab またはクイック アクセス ツール バー内のコントロールに関連付けられている場合にのみ、数値で始めることができます。

リボンの現在の状態に対して有効なキーヒントを表示するには、Alt キーを押したままにします。 次のスクリーン ショットは、Windows 7 のMicrosoft ペイントに表示される最初の、または最初のレベルのキーヒントを示しています。 第 1 レベルのキーヒントを選択すると、第 2 レベルのキーヒントのみが表示されます。

Windows 7 用 Microsoft Paint の第 1 レベルのキーヒント

Command.Keytip は、そのコマンドがメニュー項目を介して公開されない限り、コマンドのキーボード アクセラレータとして機能します。 この場合、フレームワークは Command.Keytip 値を無視し、代わりに Command.LabelTitle または UI_PKEY_Label で指定されたアンパサンドの前にある文字を使用します。 Command.LabelTitle または UI_PKEY_Label でアンパサンドが指定されていない場合、キーヒントやキーボード アクセラレータは公開されません。

Command.Keytip に値が指定されていない場合は、String 子要素が必要です。

Note

Command.Keytip に値と String 子要素の両方が含まれている場合は、String が優先されます。

既定では、次の文字がフレームワークによって使用され、キーヒントが自動的に生成されます。

Note

これらの文字はいずれもフレームワークによって予約されません。 各コマンドは、必要に応じて 1 つ以上のコマンドに割り当てることができます。

フレームワークは、次の方法でキーヒントの競合を解決します。

  • 1 つ以上の Tab コントロールが同じキーヒントに関連付けられている場合、各キーヒントに数値が追加され、1 から始まり、宣言の順序で各コントロールに対して順番に (2,3,...) 増加します。 Tab コントロールにキーヒントとして文字 F が割り当てられている場合、 アプリケーション メニュー には F1 が割り当てられ、残りのキーヒントは説明に従って調整されます。
  • Tab 内の 1 つのコントロールに関連付けられている場合、キーヒント F はコントロールとアプリケーション メニューの両方に対して有効です。 既定の [アプリケーション メニュー] キーヒントは変更されませんが、アクティブタブのコントロールに優先順位が与えられます。
  • Tab 内の 1 つ以上のコントロールが同じキーヒントに関連付けられている場合、フレームワークは前述のように、これらのコントロールのキーヒントを自動的にリファクタリングします。

Note

テキストの色のわずかなバリエーションは、標準のリボン実装でリファクタリングされたキーヒントを強調表示するために使用されます。 リボンの色がカスタマイズされた標準以外のリボン実装の場合、このフレームワークの動作はオーバーライドされ、すべてのキーヒントが同じテキスト色で表示されます。 詳細については、「 リボンの色のカスタマイズ」を参照してください。

最大長は無制限です。

例

次の例では、Command.Keytip 宣言を使用した Command 要素のマークアップを示します。

<Command>
  <Command.Name>cmdSave</Command.Name>
  <Command.Symbol>ID_FILE_SAVE</Command.Symbol>
  <Command.Comment>Save</Command.Comment>
  <Command.Id>25003</Command.Id>
  <Command.LabelTitle>
    <String>
      <String.Content>Label for Save</String.Content>
      <String.Id>59999</String.Id>
      <String.Symbol>strSave</String.Symbol>
    </String>
  </Command.LabelTitle>
  <Command.TooltipTitle>Tooltip title with &amp;&amp; for Save Command</Command.TooltipTitle>
  <Command.TooltipDescription>Tooltip description for Save Command.</Command.TooltipDescription>
  <Command.Keytip>s1</Command.Keytip>
</Command>

必要条件

要件 値
サポートされている最小のクライアント
 Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows Server 2008 R2 [デスクトップ アプリのみ]

関連項目

UI_PKEY_Keytip