System.AppUserModel.RelaunchCommand

  • 项目

指定一个命令，该命令可通过 ShellExecute 执行，以在应用程序固定到任务栏或通过应用程序的跳转列表启动应用程序的新实例时启动该应用程序。

这方面的例子有：

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

virtualhost.exe /virtualapp:12345

notepad.exe

仅当窗口具有通过 SHGetPropertyStoreForWindow) 设置的 appUserModelID) (System.AppUserModel.ID 显式应用程序用户模型 ID (时，才使用此属性。 如果窗口没有显式的 AppUserModelID，则忽略此属性，并将窗口分组和固定，就像它是拥有它的进程的一部分一样。 有关显式 AppUserModelID 的应用及其对任务栏固定的影响的详细信息，请参阅 应用程序用户模型 ID (AppUserModelIDs) 。

此属性旨在供希望提供非默认重新启动信息的应用程序或窗口使用。

注意

System.AppUserModel.RelaunchCommand 和 System.AppUserModel.RelaunchDisplayNameResource 必须始终设置在一起。 如果未设置其中一个属性，则两者都不使用。

 

此属性与 System.AppUserModel.RelaunchDisplayNameResource 和 System.AppUserModel.RelaunchIconResource 一起可用于直观地将窗口定义为用户的应用程序。 这对于主机应用程序方案非常有用，其中单个主机实例运行多个子应用程序。 例如，托管多个虚拟化应用程序的虚拟机可能希望这些虚拟化应用程序向用户显示为单个应用程序。 虚拟机可以使用显式 AppUserModelID 和相应的重新启动属性来标记每个窗口，使其显示为应用程序。 然后，用户可以将它们固定到任务栏并“重新启动”固定的实例。

注意

如果设置了 System.AppUserModel.PreventPinning ，则忽略此属性。 这使应用程序可以通过为窗口分配显式 AppUserModelID 来控制其窗口的分组，但阻止这些窗口被固定。

 

若要在窗口上设置此属性，请使用 SHGetPropertyStoreForWindow 检索窗口的属性存储，并使用检索到的 IPropertyStore 对象的方法设置该窗口的 System.AppUserModel.RelaunchCommand 属性。

Windows 10，版本 1703、Windows 10、版本 1607、Windows 10、版本 1511、Windows 10、版本 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

备注

PKEY 值在 Propkey.h 中定义。

应用程序用户模型 ID (AppUserModelIDs)

System.AppUserModel.ID

propertyDescriptionList

propertyDescription

searchInfo

labelInfo

typeInfo

displayInfo

aliasInfo

stringFormat

booleanFormat

numberFormat

dateTimeFormat

enumeratedList

enum

enumRange

图像

drawControl

editControl

filterControl

queryControl

relatedPropertyInfo

relatedProperty