Partager via


System.AppUserModel.RelaunchDisplayNameResource

Spécifie le nom d’affichage utilisé 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. La valeur de cette propriété doit être l’une des suivantes :

  • Chaîne de ressource indirecte telle que « @%systemdir%\system32\shell32.dll,-19263 ». Notez que le caractère « @ » est requis pour distinguer une chaîne indirecte d’une chaîne de texte brut (décrite dans le paragraphe à puces suivant). Cette chaîne indirecte se compose d’un fichier binaire et d’un ID de ressource de la chaîne contenue dans ce binaire. Nous vous recommandons vivement d’utiliser ce formulaire de chaîne indirecte, qui garantit que le nom d’affichage change correctement lorsque la langue système est modifiée via l’interface utilisateur multilingue (MUI). Caractère « - » avant que l’ID de ressource soit requis.
  • Chaîne de texte brut qui ne pointe pas vers une ressource. Il ne doit être utilisé que lorsque le nom d’affichage est calculé dynamiquement ou obtenu à partir d’une source de données qui ne prend pas en charge l’interface utilisateur unique. Par exemple, la chaîne peut être le nom d’un appareil, tel que « Microsoft Zune », dans les cas où l’application apparaît lorsque cet appareil est attaché à l’ordinateur.

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 n’est utilisée.

 

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 la possède. Pour plus d’informations sur l’application des 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 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.

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 attribuant 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.RelaunchDisplayNameResource 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.RelaunchDisplayNameResource
   shellPKey = PKEY_AppUserModel_RelaunchDisplayNameResource
   formatID = 9F4C2855-9F79-4B39-A8D0-E1D42DE1D5F3
   propID = 4
   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

énumérationListe

enum

enumRange

image

drawControl

editControl

filterControl

queryControl

relatedPropertyInfo

relatedProperty