Metodo ICustomDestinationList::AppendKnownCategory (shobjidl_core.h)

Articolo
08/26/2023

Specifica che la categoria Frequente o Recente deve essere inclusa in un elenco jump personalizzato.

Sintassi

HRESULT AppendKnownCategory(
  [in] KNOWNDESTCATEGORY category
);

Parametri

[in] category

Tipo: KNOWNDESTCATEGORY

Uno dei valori seguenti che indicano quale categoria nota aggiungere all'elenco:

KDC_FREQUENT (1)

0x1. Aggiungere la categoria Frequente .

KDC_RECENT (2)

0x2. Aggiungere la categoria Recente .

Valore restituito

Tipo: HRESULT

Restituisce S_OK se ha esito positivo o un valore di errore in caso contrario.

Se è presente un'impostazione di privacy Criteri di gruppo o privacy degli utenti, può influire sul risultato di questo metodo. Le categorie che contengono elementi specifici dell'utente in base all'utilizzo individuale non sono consentite in tali impostazioni di privacy. A causa di questo, le categorie recenti o frequenti aggiunte tramite questo metodo non avranno dati e le categorie senza dati non vengono visualizzati. Tuttavia, in tale situazione, questa chiamata al metodo non comporta un codice di errore.

Commenti

Prima di chiamare questo metodo, è necessario chiamare ICustomDestinationList::BeginList .

La categoria Recente viene visualizzata in un elenco jump predefinito, ma per visualizzarla in un jump list personalizzato insieme alle categorie personalizzate è necessario richiederla in modo esplicito tramite questo metodo.

Con AppendCategory e AppendKnownCategory, un elenco jump personalizzato deve essere progettato per evitare che qualsiasi elemento venga visualizzato in più categorie. Se due categorie sono semplicemente visualizzazioni diverse sugli stessi dati, una di queste categorie deve essere rimossa perché usa lo spazio Jump List senza contribuire alla praticità dell'utente. I duplicati non vengono nascosti dal sistema, ad eccezione del caso di una destinazione aggiunta, nel qual caso la destinazione viene visualizzata nella categoria Aggiunta e nascosta in tutti gli altri.

È probabile che le categorie frequenti e recenti contengano un grado di sovrapposizione e pertanto non è consigliabile aggiungere entrambe le categorie a un singolo jump list. Quale dei due è migliore per l'applicazione dipende dalla sua natura. Un'applicazione che genera file, ad esempio Microsoft Word o Microsoft Paint, deve usare la categoria Recente perché gli utenti vogliono tornare ai file che hanno recentemente lavorato. Un'applicazione usata più per l'esplorazione o la riproduzione dei dati creati altrove deve usare la categoria Frequente perché l'utente può accedere a un numero maggiore di elementi, molti di essi una sola volta. In altre parole, se l'applicazione è più probabile accedere a un numero elevato di elementi solo pochi volte, che contribuisce al rumore per il set più piccolo di elementi che gli utenti vogliono accedere molte volte, Frequente è la scelta migliore. Se l'applicazione è più probabile che si accinga a un numero minore di elementi più recenti la maggior parte del tempo, è consigliabile scegliere Recenti.

Le categorie in un elenco jump personalizzato, inclusa la categoria Recente o Frequente nota, vengono visualizzate nell'ordine di aggiunta, con le categorie aggiunte più di recente nella parte inferiore dell'elenco.

Qualsiasi numero di destinazioni aggiunte al valore indicato dal parametro pcMinItems in ICustomDestinationList::BeginList non viene visualizzato.

Le categorie vuote non vengono visualizzate.

I contenuti delle categorie Frequenti e Recenti vengono calcolati per ogni applicazione che usa SHAddToRecentDocs direttamente. In alcuni casi di azione dell'utente, ad esempio l'apertura di un file tramite Esplora risorse o l'uso della finestra di dialogo file comune per aprire, salvare o creare un file, Shell chiama SHAddToRecentDocs per conto di un'applicazione e tali chiamate vengono prese in considerazione anche nelle statistiche di utilizzo. Shell chiama anche SHAddToRecentDocs per conto dell'applicazione quando viene avviata una destinazione dal relativo Jump List. Tuttavia, è consigliabile che l'applicazione chiami in modo esplicito SHAddToRecentDocs anche se si prevede che shell eseguirà la chiamata. Ciò garantisce che l'utilizzo sia registrato e gli algoritmi per tenere traccia dell'utilizzo recente o frequente verranno corretti per le chiamate duplicate.

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)
Libreria	Shell32.lib
DLL	Shell32.dll (versione 6.1 o successiva)