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.

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 regroupée et épinglée comme si elle faisait partie du processus qui le possède. Pour plus d’informations sur l’application d’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 des applications ou des fenêtres qui souhaitent fournir des informations de relance non par défaut.

Note

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 de ces propriétés n’est utilisée.

 

Cette propriété, ainsi que System.AppUserModel.RelaunchDisplayNameResource et System.AppUserModel.RelaunchIconResource peuvent être utilisés pour définir visuellement une fenêtre en tant qu’application à l’utilisateur. Cela est utile pour les scénarios d’application hôte, où une seule instance hôte 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 à l’utilisateur. La machine virtuelle peut étiqueter chaque fenêtre avec un AppUserModelID explicite et les propriétés de relance appropriées pour les rendre visibles en tant qu’applications. L’utilisateur peut ensuite les épingler à la barre des tâches et « relancer » l’instance épinglée.

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, puis utilisez les méthodes de cet objet IPropertyStore 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

Remarques

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

énumération

énumération

énumération

image

drawControl

editControl

filterControl

queryControl

relatedPropertyInfo

relatedProperty

 

 

  • Last updated on