Propriété Command.Keytip

Représente l’info-bulle d’un contrôle.

Utilisation

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

Attributs

Il n’y a pas d’attributs.

Éléments enfants

Élément	Description
String	Peut se produire au plus une fois

Éléments parents

Élément
Commande

Notes

Optionnel.

Peut se produire au maximum une fois pour chaque élément Command .

Command.Keytip peut contenir une valeur de type xs:string limitée à n’importe quelle séquence de caractères Unicode, y compris les espaces blancs.

Une info-bulle Command.Keytip peut commencer par un nombre uniquement lorsqu’elle est associée à un contrôle dans un onglet ou la barre d’outils Accès rapide.

Pour afficher les info-bulles valides pour l’état actuel du ruban, appuyez longuement sur la touche ALT. La capture d’écran suivante montre les info-bulles initiales ou de premier niveau affichées dans Microsoft Paint pour Windows 7. Une fois qu’une info-bulle de premier niveau a été sélectionnée, seules les info-bulles de deuxième niveau sont affichées.

Command.Keytip fait office d’accélérateur de clavier pour une commande, sauf si cette commande est exposée via un élément de menu. Dans ce cas, l’infrastructure ignore la valeur Command.Keytip et utilise à la place un caractère précédé d’une esperluette comme spécifié par Command.LabelTitle ou UI_PKEY_Label. Si aucune esperluette n’est spécifiée par Command.LabelTitle ou UI_PKEY_Label, aucune info-bulle ou raccourci clavier n’est exposée.

Si aucune valeur n’est fournie pour Command.Keytip, l’élément enfant String est requis.

Notes

Si Command.Keytip contient à la fois une valeur et un élément enfant String , String est prioritaire.

Par défaut, les lettres suivantes sont utilisées par l’infrastructure pour générer automatiquement des info-bulles :

• F est affecté au menu Application.
• Y est affecté à toute commande qui n’a pas d’info-bulle spécifiée par l’application.
• Z est affecté à chaque contrôle Group et ne peut pas être personnalisé. Une info-bulle de groupe s’affiche uniquement lorsque la stratégie de mise à l’échelle du contrôle spécifie une option de taille de fenêtre contextuelle. Pour plus d’informations, consultez Personnalisation d’un ruban via des définitions de taille et des stratégies de mise à l’échelle.

Notes

Aucune de ces lettres n’est réservée par le framework. Chacune peut être affectée à une ou plusieurs commandes selon les besoins.

L’infrastructure résout les conflits d’info-bulles des manières suivantes :

• Si un ou plusieurs contrôles Tab sont associés à la même info-bulle, un nombre est ajouté à chaque info-bulle, commençant à 1 et augmentant séquentiellement (2, 3,...) pour chaque contrôle dans l’ordre de déclaration. Si des contrôles Tab se voient attribuer la lettre F en tant qu’info-bulle, le menu Application est affecté à F1 avec les autres info-bulles ajustées comme décrit.
• Lorsqu’il est associé à un seul contrôle dans un onglet, l’info-bulle F est valide pour le contrôle et le menu Application. L’info-bulle par défaut du menu Application n’est pas modifiée, mais la priorité est accordée au contrôle sous l’onglet actif.
• Si un ou plusieurs contrôles d’un onglet sont associés à la même info-bulle, l’infrastructure refactorise automatiquement les info-bulles de ces contrôles, comme décrit précédemment.

Notes

Une légère variation de la couleur du texte est utilisée pour mettre en surbrillance les info-bulles refactorisée dans une implémentation de ruban standard. Pour une implémentation de ruban non standard où la couleur du ruban a été personnalisée, ce comportement d’infrastructure est remplacé et toutes les info-bulles sont affichées avec la même couleur de texte. Pour plus d’informations, consultez Personnalisation des couleurs du ruban.

La longueur maximale est illimitée.

Exemples

L’exemple suivant illustre le balisage d’un élément Command avec une déclaration Command.Keytip .

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

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]

Voir aussi

UI_PKEY_Keytip