System.AppUserModel.RelaunchIconResource

  • 项目

指定当用户选择将应用程序固定到任务栏或通过其按钮的跳转列表启动新实例时，用于在任务栏上创建的快捷方式的图标。 这是用于任务栏组的图标，对于固定的应用程序，无论该应用程序是否正在运行，都将显示此图标。 应使用以下格式之一指定此项：

  • 标准资源格式，例如“%systemdir%\system32\shell32.dll，-128”。 资源 ID 前的“-”字符是必需的。 不要在路径字符串的前面使用“@”字符。
  • 图标文件的直接路径，例如“%programfiles%\Microsoft\Notepad\Notepad.ico，0”。 请注意，由于 .ico 文件可以包含多个图标资源，因此字符串中需要资源 ID。 如果 .ico 文件是单个映像，请使用“0” (不使用“-”字符) 作为资源 ID。

System.AppUserModel.RelaunchIconResource 是一个可选属性。 如果未设置，则使用重新启动命令的目标图标 (System.AppUserModel.RelaunchCommand) 。 但是，由于这可能会导致意外的结果，我们强烈建议你通过此属性显式提供图标。

仅当窗口具有显式应用程序用户模型 ID (AppUserModelID) (System.AppUserModel.ID（通过 SHGetPropertyStoreForWindow) 设置）时才使用此属性。 如果窗口没有显式 AppUserModelID (System.AppUserModel.ID) ，则忽略此属性，并将窗口分组和固定，就像它是其所属进程的一部分一样。 有关显式 AppUserModelID 的应用及其对任务栏固定的影响的详细信息，请参阅 应用程序用户模型 ID (AppUserModelIDs) 。 此属性旨在供希望提供非默认重新启动信息的应用程序或窗口使用。 有关详细信息，请参阅 System.AppUserModel.RelaunchCommand。

如果在窗口上设置了显式 AppUserModelID，但未设置此属性，系统会尝试查找具有相同 AppUserModelID 的快捷方式，并将该快捷方式固定到任务栏以表示窗口。 如果找不到此类快捷方式，则使用拥有它的进程的后备可执行文件。

注意

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

 

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

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

应用程序用户模型 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