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 |
| 資料夾 | 文件 |
相關主題