Metodo ICustomDestinationList::BeginList (shobjidl_core.h)

Avvia una sessione di compilazione per un jump list personalizzato.

Sintassi

HRESULT BeginList(
  [out] UINT   *pcMinSlots,
  [in]  REFIID riid,
  [out] void   **ppv
);

Parametri

[out] pcMinSlots

Tipo: UINT*

Puntatore che, quando termina, fa riferimento all'impostazione utente corrente per l'opzione Numero di elementi recenti da visualizzare nell'opzione Jump Elenchi nella finestra Proprietà menu Start e barra delle applicazioni. Il valore predefinito è 10. Si tratta del numero massimo di destinazioni che verranno visualizzate ed è un totale di tutte le destinazioni, indipendentemente dalla categoria. È possibile aggiungere altre destinazioni, ma non verranno visualizzate nell'interfaccia utente.

Una Jump List mostrerà sempre almeno questo numero di slot, ovvero le destinazioni e, se c'è spazio, attività.

Questo numero non include separatori e intestazioni di sezione, purché il numero totale di separatori e intestazioni non superi quattro. I separatori e le intestazioni di sezione oltre i primi quattro potrebbero ridurre il numero di destinazioni visualizzate se lo spazio è vincolato. Questo numero non influisce sulle voci di comando standard per l'aggiunta o l'annullamento dell'interruzione, la chiusura della finestra o l'avvio di una nuova istanza. Inoltre, non influisce sulle attività o sugli elementi aggiunti, il numero di cui è possibile visualizzare è basato sullo spazio disponibile per la Jump List.

[in] riid

Tipo: REFIID

Riferimento all'IID di un'interfaccia da recuperare in ppv, in genere IID_IObjectArray, che rappresenterà tutti gli elementi attualmente archiviati nell'elenco delle destinazioni rimosse per l'applicazione. Queste informazioni vengono usate per garantire che gli elementi rimossi non facciano parte della nuova Jump List.

[out] ppv

Tipo: void**

Quando termina, questo metodo contiene il puntatore di interfaccia richiesto in riid. Si tratta in genere di un oggetto IObjectArray, che rappresenta una raccolta di oggetti IShellItem e IShellLink che rappresentano gli elementi rimossi.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Se un'applicazione ha un ID modello utente applicazione esplicito (AppUserModelID), è necessario chiamare ICustomDestinationList::SetAppID prima di chiamare questo metodo.

L'interfaccia IObjectArray recuperata nel parametro ppv rappresenta lo stesso elenco di destinazioni rimosse recuperate tramite GetRemovedDestinations. Quando viene generato un nuovo jump list, le applicazioni devono prima elaborare le destinazioni rimosse. I dati di rilevamento per qualsiasi elemento nell'elenco rimosso devono essere cancellati. Se un'applicazione tenta di includere un elemento tramite AppendCategory presente in questo elenco di destinazioni rimosse, la chiamata AppendCategory non riesce. Ciò garantisce che le applicazioni rispettino la scelta dell'utente di elementi rimossi. Dopo aver eseguito una chiamata a CommitList senza alcuna chiamata non riuscita a AppendCategory a causa di un tentativo di riaggiungere un elemento rimosso dopo l'esecuzione di BeginList, l'elenco delle destinazioni rimosse viene cancellato. Successivamente, un elemento rimosso in precedenza può tornare all'elenco delle destinazioni se l'utente continua a usare l'elemento.

BeginList deve essere chiamato per avviare l'elenco prima che vengano effettuate chiamate per popolarlo tramite AppendCategory, AppendKnownCategory o AddUserTasks.

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)

Vedi anche

ICustomDestinationList

Estensioni della barra delle applicazioni