共用方式為


System.ItemNameDisplay

「最完整」表單中的顯示名稱。 這是最適合終端使用者的專案名稱唯一標記法。

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

propertyDescription
   name = System.ItemNameDisplay
   shellPKey = PKEY_ItemNameDisplay
   formatID = B725F130-47EF-101A-A5F1-02608C9EEBAC
   propID = 10
   SearchInfo
      InInvertedIndex = true
      IsColumn = true
   typeInfo
      type = String
      IsInnate = true

備註

PKEY 值定義于 Propkey.h 中。

這個值是 System.ItemNamePrefixSystem.ItemName的串連。

如果專案是檔案,此屬性會包含顯示名稱,如檔案總管所示。 系統提供 System.FileName 但此屬性的值完全不同時,有可接受的情況。 電子郵件訊息是不錯的範例。 如果專案是電子郵件訊息,則專案名稱通常是主旨。 在此情況下,此值必須是 System.ItemNamePrefixSystem.ItemName的串連。 由於 System.ItemNamePrefix 的值會排除任何尾端空格,因此串連必須在產生 System.ItemNameDisplay時包含空格。 請注意,此屬性不保證是唯一的,而是設計來提升最可能是唯一且對終端使用者有意義的候選項目。

例如,對於檔, System.Title 可以當做 System.ItemNameDisplay使用,但在實務上,檔的標題可能不夠實用或唯一,足以作為唯一的 System.ItemNameDisplay。 相反地,提供 System.FileName 作為 System.ItemNameDisplay 的值是較佳的選擇。 在 Windows Mail 中,電子郵件會以 .eml 檔案的形式儲存在檔案系統中。 這些檔案的 System.FileName 值不是易記的,因為它們是 GUID。 在此範例中,將 System.Subject 升階為 System.ItemNameDisplay 會更合理。

相容性注意事項:

  • Windows Vista 上的殼層資料夾實作:當您想要 Windows 檔案總管呼叫 IShellFolder::GetDisplayNameOf (SHGDN_NORMAL) 以取得名稱的值時,請使用名稱資料行PKEY_ItemNameDisplay。 當您想要 Windows 檔案總管呼叫資料夾的屬性存放區或 IShellFolder2::GetDetailsEx 以取得名稱的值時,請使用另一個 PKEY,例如 PKEY_ItemName。
  • Windows XP 上的殼層資料夾實作:第一個資料行必須是名稱資料行,而 Windows 檔案總管會呼叫 IShellFolder::GetDisplayNameOf 以取得名稱的值。 PKEY/SCID 並不重要。
項目類型 範例
檔案 hello.txt
訊息 Re:會議在哪裡?
裝置資料夾 song.wma
資料夾 文件

 

propertyDescription

searchInfo

labelInfo

typeInfo

displayInfo

stringFormat

booleanFormat

numberFormat

dateTimeFormat

enumeratedList

drawControl

editControl

filterControl

queryControl