System.AppUserModel.RelaunchIconResource

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

  • 标准资源格式,如“%systemdir%\system32\shell32.dll,-128”。 需要资源 ID 之前的“-”字符。 不要在路径字符串的前面使用“@”字符。
  • 指向图标文件的直接路径,例如“%programfiles%\Microsoft\记事本\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

布尔Format

numberFormat

dateTimeFormat

enumeratedList

枚举

enumRange

图像

drawControl

editControl

filterControl

queryControl

relatedPropertyInfo

relatedProperty