Interfaccia IObjectWithAppUserModelID (shobjidl_core.h)
Espone i metodi che consentono agli implementatori di un oggetto IAssocHandler personalizzato di fornire l'accesso al relativo ID modello utente applicazione esplicito (AppUserModelID). Queste informazioni vengono usate per determinare se è possibile aggiungere un tipo di file specifico all'elenco jump list di un'applicazione.
Ereditarietà
L'interfaccia IObjectWithAppUserModelID eredita dall'interfaccia IUnknown . IObjectWithAppUserModelID include anche questi tipi di membri:
Metodi
L'interfaccia IObjectWithAppUserModelID include questi metodi.
|
IObjectWithAppUserModelID::GetAppID Recupera l'ID del modello utente dell'applicazione esplicito del tipo di file (AppUserModelID), se è stato dichiarato. |
|
IObjectWithAppUserModelID::SetAppID Specifica un ID modello utente applicazione univoco definito dall'applicazione (AppUserModelID) che identifica l'oggetto come gestore per un tipo di file specifico. Questo metodo viene usato dalle applicazioni che richiedono AppUserModelID dinamici. |
Commenti
Solo i tipi di file per cui un'applicazione è un gestore registrato vengono visualizzati nell'elenco jump list dell'applicazione. Quando un'applicazione usa un AppUserModelID esplicito per identificare se stesso e i processi e le finestre che appartengono a esso, è necessario impostare anche AppUserModelID nell'implementazione di un gestore in modo che il gestore venga riconosciuto come associato a tale applicazione. Quando l'applicazione accede a un file in modo che SHAddToRecentDocs venga chiamato di conseguenza, viene eseguito un tentativo di aggiungere il file alla categoria Recente o Frequente o eventualmente una categoria personalizzata, nell'elenco jump list dell'applicazione. Se l'applicazione è un gestore registrato per tale tipo di file, identificato come tale dal gestore AppUserModelID corrispondente all'AppUserModelID dell'applicazione, tale file viene aggiunto all'elenco jump. In caso contrario, viene filtrato e non viene visualizzato.
Quando implementare
In Windows viene fornita un'implementazione di questa interfaccia. Le applicazioni che creano cartelle di Shell personalizzate che espongono un'enumerazione del gestore di associazione necessaria dal sistema per determinare i file consentiti nell'elenco jump dell'applicazione devono implementare le proprie versioni.Quando usare
Questo oggetto è necessario solo se l'applicazione usa AppUserModelID esplicito. Senza un AppUserModelID esplicito da esporre, non è necessario per questo oggetto.IObjectWithAppUserModelID viene sempre usato come parte di un oggetto più grande che usa AppUserModelID esplicito e vuole esporre tali informazioni al sistema.
Il sistema chiama il metodo IObjectWithAppUserModelID::GetAppID implementato in un gestore per determinare se l'applicazione è un gestore registrato per un tipo di file.
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) |