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: используйте PKEY_ItemNameDisplay в столбце имен, если требуется, чтобы Обозреватель Windows вызывали IShellFolder::GetDisplayNameOf(SHGDN_NORMAL), чтобы получить значение имени. Используйте другой ключ PKEY, например PKEY_ItemName, чтобы windows Обозреватель вызывали хранилище свойств папки или IShellFolder2::GetDetailsEx, чтобы получить значение имени.
  • Реализации папок оболочки в Windows XP: первый столбец должен быть столбцом имени, а Windows Обозреватель вызывает IShellFolder::GetDisplayNameOf, чтобы получить значение имени. PKEY/SCID не имеет значения.
Тип элемента Пример
File hello.txt
Сообщение Re: Где находится собрание?
Папка устройства song.wma
Папка Документы

 

PropertyDescription

searchInfo

labelInfo

Typeinfo

displayInfo

Stringformat

booleanFormat

numberFormat

dateTimeFormat

enumeratedList

drawControl

editControl

filterControl

queryControl