Partager via

System.AppUserModel.RelaunchIconResource

  • Article

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 la barre des tâches et est affichée pour une application épinglée, que cette application soit en cours d’exécution ou non. Il doit être spécifié dans l’un des formats suivants :

  • Format de ressource standard, tel que « %systemdir%\system32\shell32.dll,-128 ». Caractère « - » avant que l’ID de ressource soit requis. N’utilisez pas le caractère « @ » à l’avant de la chaîne de chemin d’accès.
  • Chemin d’accès direct à un fichier d’icône, tel que « %programfiles%\Microsoft\Notepad\Notepad.ico,0 ». Notez que étant donné que les fichiers .ico 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. Si elle n’est pas définie, 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 par le biais de 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 groupée et épinglée comme si elle faisait partie de son processus de propriétaire. Pour plus d’informations sur l’application des AppUserModelID 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 les applications ou les fenêtres qui souhaitent fournir des informations de relance autres que celles 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 à la barre des tâches pour représenter la fenêtre. Si aucun raccourci de ce type ne peut être trouvé, l’exécutable de stockage du processus propriétaire est utilisé.

Notes

Cette propriété est ignorée si System.AppUserModel.PreventPinning est défini. Cela permet à une application de contrôler le regroupement de ses fenêtres en leur affectant des ID AppUserModel explicites, mais en empêchant l’épinglage de ces fenêtres.

 

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.RelaunchIconResource 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

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

System.AppUserModel.ID

propertyDescriptionList

propertyDescription

searchInfo

labelInfo

typeInfo

displayInfo

aliasInfo

stringFormat

booleanFormat

numberFormat

dateTimeFormat

enumeratedList

enum

enumRange

image

drawControl

editControl

filterControl

queryControl

relatedPropertyInfo

relatedProperty