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
文件夹 文档

 

propertyDescription

searchInfo

labelInfo

typeInfo

displayInfo

stringFormat

booleanFormat

numberFormat

dateTimeFormat

enumeratedList

drawControl

editControl

filterControl

queryControl