Menu applicazione
Il menu applicazione è il menu principale per un'applicazione che implementa il framework della barra multifunzione di Windows.
- Introduzione
-
Componenti del menu applicazione
- menu menu applicazioneGruppi
- ridimensionamento del menu applicazione
- Proprietà menu applicazione
- argomenti correlati
Introduzione
Il menu applicazione è costituito da un controllo pulsante a discesa che visualizza un menu contenente comandi che espongono funzionalità correlate a un progetto completo, ad esempio un intero documento, un'immagine o un filmato. Gli esempi includono New, Open, Savee Exit Commands.
La schermata seguente illustra il menu applicazione.
Componenti del menu dell'applicazione
Il menu applicazione è un elemento obbligatorio in qualsiasi applicazione della barra multifunzione. Il punto di ingresso nel menu applicazione è un pulsante distintivo visualizzato come primo elemento nella riga Tab, come illustrato nella schermata seguente.
Nota
Windows 8 e versioni successive: immagine del pulsante Menu applicazione modificata per etichetta: File. È consigliabile non usare File come etichetta per le schede personalizzate.
Quando si fa clic su questo pulsante, viene visualizzato il menu rtf visualizzato nella schermata seguente (menu applicazione da WordPad per Windows 7).
Nota
Non c'è alcun impatto sulla scheda impostata quando si fa clic sul pulsante Menu applicazione; lo stato attivo entra invece nel menu.
Il menu applicazione contiene due riquadri: un elenco di comandi rappresentato da uno o più elementi menuGroup e un elenco elementi recenti rappresentato da un elemento ApplicationMenu.RecentItems.
Menu Menu applicazioneGruppi di menu
L'elementoApplicationMenudeve contenere almeno un MenuGroup elemento figlio che espone un elenco di comandi a livello di applicazione. Se vengono dichiarati più elementi MenuGroup, viene disegnata una linea di divisione tra i gruppi, come illustrato nella schermata seguente.
Di seguito è riportato un elenco di vincoli per un elemento MenuGroup di un menu dell'applicazione:
Tutti gli elementiMenuGroupdevono essere dichiarati con un valore di attributo classe di
MajorItems.Un menu applicazione MenuGroup supporta solo i controlli Button, Drop-Down Button, Split Button, Drop-Down Gallerye Split Button Gallery.
! [Importante]
Le raccolte di comandi sono l'unico tipo di raccolta supportato nel menu applicazione. Per altre informazioni sui controlli della raccolta, vedere Uso delle raccolte.
Quando un Pulsante viene utilizzato in un MenuGroup, il valore di Command.LabelTitle viene visualizzato nel menu e i valori di Command.TooltipTitle e Command.TooltipDescription vengono visualizzati come descrizione comando, come illustrato nella schermata seguente.
Quando un pulsante Drop-Down, pulsante di divisione, Drop-Down Raccoltao raccolta pulsanti di divisione viene utilizzata nel menu applicazione, la parte del menu viene visualizzata come riquadro a comparsa che copre e nasconde il riquadro elementi recenti.
Per pulsante di divisione e Drop-Down controlli pulsante, il valore di Command.LabelDescription viene visualizzato inline nel menu a comparsa per aiutare visivamente gli utenti a individuare la funzionalità Comando. Il valore visualizzato di Command.LabelDescription viene suddiviso a livello di codice su un intervallo di due righe e viene effettuato un tentativo di adattare esattamente il valore rispetto agli elementi recenti riquadro sotto. Se il valore Command.LabelDescription non rientra, il riquadro a comparsa si espanderà per contenere il valoreCommand.Comment più lungo nel MenuGroup.
Lo screenshot seguente illustra questi comportamenti in un riquadro a comparsa pulsante di divisione.
Con un Drop-Down Gallery e una raccolta pulsante di divisione, vengono visualizzate solo un'etichetta e un'immagine.
Ridimensionamento del menu applicazione
Il ridimensionamento del menu applicazione viene gestito dal framework della barra multifunzione. Se vengono fornite stringhe molto lunghe per il valore di Command.LabelTitle o Command.LabelDescriptiono viene usato un lungo elenco di comandi, il menu ne regola le dimensioni in base al contenuto. Alcune forme di regolazione includono l'espansione delle dimensioni dei riquadri a comparsa o dei riquadri di menu e l'aggiunta di visualizzatori panoramica quando è necessario lo scorrimento.
Proprietà menu applicazione
Il framework della barra multifunzione definisce una raccolta di chiavi delle proprietà per il controllo Menu applicazione.
In genere, una proprietà Menu applicazione viene aggiornata nell'interfaccia utente della barra multifunzione invalidando il comando associato al controllo tramite una chiamata al metodo IUIFramework::InvalidateUICommand. L'evento di invalidazione viene gestito e gli aggiornamenti delle proprietà vengono definiti dal metodo di callback IUICommandHandler::UpdateProper ty.
L'IUICommandHandler::UpdateProperty metodo di callback non viene eseguito e l'applicazione non viene eseguita una query per un valore della proprietà aggiornato fino a quando la proprietà non è richiesta dal framework. Ad esempio, il framework richiede la proprietà quando viene attivata una scheda e viene visualizzato un controllo nell'interfaccia utente della barra multifunzione o quando viene visualizzata una descrizione comando.
| Chiave della proprietà | Note |
|---|---|
| UI_PKEY_TooltipDescription | Può essere aggiornato solo tramite invalidazione. |
| UI_PKEY_TooltipTitle | Può essere aggiornato solo tramite invalidazione. |
Argomenti correlati