Partager via


System.AppUserModel.ID

UN ID de modèle utilisateur d’application explicite (AppUserModelID) utilisé pour associer des processus, des fichiers et des fenêtres à une application particulière. Dans certains cas, il suffit de s’appuyer sur l’AppUserModelID interne affecté à un processus par le système. Toutefois, une application qui possède plusieurs processus ou une application qui s’exécute dans un processus hôte peut avoir besoin de s’identifier explicitement via cette propriété afin qu’elle puisse regrouper ses fenêtres disparates sous un seul bouton de barre des tâches et contrôler le contenu de la liste de raccourcis de cette application.

Pour définir cette propriété sur une fenêtre, utilisez SHGetPropertyStoreForWindow pour récupérer le magasin de propriétés de la fenêtre et utilisez les méthodes de cet objet IPropertyStore récupéré pour définir la propriété System.AppUserModel.ID de cette fenêtre.

Pour plus d’informations, consultez ID de modèle utilisateur d’application (AppUserModelIDs) .

Au moment où la propriété System.AppUserModel.ID est définie, la barre des tâches est avertie d’actualiser ses informations sur la fenêtre ou le raccourci, étant donné que AppUserModelID.

D’autres propriétés de fenêtre et de raccourci peuvent être utilisées conjointement avec un AppUserModelID explicite pour contrôler davantage le regroupement et l’épinglage associés à une fenêtre, le nom complet et l’icône utilisés pour celle-ci dans la barre des tâches, et la commande pour lancer une application épinglée à la barre des tâches ou une nouvelle instance de l’application via la liste de raccourcis de cette application. Ces propriétés doivent être définies avant de définir la propriété System.AppUserModel.ID . Pour plus d'informations, voir les rubriques suivantes :

Windows 10, version 1703, Windows 10, version 1607, Windows 10, version 1511, Windows 10, version 1507, Windows 8.1, Windows 8, Windows 7

propertyDescription
   name = System.AppUserModel.ID
   shellPKey = PKEY_AppUserModel_ID
   formatID = 9F4C2855-9F79-4B39-A8D0-E1D42DE1D5F3
   propID = 5
   SearchInfo
      InInvertedIndex = false
      IsColumn = false
   typeInfo
      type = String
      IsInnate = false

Notes

Les valeurs PKEY sont définies dans Propkey.h.

ID de modèle utilisateur d’application (AppUserModelIDs)

SHGetPropertyStoreForWindow

propertyDescriptionList

propertyDescription

searchInfo

labelInfo

typeInfo

displayInfo

aliasInfo

stringFormat

booleanFormat

numberFormat

dateTimeFormat

enumeratedList

enum

enumRange

image

drawControl

editControl

filterControl

queryControl

relatedPropertyInfo

relatedProperty