Command.Keytip, proprietà

Rappresenta la descrizione chiave per un controllo.

Utilizzo

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

Attributi

Non ci sono attributi.

Elementi figlio

Elemento	Descrizione
Stringa	Può verificarsi al massimo una volta

Elementi padre

Elemento
Comando

Commenti

Facoltativa.

Può verificarsi al massimo una volta per ogni elemento Command .

Command.Keytip può contenere un valore di tipo xs:string vincolato a qualsiasi sequenza di caratteri Unicode, incluso lo spazio vuoto.

Una descrizione comando.keytip può iniziare con un numero solo quando associato a un controllo all'interno di una scheda o alla barra degli strumenti di accesso rapido.

Per visualizzare le descrizioni tasti valide per lo stato corrente della barra multifunzione, premere e tenere premuto il tasto ALT. La schermata seguente mostra le descrizioni dei tasti iniziali o di primo livello visualizzate in Microsoft Paint per Windows 7. Dopo aver selezionato una descrizione chiave di primo livello, vengono visualizzate solo le descrizioni chiave di secondo livello.

Command.Keytip funge da acceleratore di tastiera per un comando a meno che tale comando non sia esposto tramite una voce di menu. In questo caso, il framework ignora il valore Command.Keytip e usa invece un carattere preceduto da un ampersand come specificato da Command.LabelTitle o UI_PKEY_Label. Se non viene specificato alcun ampersand da Command.LabelTitle o UI_PKEY_Label, non viene esposto alcun tasto o acceleratore da tastiera.

Se non viene fornito alcun valore per Command.Keytip, è necessario l'elemento figlio String .

Nota

Se Command.Keytip contiene sia un valore che un elemento figlio String , String ha la precedenza.

Per impostazione predefinita, le lettere seguenti vengono usate dal framework per generare automaticamente le descrizioni chiavi:

• F viene assegnato al menu applicazione.
• Y viene assegnato a qualsiasi comando che non dispone di una descrizione chiave specificata dall'applicazione.
• Z viene assegnato a ogni controllo Gruppo e non può essere personalizzato. Viene visualizzata una descrizione chiave gruppo solo quando il controllo ScalingPolicy per il controllo specifica un'opzione Dimensioni popup . Per altre informazioni, vedere Personalizzazione di una barra multifunzione tramite definizioni di dimensioni e criteri di scalabilità.

Nota

Nessuna di queste lettere è riservata dal framework. Ogni oggetto può essere assegnato a uno o più comandi in base alle esigenze.

Il framework risolve i conflitti di descrizione chiave nei modi seguenti:

• Se uno o più controlli Tab sono associati alla stessa descrizione chiave, un numero viene aggiunto a ogni descrizione chiave, a partire da 1 e aumentando in sequenza (2, 3,...) per ogni controllo nell'ordine di dichiarazione. Se i controlli tabulazioni vengono assegnati alla lettera F come descrizione chiave, il menu applicazione viene assegnato F1 con le descrizioni tasti rimanenti regolate come descritto.
• Se associato a un singolo controllo all'interno di una scheda, la descrizione chiave F è valida sia per il controllo che per il menu applicazione. La descrizione comando del menu applicazione predefinita non viene modificata, ma la precedenza viene assegnata al controllo nella scheda attiva.
• Se uno o più controlli all'interno di una scheda sono associati alla stessa descrizione chiave, il framework esegue automaticamente il refactoring delle descrizioni chiavi di tali controlli, come descritto in precedenza.

Nota

Una leggera variazione nel colore del testo viene usata per evidenziare le descrizioni chiavi refactoring in un'implementazione della barra multifunzione standard. Per un'implementazione della barra multifunzione non standard in cui è stato personalizzato il colore della barra multifunzione, questo comportamento del framework viene sottoposto a override e tutte le descrizioni comandi vengono visualizzate con lo stesso colore del testo. Per altre informazioni, vedere Personalizzazione dei colori della barra multifunzione.

La lunghezza massima non è in uscita.

Esempio

Nell'esempio seguente viene illustrato il markup per un elemento Command con una dichiarazione 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>

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]

Vedi anche

UI_PKEY_Keytip