System.AppUserModel.RelaunchDisplayNameResource

  • 项目

指定当用户选择将应用程序固定到任务栏或通过其按钮的跳转列表启动新实例时，用于在任务栏上创建的快捷方式的显示名称。 此属性的值必须是下列值之一：

  • 间接资源字符串，例如“@%systemdir%\system32\shell32.dll，-19263”。 请注意，需要“@”字符才能将间接字符串与纯文本字符串区分开来， (下一个项目符号段落) 中所述。 此间接字符串由二进制文件和该二进制文件中包含的字符串的资源 ID 组成。 强烈建议使用此间接字符串形式，这可确保在通过多语言用户界面 (MUI) 更改系统语言时显示名称发生相应更改。 需要资源 ID 之前的“-”字符。
  • 不指向资源的纯文本字符串。 仅当动态计算或从不支持 MUI 的数据源获取显示名称时，才应使用此名称。 例如，字符串可以是设备的名称，例如“Microsoft Zune”，如果应用程序在设备连接到计算机时出现。

注意

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

 

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

注意

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

 

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

Windows 10，版本 1703、Windows 10、版本 1607、Windows 10、版本 1511、Windows 10、版本 1507、Windows 8.1、Windows 8、Windows 7

propertyDescription
   name = System.AppUserModel.RelaunchDisplayNameResource
   shellPKey = PKEY_AppUserModel_RelaunchDisplayNameResource
   formatID = 9F4C2855-9F79-4B39-A8D0-E1D42DE1D5F3
   propID = 4
   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