Freigeben über


System.AppUserModel.RelaunchDisplayNameResource

Gibt den Anzeigenamen an, der für die auf der Taskleiste erstellte Verknüpfung verwendet wird, wenn der Benutzer eine Anwendung an die Taskleiste anheftet oder eine neue Instanz über die Sprungliste der Schaltfläche startet. Der Wert dieser Eigenschaft muss eine der folgenden Sein:

  • Eine indirekte Ressourcenzeichenfolge wie "@%systemdir%\system32\shell32.dll,-19263". Beachten Sie, dass das Zeichen '@' erforderlich ist, um eine indirekte Zeichenfolge von einer Nur-Text-Zeichenfolge zu unterscheiden (beschrieben im nächsten Aufzählungsabsatz). Diese indirekte Zeichenfolge besteht aus einer Binärdatei und einer Ressourcen-ID der Zeichenfolge, die in dieser Binärdatei enthalten ist. Es wird dringend empfohlen, dieses indirekte Zeichenfolgenformular zu verwenden. Dadurch wird sichergestellt, dass sich der Anzeigename entsprechend ändert, wenn die Systemsprache über die Mehrsprachige Benutzeroberfläche (Multilingual User Interface, MUI) geändert wird. Das Zeichen "-", bevor die Ressourcen-ID erforderlich ist.
  • Eine Nur-Text-Zeichenfolge, die nicht auf eine Ressource verweist. Dies sollte nur verwendet werden, wenn der Anzeigename dynamisch berechnet oder aus einer Datenquelle abgerufen wird, die MUI nicht unterstützt. Beispielsweise könnte die Zeichenfolge der Name eines Geräts sein, z. B. "Microsoft Zune", in Fällen, in denen die Anwendung angezeigt wird, wenn dieses Gerät an den Computer angeschlossen ist.

Anmerkung

System.AppUserModel.RelaunchCommand und System.AppUserModel.RelaunchDisplayNameResource müssen immer zusammen festgelegt werden. Wenn eine dieser Eigenschaften nicht festgelegt ist, wird keine dieser Eigenschaften verwendet.

 

Diese Eigenschaft wird nur verwendet, wenn ein Fenster über eine explizite Anwendungsbenutzermodell-ID (AppUserModelID) (System.AppUserModel.ID, festgelegt über SHGetPropertyStoreForWindow) verfügt). Wenn das Fenster nicht über eine explizite AppUserModelID verfügt, wird diese Eigenschaft ignoriert, und das Fenster wird gruppiert und angeheftet, als wäre es Teil des Prozesses, der es besitzt. Weitere Informationen zur Anwendung expliziter AppUserModelIDs und deren Auswirkungen auf das Anheften der Taskleiste finden Sie unter Anwendungsbenutzermodell-IDs (AppUserModelIDs). Diese Eigenschaft soll von Anwendungen oder Fenstern verwendet werden, die nicht standardmäßige Neustartinformationen bereitstellen möchten. Weitere Informationen finden Sie unter System.AppUserModel.RelaunchCommand.

Anmerkung

Diese Eigenschaft wird ignoriert, wenn System.AppUserModel.PreventPinning festgelegt ist. Dadurch kann eine Anwendung die Gruppierung der Fenster steuern, indem sie explizite AppUserModelIDs zuweisen, aber verhindern, dass diese Fenster angeheftet werden.

 

Verwenden Sie zum Festlegen dieser Eigenschaft für ein Fenster SHGetPropertyStoreForWindow, um den Eigenschaftenspeicher des Fensters abzurufen, und verwenden Sie die Methoden, die IPropertyStore Objekt abgerufen wurden, um das System.AppUserModel.RelaunchDisplayNameResource Eigenschaft dieses Fensters festzulegen.

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

Bemerkungen

PKEY-Werte werden in Propkey.h definiert.

Anwendungsbenutzermodell-IDs (AppUserModelIDs)

System.AppUserModel.ID

propertyDescriptionList-

propertyDescription-

searchInfo-

labelInfo-

typeInfo-

displayInfo-

aliasInfo-

stringFormat-

booleanFormat-

numberFormat-

dateTimeFormat-

aufgezählte Liste

Enumeration

enumRange

Bild

drawControl-

editControl-

filterControl-

queryControl-

relatedPropertyInfo-

relatedProperty-