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 wird oder wenn eine neue Instanz der Anwendung über die Sprungliste der Anwendung gestartet wird.

Beispiele hierfü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) (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.

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 kann zusammen mit System.AppUserModel.RelaunchDisplayNameResource und System.AppUserModel.RelaunchIconResource verwendet werden, um ein Fenster als Anwendung für den Benutzer visuell zu definieren. Dies ist nützlich für Hostanwendungsszenarien, in denen eine einzelne Hostinstanz mehrere untergeordnete Anwendungen ausführt. Beispielsweise soll ein virtueller Computer, auf dem mehrere virtualisierte Anwendungen gehostet werden, diese virtualisierten Anwendungen für den Benutzer als einzelne Anwendungen angezeigt werden. Der virtuelle Computer kann jedes Fenster mit einer expliziten AppUserModelID und den entsprechenden Relauncheigenschaften bezeichnen, damit sie als Anwendungen angezeigt werden. Der Benutzer könnte sie dann an die Taskleiste anheften und die angeheftete Instanz "neu starten".

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.

 

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 das 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-

aufgezählte Liste

Enumeration

enumRange

Bild

drawControl-

editControl-

filterControl-

queryControl-

relatedPropertyInfo-

relatedProperty-