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 邮件中,电子邮件以 .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