Share via

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.ItemNamePrefix 和 System.ItemName的串連。

如果專案是檔案，此屬性會包含顯示名稱，如檔案總管所示。 系統提供 System.FileName 但此屬性的值完全不同時，有可接受的情況。 電子郵件訊息是不錯的範例。 如果專案是電子郵件訊息，則專案名稱通常是主旨。 在此情況下，此值必須是 System.ItemNamePrefix 和 System.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