Interfaccia ICustomDestinationList (shobjidl_core.h)

  • Articolo

Espone i metodi che consentono a un'applicazione di fornire una Jump List personalizzata, incluse le destinazioni e le attività, per la visualizzazione nella barra delle applicazioni.

Ereditarietà

L'interfaccia ICustomDestinationList eredita dall'interfaccia IUnknown . ICustomDestinationList include anche questi tipi di membri:

Metodi

L'interfaccia ICustomDestinationList include questi metodi.

 
ICustomDestinationList::AbortList

Interrompe una sessione di compilazione jump list avviata da ICustomDestinationList::BeginList senza eseguire il commit di alcuna modifica.
ICustomDestinationList::AddUserTasks

Specifica gli elementi da includere nella categoria Attività di un jump list personalizzato.
ICustomDestinationList::AppendCategory

Definisce una categoria personalizzata e le destinazioni che contiene, per l'inclusione in una jump list personalizzata.
ICustomDestinationList::AppendKnownCategory

Specifica che la categoria Frequente o Recente deve essere inclusa in un jump list personalizzato.
ICustomDestinationList::BeginList

Avvia una sessione di compilazione per un jump list personalizzato.
ICustomDestinationList::CommitList

Dichiara che il jump list avviato da una chiamata a ICustomDestinationList::BeginList è completo e pronto per la visualizzazione.
ICustomDestinationList::D eleteList

Elimina un jump list personalizzato per un'applicazione specificata.
ICustomDestinationList::GetRemovedDestinations

Recupera l'elenco corrente di destinazioni che sono state rimosse dall'utente dalla Jump List esistente che deve essere sostituita da questa jump list personalizzata.
ICustomDestinationList::SetAppID

Specifica un ID modello utente applicazione univoco (AppUserModelID) per l'applicazione il cui pulsante della barra delle applicazioni conterrà il jump list personalizzato compilato tramite i metodi di questa interfaccia. È facoltativo.

Commenti

Quando implementare

Un'implementazione di questa interfaccia viene fornita in Windows come CLSID_DestinationList. Questa interfaccia non è implementata da terze parti.

Quando usare

Jump Elenchi contengono sia elenchi di destinazione che di attività.
  • Le destinazioni sono elementi visualizzati nelle categorie recenti, frequenti o personalizzate, in base all'utilizzo di un individuo. Le destinazioni possono essere file, cartelle, siti Web o altri elementi basati sul contenuto, ma non sono necessariamente supportati da file. Le destinazioni possono essere considerate come cose o sostantivi. Le destinazioni possono essere aggiunte o rimosse dalla Jump List dall'utente. In genere sono rappresentati da oggetti IShellItem , ma possono anche essere oggetti IShellLink .
  • Le attività sono azioni comuni eseguite in un'applicazione che si applicano a tutti gli utenti dell'applicazione indipendentemente dai modelli di utilizzo di un individuo. Le attività possono essere considerate come azioni o verbi. Le attività non possono essere aggiunte o rimosse. Sono rappresentati da oggetti IShellLink .

La barra delle applicazioni fornisce ogni pulsante della barra delle applicazioni con una Jump List. Per impostazione predefinita, un jump list contiene una categoria Recent , popolata automaticamente per le applicazioni basate su file tramite SHAddToRecentDocs o la finestra di dialogo di file comune. Per sostituire la categoria Recenti con la categoria Frequente o definire, aggiungere e popolare le proprie categorie personalizzate, un'applicazione deve chiamare i metodi di questa interfaccia. L'applicazione può anche fornire le proprie attività in base all'architettura dell'applicazione e all'uso previsto.

Nota Un'applicazione deve essere un gestore registrato per un tipo di file per visualizzare un elemento di quel tipo nella jump list. Non deve tuttavia essere il gestore predefinito per quel tipo di file.
 
Un jump list personalizzato è destinato a presentare contenuto considerato significativo in base all'utilizzo precedente dell'applicazione o tramite un'azione che ha indicato che un elemento è di importanza per l'utente, ad esempio l'utente che aggiunge un elemento a un elenco Preferiti.

L'applicazione deve chiamare questo oggetto per fornire un jump list personalizzato all'interfaccia utente della barra delle applicazioni. Il sistema non esegue mai query sull'applicazione per le informazioni.

Quando un'applicazione fornisce un jump list personalizzato, assume determinate responsabilità relative a tale elenco. Le categorie personalizzate devono essere popolate in modo coerente con l'uso previsto di una Jump List. Gli elementi nell'elenco devono essere controllati per la validità o non sono eseguiti correttamente se sono stati eliminati. Se l'utente rimuove un elemento dall'elenco, tale rimozione deve essere rispettata.

Un jump list personalizzato non viene mai aggiornato nel senso di modificare gli elementi in un elenco esistente. Invece, l'elenco precedente viene sostituito con un nuovo elenco.

La sequenza di base delle chiamate al metodo ICustomDestinationList per compilare e visualizzare un jump list personalizzato è la seguente:

  1. SetAppID (obbligatorio solo se un'applicazione fornisce il proprio AppUserModelID)
  2. BeginList
  3. AppendCategory, AppendKnownCategory, AddUserTasks o qualsiasi combinazione di questi tre metodi.
  4. CommitList

Requisiti

Requisito Valore
Client minimo supportato Windows 7 [solo app desktop]
Server minimo supportato Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione shobjidl_core.h (include Shobjidl.h)

Vedi anche

Estensioni della barra delle applicazioni