Share via

System.AppUserModel.RelaunchDisplayNameResource

  • 發行項

指定當使用者選擇將應用程式釘選到工作列時，用於工作列上建立之快捷方式的顯示名稱，或透過其按鈕的 [跳躍清單] 啟動新的實例。 此屬性的值必須是下列其中一項：

  • 間接資源字串，例如 「@%systemdir%\system32\shell32.dll，-19263」。 請注意，必須有 '@' 字元，才能區分間接字串與純文字字串， (下一個點符段落中所述) 。 這個間接字串包含二進位檔，以及該二進位檔中包含的字串資源識別碼。 強烈建議您使用這個間接字串表單，以確保當系統語言透過多語系使用者介面 (MUI) 變更時，顯示名稱會適當地變更。 需要資源識別碼之前的 '-' 字元。
  • 未指向資源的純文字字串。 只有在動態計算或從不支援 MUI 的資料來源取得顯示名稱時，才應該使用此功能。 例如，字串可能是裝置的名稱，例如 「Microsoft Zune」，在此情況下，當該應用程式附加至電腦時會出現。

注意

System.AppUserModel.RelaunchCommand 和 System.AppUserModel.RelaunchDisplayNameResource 必須一律設定在一起。 如果未設定其中一個屬性，則不會使用這兩個屬性。

 

只有當視窗具有明確的應用程式使用者模型識別碼 (AppUserModelID) (System.AppUserModel.ID時，才會使用這個屬性，並透過 SHGetPropertyStoreForWindow) 設定。 如果視窗沒有明確的 AppUserModelID，則會忽略這個屬性，而且視窗會分組並釘選，就像是擁有它的進程一部分一樣。 如需明確 AppUserModelID 的應用程式及其對工作列釘選效果的詳細資訊，請參閱 應用程式使用者模型識別碼 (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 中。

應用程式使用者模型識別碼 (AppUserModelIDs)

System.AppUserModel.ID

propertyDescriptionList

propertyDescription

searchInfo

labelInfo

typeInfo

displayInfo

aliasInfo

stringFormat

booleanFormat

numberFormat

dateTimeFormat

enumeratedList

enum

enumRange

image

drawControl

editControl

filterControl

queryControl

relatedPropertyInfo

relatedProperty