Menu applicazione

Il menu applicazione è il menu principale per un'applicazione che implementa il framework della barra multifunzione di Windows.

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 i comandi New, Open, Save e Exit .

La schermata seguente illustra il menu applicazione.

screenshot del menu dell'applicazione e dell'elenco di voci recenti della barra multifunzione di paint per Windows 7.

Componenti del menu applicazione

Il menu applicazione è un elemento obbligatorio in qualsiasi applicazione della barra multifunzione. Il punto di ingresso nel menu applicazione è un pulsante distintivo che viene visualizzato come primo elemento nella riga Tab , come illustrato nella schermata seguente.

Nota

Windows 8 e versioni successive: immagine del pulsante Del menu dell'applicazione modificata in etichetta: File. È consigliabile non usare File come etichetta per le schede personalizzate.

 

screenshot del pulsante del menu dell'applicazione del wordpad per Windows 7.

Quando si fa clic, questo pulsante visualizza il menu avanzato visualizzato nella schermata seguente (menu applicazione da WordPad per Windows 7).

screenshot del menu dell'applicazione di 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 rappresentati da uno o più elementi MenuGroup e un elenco Elementi recenti rappresentato da un elemento ApplicationMenu.RecentItems .

Menu ApplicazioneGruppi menu

L'elemento ApplicationMenu deve contenere almeno un elemento figlio MenuGroup 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.

screenshot di un menu di menu dell'applicazione.

Di seguito è riportato un elenco di vincoli per un elemento MenuGroup di un menu applicazione:

Quando un controllo Button 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.

screenshot di un controllo pulsante in un menu dell'applicazione.

Quando viene utilizzato un pulsante a discesa, un pulsante di divisione, una raccolta a discesa o una raccolta di pulsanti di divisione nel menu applicazione, la parte del menu viene visualizzata come riquadro a comparsa che copre e nasconde il riquadro Elementi recenti.

Per i controlli Pulsante di divisione e pulsante a discesa , 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 a due righe e viene effettuato un tentativo di adattare il valore esattamente al riquadro Elementi recenti sottostante. Se il valore Command.LabelDescription non è adatto, il riquadro a comparsa si espande per contenere il valore Command.Comment più lungo nel MenuGroup.

Lo screenshot seguente illustra questi comportamenti in un riquadro a comparsa pulsante di divisione .

screenshot di un riquadro a comparsa del controllo elenco in un menu dell'applicazione.

Con una raccolta a discesa e una raccolta di pulsanti 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 specificate stringhe molto lunghe per il valore di Command.LabelTitle o Command.LabelDescription o viene utilizzato 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 di panoramica quando è necessario lo scorrimento.

Proprietà del menu applicazione

Il framework della barra multifunzione definisce una raccolta di chiavi di 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::UpdateProperty .

Il metodo di callback IUICommandHandler::UpdateProperty non viene eseguito e l'applicazione non viene eseguita una query per un valore di proprietà aggiornato finché 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.

 

Libreria di controlli di Windows Ribbon Framework

Elemento di markup ApplicationMenu