Condividi tramite


Interfaccia IApplicationDestinations (shobjidl_core.h)

Espone i metodi che consentono a un'applicazione di rimuovere una o tutte le destinazioni dalle categorie Recenti o Frequenti in una Jump List.

Ereditarietà

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

Metodi

L'interfaccia IApplicationDestinations include questi metodi.

 
IApplicationDestinations::RemoveAllDestinations

Cancella tutte le voci di destinazione dalle categorie Recenti e Frequenti nella Jump List di un'applicazione.
IApplicationDestinations::RemoveDestination

Rimuove una singola destinazione dalle categorie Recenti e Frequenti in una Jump List.
IApplicationDestinations::SetAppID

Specifica un ID modello utente applicazione univoco (AppUserModelID) per l'applicazione dalla quale jump list del pulsante della barra delle applicazioni i metodi di questa interfaccia rimuoveranno le destinazioni. È facoltativo.

Commenti

Quando implementare

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

Quando usare

Un'applicazione chiama i metodi di questa interfaccia quando vuole rimuovere elementi dalle destinazioni generate automaticamente da una Jump List. Queste destinazioni, disponibili nelle categorie Recenti o Frequenti , vengono generate tramite chiamate a SHAddToRecentDocs, in modo esplicito o dal sistema quando un file viene aperto tramite Esplora risorse o la finestra di dialogo di file comune viene usata per aprire, salvare o creare un file.

Un'applicazione deve chiamare i metodi IApplicationDestinations nelle situazioni seguenti:

  • Quando l'applicazione viene disinstallata.
  • Quando l'utente cancella la cronologia.
  • Quando l'utente disabilita il rilevamento della destinazione nelle pagine Impostazioni o Opzioni dell'applicazione.
  • Quando l'utente elimina la destinazione dall'interno dell'applicazione. Ciò è particolarmente importante nel caso di una destinazione che non è un file. Nel caso di destinazioni non file, in genere, anche se non sempre, gli elementi IShellLink , è responsabilità dell'applicazione rimuovere la destinazione dall'elenco quando rileva che non esiste più.

Se l'utente disattiva il rilevamento dell'utilizzo nell'impostazione della privacy dell'applicazione, l'applicazione è responsabile della cancellazione dei dati esistenti e anche dell'arresto della raccolta dei dati di utilizzo su tale elemento in futuro. Questa operazione viene eseguita impostando il valore NoRecentDocs in tutte le registrazioni del tipo di file dell'applicazione. Per altre informazioni, vedere FTA_NoRecentDocs .

I metodi IApplicationDestinations vengono usati solo con le categorie Recenti o Frequenti generate automaticamente. Non rimuove gli elementi aggiunti dall'utente alla Jump List. Tali elementi non possono essere rimossi a livello di codice; solo l'utente può rimuoverli. Questi metodi non hanno effetto anche sulle categorie personalizzate o sull'elenco di attività.

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