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 邮件中,电子邮件以 .eml 文件的形式存储在文件系统中。 这些文件的 System.FileName 值不友好,因为它们是 GUID。 在此示例中,将 System.Subject 提升为 System.ItemNameDisplay 更有意义。
兼容性说明:
- Windows Vista 上的 Shell 文件夹实现:如果希望 Windows 资源管理器调用 IShellFolder::GetDisplayNameOf (SHGDN_NORMAL) 以获取名称的值,请使用名称列的PKEY_ItemNameDisplay。 如果希望 Windows 资源管理器调用文件夹的属性存储区或 IShellFolder2::GetDetailsEx 来获取名称的值,请使用另一个 PKEY,例如PKEY_ItemName。
- Windows XP 上的 Shell 文件夹实现:第一列必须是名称列,Windows 资源管理器调用 IShellFolder::GetDisplayNameOf 以获取名称的值。 PKEY/SCID 并不重要。
项目类型 | 示例 |
---|---|
文件 | hello.txt |
消息 | 重新:会议在哪里? |
设备文件夹 | song.wma |
文件夹 | 文档 |
相关主题