Freigeben über


System.AppUserModel.RelaunchCommand

Gibt einen Befehl an, der über ShellExecute ausgeführt werden kann, um eine Anwendung zu starten, wenn sie an die Taskleiste angeheftet ist oder wenn ein neuer instance der Anwendung über die Sprungliste der Anwendung gestartet wird.

Einige Beispiele dafür sind:

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

virtualhost.exe /virtualapp:12345

notepad.exe

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 keine explizite AppUserModelID aufweist, wird diese Eigenschaft ignoriert, und das Fenster wird gruppiert und angeheftet, als ob es Teil des Prozesses wäre, 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.

Hinweis

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

 

Diese Eigenschaft kann zusammen mit System.AppUserModel.RelaunchDisplayNameResource und System.AppUserModel.RelaunchIconResource verwendet werden, um ein Fenster visuell als Anwendung für den Benutzer zu definieren. Dies ist nützlich für Hostanwendungsszenarien, in denen ein einzelner Host instance mehrere untergeordnete Anwendungen ausführt. Für einen virtuellen Computer, der mehrere virtualisierte Anwendungen hostet, kann es beispielsweise sein, dass diese virtualisierten Anwendungen als einzelne Anwendungen für den Benutzer angezeigt werden. Der virtuelle Computer könnte jedes Fenster mit einer expliziten AppUserModelID und den entsprechenden Neustarteigenschaften bezeichnen, damit sie als Anwendungen angezeigt werden. Der Benutzer kann sie dann an die Taskleiste anheften und die angeheftete instance erneut starten.

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

enumeratedList

enum

enumRange

image

drawControl

editControl

filterControl

queryControl

relatedPropertyInfo

relatedProperty