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éments parents

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.

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.

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.

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

Voir aussi

UI_PKEY_Keytip