Interface IObjectWithAppUserModelID (shobjidl_core.h)
Expose les méthodes qui permettent aux implémenteurs d’un objet IAssocHandler personnalisé de fournir l’accès à son ID de modèle utilisateur d’application explicite (AppUserModelID). Ces informations sont utilisées pour déterminer si un type de fichier particulier peut être ajouté à la liste de raccourcis d’une application.
Héritage
L’interface IObjectWithAppUserModelID hérite de l’interface IUnknown. IObjectWithAppUserModelID possède également les types de membres suivants :
Méthodes
L’interface IObjectWithAppUserModelID contient ces méthodes.
|
IObjectWithAppUserModelID ::GetAppID Récupère l’ID explicite du modèle utilisateur d’application (AppUserModelID) d’un gestionnaire de types de fichiers, s’il a été déclaré. |
|
IObjectWithAppUserModelID ::SetAppID Spécifie un ID de modèle utilisateur d’application (AppUserModelID) unique défini par l’application qui identifie l’objet en tant que gestionnaire pour un type de fichier spécifique. Cette méthode est utilisée par les applications qui nécessitent des AppUserModelID dynamiques. |
Remarques
Seuls les types de fichiers pour lesquels une application est un gestionnaire inscrit apparaissent dans la liste de raccourcis de cette application. Lorsqu’une application utilise un AppUserModelID explicite pour s’identifier ainsi que les fenêtres et les processus qui lui appartiennent, ce AppUserModelID doit également être défini dans l’implémentation d’un gestionnaire afin que le gestionnaire soit reconnu comme associé à cette application. Lorsque l’application accède à un fichier tel que SHAddToRecentDocs est appelé en conséquence, une tentative d’ajout du fichier à la catégorie Récent ou Fréquent , ou éventuellement à une catégorie personnalisée, est effectuée dans la liste de raccourcis de cette application. Si l’application est un gestionnaire inscrit pour ce type de fichier, identifié comme tel par l’AppUserModelID du gestionnaire correspondant à l’AppUserModelID de l’application, ce fichier est ajouté à la liste de raccourcis. Si ce n’est pas le cas, il est filtré et n’apparaît pas.
Quand implémenter
Une implémentation de cette interface est fournie dans Windows. Les applications qui créent des dossiers Shell personnalisés qui exposent une énumération de gestionnaire d’association nécessaire au système pour déterminer les fichiers autorisés dans la liste de raccourcis de l’application doivent implémenter leurs propres versions.Quand utiliser
Cet objet est nécessaire uniquement si votre application utilise des AppUserModelID explicites. Sans appUserModelID explicite à exposer, cet objet n’est pas nécessaire.IObjectWithAppUserModelID est toujours utilisé dans le cadre d’un objet plus grand qui utilise des AppUserModelID explicites et souhaite exposer ces informations au système.
Le système appelle la méthode IObjectWithAppUserModelID ::GetAppID implémentée sur un gestionnaire pour déterminer si l’application est un gestionnaire inscrit pour un type de fichier.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 7 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 R2 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | shobjidl_core.h (inclure Shobjidl.h) |