Elementi recenti

  • Articolo

L'elenco Elementi recenti è un riquadro nel menu applicazione che visualizza gli elementi di mrU usati più di recente per un'applicazione.

Dettagli

La schermata seguente illustra un elenco Elementi recenti da WordPad per Windows 7.

schermata dell'elenco degli elementi recenti nella barra multifunzione microsoft paint.

Il menu applicazione può avere al massimo un elenco ApplicationMenu.RecentItems, rappresentato da un elemento ApplicationMenu.RecentItems, per visualizzare documenti, immagini, film e altri progetti che un utente sta lavorando. Il numero di elementi elencati varia da zero al numero massimo specificato nel markup, con un valore predefinito di dieci. Gli elementi recenti vengono visualizzati come elenco numerato di stringhe che indicano nomi di file. È consigliabile usare la proprietà Command.LabelDescription per assegnare il percorso completo per il percorso del file, come illustrato nella schermata seguente.

screenshot di un elenco di elementi recenti in un menu dell'applicazione.

L'elemento RecentItems ha un attributo EnablePinning che, se impostato su true, visualizza un'icona di aggiunta a destra di ogni elemento nell'elenco, come illustrato nella schermata seguente.

Nota

L'aggiunta è abilitata per impostazione predefinita se l'attributo EnablePinning non è specificato.

 

schermata degli elementi recenti aggiunti in un menu dell'applicazione.

L'algoritmo di aggiunta è destinato a impedire agli elementi di cadere nell'elenco Elementi recenti . L'algoritmo produce il comportamento seguente:

  • Un nuovo elemento viene sempre aggiunto nella parte superiore dell'elenco Elementi recenti .
  • Gli elementi verranno spostati verso il basso nell'elenco nel tempo. Una volta che l'elenco è pieno (raggiunge il numero massimo di elementi specificati nel markup), gli elementi meno recenti rientrano nella parte inferiore dell'elenco come nuovi elementi vengono aggiunti all'inizio dell'elenco.
  • Se un elemento viene già visualizzato nell'elenco, ma viene nuovamente eseguito l'accesso, torna all'inizio dell'elenco.
  • Se viene aggiunto un elemento, verrà comunque eseguito il viaggio verso il basso, ma non verrà disattivato. Al contrario, una volta che l'elenco è pieno, il primo elemento non rimosso sopra l'elemento aggiunto verrà disattivato quando viene aggiunto un nuovo elemento all'elenco.
  • Se il numero di elementi aggiunti raggiunge mai il numero massimo di elementi, non verranno aggiunti nuovi elementi all'elenco finché non viene rimosso un elemento.

Proprietà degli elementi recenti

Il framework della barra multifunzione definisce una raccolta di chiavi di proprietà per il controllo Elementi recenti.

In genere, una proprietà Elementi recenti 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à definiti dal metodo di callback IUICommandHandler::UpdateProperty .

Il metodo di callback IUICommandHandler::UpdateProperty non viene eseguito e l'applicazione esegue una query per un valore di proprietà aggiornato, fino a quando la proprietà non è richiesta dal framework. Ad esempio, quando viene attivata una scheda e un controllo visualizzato nell'interfaccia utente della barra multifunzione o quando viene visualizzata una descrizione comando.

Nota

In alcuni casi, una proprietà può essere recuperata tramite il metodo IUIFramework::GetUICommandProperty e impostato con il metodo IUIFramework::SetUICommandProperty.

 

Nella tabella seguente sono elencate le chiavi delle proprietà associate al controllo Elementi recenti.

Chiave della proprietà Note
UI_PKEY_Keytip Può essere aggiornato solo tramite l'invalidazione.
UI_PKEY_RecentItems Può essere aggiornato solo tramite l'invalidazione.

 

Commenti

Il metodo IApplicationDocumentLists::GetList può essere usato per recuperare l'elenco MRU di Windows Shell per l'applicazione della barra multifunzione. L'oggetto recuperato da questo metodo può quindi essere usato dall'applicazione per creare i dati richiesti dal framework della barra multifunzione per popolare l'elenco Elementi recenti del menu applicazione.

Nota

Quando si usa questo metodo, listtype deve avere il valore ADLT_RECENT.

 

Per un esempio di come implementare un elenco di elementi MRU in un'applicazione framework della barra multifunzione, vedere l'esempio HTMLEditRibbon.

Libreria di controllo di Windows Ribbon Framework

Elemento di markup degli elementi recenti