System.AppUserModel.RelaunchCommand

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

示例包括:

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

virtualhost.exe /virtualapp:12345

notepad.exe

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

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

注意

System.AppUserModel.RelaunchCommandSystem.AppUserModel.RelaunchDisplayNameResource 必须始终设置在一起。 如果未设置其中一个属性,则不会使用这两个属性。

 

此属性与 System.AppUserModel.RelaunchDisplayNameResourceSystem.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

布尔Format

numberFormat

dateTimeFormat

enumeratedList

枚举

enumRange

图像

drawControl

editControl

filterControl

queryControl

relatedPropertyInfo

relatedProperty