Share via


Command.Keytip-Eigenschaft

Stellt die QuickInfo für ein Steuerelement dar.

Verbrauch

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

Attribute

Es gibt keine Attribute.

Untergeordnete Elemente

Element BESCHREIBUNG
String
Kann höchstens einmal auftreten

Übergeordnete Elemente

Element
Befehl

Bemerkungen

Optional.

Kann höchstens einmal für jedes Command-Element auftreten.

Command.Keytip kann einen Wert vom Typ xs:string enthalten, der auf eine beliebige Sequenz von Unicode-Zeichen beschränkt ist, einschließlich Leerzeichen.

Eine Command.Keytip kann nur mit einer Zahl beginnen, wenn sie einem Steuerelement innerhalb einer Registerkarte oder der Symbolleiste für den Schnellzugriff zugeordnet ist.

Um die Für den aktuellen Status des Menübands gültigen Tasteninfos anzuzeigen, halten Sie die ALT-TASTE gedrückt. Der folgende Screenshot zeigt die ersten oder ersten Tasteninfos, die in Microsoft Paint für Windows 7 angezeigt werden. Nachdem eine KeyTIP der ersten Ebene ausgewählt wurde, werden nur KeyTips der zweiten Ebene angezeigt.

Keytips der ersten Ebene in Microsoft Paint für Windows 7

Command.Keytip fungiert als Tastenkombination für einen Befehl, es sei denn, dieser Befehl wird über ein Menüelement verfügbar gemacht. In diesem Fall ignoriert das Framework den Command.Keytip-Wert und verwendet stattdessen ein Zeichen, das durch Command.LabelTitle oder UI_PKEY_Label angegeben wird. Wenn von Command.LabelTitle oder UI_PKEY_Label kein Ampersand angegeben wird, wird keine Tastenkombination oder Tastaturbeschleunigung verfügbar gemacht.

Wenn für Command.Keytip kein Wert angegeben wird, ist das untergeordnete String-Element erforderlich.

Hinweis

Wenn Command.Keytip sowohl einen Wert als auch ein untergeordnetes String-Element enthält, hat String Vorrang.

Standardmäßig werden die folgenden Buchstaben vom Framework verwendet, um automatisch Keytips zu generieren:

Hinweis

Keines dieser Buchstaben ist durch das Framework reserviert. Jeder kann nach Bedarf einem oder mehreren Befehlen zugewiesen werden.

Das Framework löst KeyTIP-Konflikte auf folgende Weise:

  • Wenn ein oder mehrere Tab-Steuerelemente derselben Keytip zugeordnet sind, wird an jede Keytip eine Zahl angefügt, beginnend bei 1 und nacheinander (2, 3,...) für jedes Steuerelement in der Reihenfolge der Deklaration. Wenn Tab-Steuerelementen der Buchstabe F als Keytip zugewiesen wird, wird dem Anwendungsmenü F1 zugewiesen, wobei die übrigen Tasteninfos wie beschrieben angepasst werden.
  • Wenn sie einem einzelnen Steuerelement innerhalb einer Registerkarte zugeordnet ist, ist die Tastenkombination F sowohl für das Steuerelement als auch für das Anwendungsmenü gültig. Die Standardtaste des Anwendungsmenüs wird nicht geändert, aber dem Steuerelement auf der aktiven Registerkarte wird Vorrang eingeräumt.
  • Wenn ein oder mehrere Steuerelemente innerhalb einer Registerkarte derselben KeyTIP zugeordnet sind, umgestaltet das Framework automatisch die KeyTips dieser Steuerelemente, wie zuvor beschrieben.

Hinweis

Eine geringfügige Variation der Textfarbe wird verwendet, um umgestaltete Keytips in einer Standardmäßigen Menübandimplementierung hervorzuheben. Bei einer nicht standardmäßigen Menübandimplementierung, bei der die Menübandfarbe angepasst wurde, wird dieses Frameworkverhalten überschrieben, und alle Keytips werden mit derselben Textfarbe angezeigt. Weitere Informationen finden Sie unter Anpassen von Menübandfarben.

Die maximale Länge ist nicht gebunden.

Beispiele

Im folgenden Beispiel wird das Markup für ein Command-Element mit einer Command.Keytip-Deklaration veranschaulicht.

<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>

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Server 2008 R2 [nur Desktop-Apps]

Siehe auch

UI_PKEY_Keytip