System.AppUserModel.RelaunchIconResource
Spécifie l’icône utilisée pour le raccourci créé dans la barre des tâches lorsque l’utilisateur choisit d’épingler une application à la barre des tâches ou de lancer une nouvelle instance via la liste de raccourcis de son bouton. Il s’agit de l’icône utilisée pour le groupe de barres des tâches et affichée pour une application épinglée si cette application est en cours d’exécution ou non. Cela doit être spécifié dans l’un des formats suivants :
- Format de ressource standard, tel que «%systemdir%\system32\shell32.dll,-128 ». Caractère « - » avant l’ID de ressource requis. N’utilisez pas le caractère « @ » à l’avant de la chaîne de chemin d’accès.
- Chemin direct d’un fichier d’icône, tel que «%programfiles%\Microsoft\Notepad\Notepad.ico,0 ». Notez que, étant donné que .ico fichiers peuvent contenir plusieurs ressources d’icône, un ID de ressource est requis dans la chaîne. Si le fichier .ico est une image unique, utilisez « 0 » (sans le caractère « - ») comme ID de ressource.
System.AppUserModel.RelaunchIconResource est une propriété facultative. S’il n’est pas défini, l’icône de la cible de la commande de relance (System.AppUserModel.RelaunchCommand) est utilisée. Toutefois, étant donné que cela peut entraîner des résultats indésirables, nous vous encourageons vivement à fournir une icône explicitement via cette propriété.
Cette propriété est utilisée uniquement si une fenêtre a un ID de modèle utilisateur d’application explicite (AppUserModelID) (System.AppUserModel.ID, défini via SHGetPropertyStoreForWindow). Si la fenêtre n’a pas d’appUserModelID explicite (System.AppUserModel.ID), cette propriété est ignorée et la fenêtre est regroupée et épinglée comme si elle faisait partie de son processus propriétaire. Pour plus d’informations sur l’application d’AppUserModelIDs explicites et leur effet sur l’épinglage de la barre des tâches, consultez ID de modèle utilisateur d’application (AppUserModelIDs). Cette propriété est destinée à être utilisée par des applications ou des fenêtres qui souhaitent fournir des informations de relance non par défaut. Pour plus d’informations, consultez System.AppUserModel.RelaunchCommand.
Si un AppUserModelID explicite est défini sur la fenêtre, mais que cette propriété n’est pas définie, le système tente de trouver un raccourci avec le même AppUserModelID et épingle ce raccourci vers la barre des tâches pour représenter la fenêtre. Si aucun raccourci de ce type ne peut être localisé, l’exécutable de stockage du processus qui le possède est utilisé.
Note
Cette propriété est ignorée si System.AppUserModel.PreventPinning est définie. Cela permet à une application de contrôler le regroupement de ses fenêtres en leur affectant des appUserModelID explicites, mais en empêchant ces fenêtres d’être épinglées.
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.RelaunchIconRe source de cette fenêtre.
Windows 10, version 1703, Windows 10, version 1607, Windows 10, version 1511, Windows 10, version 1507, Windows 8.1
propertyDescription
name = System.AppUserModel.RelaunchIconResource
shellPKey = PKEY_AppUserModel_RelaunchIconResource
formatID = 9F4C2855-9F79-4B39-A8D0-E1D42DE1D5F3
propID = 3
SearchInfo
InInvertedIndex = false
IsColumn = true
typeInfo
type = String
IsInnate = false
Windows 8, Windows 7
propertyDescription
name = System.AppUserModel.RelaunchIconResource
shellPKey = PKEY_AppUserModel_RelaunchIconResource
formatID = 9F4C2855-9F79-4B39-A8D0-E1D42DE1D5F3
propID = 3
SearchInfo
InInvertedIndex = false
IsColumn = false
typeInfo
type = String
IsInnate = false
Rubriques connexes