Partager via


System.AppUserModel.RelaunchCommand

Spécifie une commande qui peut être exécutée via ShellExecute pour lancer une application lorsqu’elle est épinglée à la barre des tâches ou lorsqu’une nouvelle instance de l’application est lancée via la liste de raccourcis de l’application.

En voici quelques exemples :

shell:::{ED228FDF-9EA8-4870-83B1-96B02CFE0D52}

virtualhost.exe /virtualapp:12345

notepad.exe

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, cette propriété est ignorée et la fenêtre est groupée et épinglée comme si elle faisait partie du processus qui la possède. 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.

Notes

System.AppUserModel.RelaunchCommand et System.AppUserModel.RelaunchDisplayNameResource doivent toujours être définis ensemble. Si l’une de ces propriétés n’est pas définie, aucune des deux n’est utilisée.

 

Cette propriété, ainsi que System.AppUserModel.RelaunchDisplayNameResource et System.AppUserModel.RelaunchIconResource , peut être utilisée pour définir visuellement une fenêtre en tant qu’application pour l’utilisateur. Cela est utile pour les scénarios d’application hôte, où un seul hôte instance exécute plusieurs applications enfants. Par exemple, une machine virtuelle qui héberge plusieurs applications virtualisées peut souhaiter que ces applications virtualisées apparaissent en tant qu’applications individuelles pour l’utilisateur. La machine virtuelle peut étiqueter chaque fenêtre avec un AppUserModelID explicite et les propriétés de relance appropriées pour qu’elles apparaissent en tant qu’applications. L’utilisateur peut ensuite les épingler à la barre des tâches et « relancer » le instance épinglé.

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.RelaunchCommand de cette fenêtre.

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.RelaunchCommand
   shellPKey = PKEY_AppUserModel_RelaunchCommand
   formatID = 9F4C2855-9F79-4B39-A8D0-E1D42DE1D5F3
   propID = 2
   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)

System.AppUserModel.ID

propertyDescriptionList

propertyDescription

searchInfo

labelInfo

typeInfo

displayInfo

aliasInfo

stringFormat

booleanFormat

numberFormat

dateTimeFormat

enumeratedList

enum

enumRange

image

drawControl

editControl

filterControl

queryControl

relatedPropertyInfo

relatedProperty