Freigeben über


System.AppUserModel.RelaunchIconResource

Gibt das Symbol an, das für die auf der Taskleiste erstellte Verknüpfung verwendet wird, wenn der Benutzer eine Anwendung an die Taskleiste anheftet oder eine neue instance über die Sprungliste der Schaltfläche startet. Dies ist das Symbol, das für die Taskleistengruppe verwendet wird und für eine angeheftete Anwendung angezeigt wird, unabhängig davon, ob diese Anwendung ausgeführt wird oder nicht. Dies sollte in einem der folgenden Formate angegeben werden:

  • Standardressourcenformat, z. B. "%systemdir%\system32\shell32.dll,-128". Das Zeichen "-" vor der Ressourcen-ID ist erforderlich. Verwenden Sie nicht das Zeichen "@" an der Vorderseite der Pfadzeichenfolge.
  • Direkter Pfad zu einer Symboldatei, z. B. "%programfiles%\Microsoft\Notepad\Notepad.ico,0". Beachten Sie, dass eine Ressourcen-ID in der Zeichenfolge erforderlich ist, da ICO-Dateien mehrere Symbolressourcen enthalten können. Wenn die ICO-Datei ein einzelnes Bild ist, verwenden Sie "0" (ohne das Zeichen "-") als Ressourcen-ID.

System.AppUserModel.RelaunchIconResource ist eine optionale Eigenschaft. Wenn es nicht festgelegt ist, wird das Symbol des Ziels des Neustartbefehls (System.AppUserModel.RelaunchCommand) verwendet. Da dies jedoch zu unerwünschten Ergebnissen führen kann, empfehlen wir Ihnen dringend, ein Symbol explizit über diese Eigenschaft anzugeben.

Diese Eigenschaft wird nur verwendet, wenn ein Fenster über eine explizite Anwendungsbenutzermodell-ID (AppUserModelID) verfügt (System.AppUserModel.ID, festgelegt über SHGetPropertyStoreForWindow). Wenn das Fenster nicht über eine explizite AppUserModelID (System.AppUserModel.ID) verfügt, wird diese Eigenschaft ignoriert, und das Fenster wird gruppiert und angeheftet, als ob es Teil seines Besitzprozesses wäre. 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.

Wenn im Fenster eine explizite AppUserModelID festgelegt ist, diese Eigenschaft jedoch nicht festgelegt ist, versucht das System, eine Verknüpfung mit derselben AppUserModelID zu finden, und setzt diese Verknüpfung an die Taskleiste an, um das Fenster darzustellen. Wenn keine solche Verknüpfung gefunden werden kann, wird die unterstützende ausführbare Datei des Prozesses verwendet, der sie besitzt.

Hinweis

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

 

Um diese Eigenschaft für ein Fenster festzulegen, verwenden Sie SHGetPropertyStoreForWindow , um den Eigenschaftenspeicher des Fensters abzurufen, und verwenden Sie die Methoden des abgerufenen IPropertyStore-Objekts , um die System.AppUserModel.RelaunchIconResource-Eigenschaft dieses Fensters festzulegen.

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

Anwendungsbenutzermodell-IDs (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