Compartir a través de

System.ItemNameDisplay

  • Artículo

Nombre para mostrar en el formulario "más completo". Es la representación única del nombre del elemento más adecuado para los usuarios finales.

Windows 10, versión 1703, Windows 10, versión 1607, Windows 10, versión 1511, Windows 10, versión 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

Comentarios

Los valores PKEY se definen en Propkey.h.

Este valor es la concatentación de System.ItemNamePrefix y System.ItemName.

Si el elemento es un archivo, esta propiedad incluye el nombre para mostrar como se muestra en Explorador de archivos. Hay casos aceptables cuando se da System.FileName , pero el valor de esta propiedad es completamente diferente. Los mensajes de correo electrónico son un buen ejemplo. Si el elemento es un mensaje de correo electrónico, el nombre del elemento suele ser el asunto. En ese caso, el valor debe ser la concatenación de System.ItemNamePrefix y System.ItemName. Dado que el valor de System.ItemNamePrefix excluye los espacios finales, la concatenación debe incluir un espacio al generar System.ItemNameDisplay. Tenga en cuenta que no se garantiza que esta propiedad sea única, pero está diseñada para promover el candidato más probable que puede ser único y también tiene sentido para los usuarios finales.

Por ejemplo, en el caso de los documentos, System.Title podría usarse como System.ItemNameDisplay, pero en la práctica, el título de los documentos puede no ser útil o lo suficientemente único como para funcionar como system.ItemNameDisplay único. En su lugar, proporcionar System.FileName como valor de System.ItemNameDisplay es una mejor opción. En Windows Mail, el correo electrónico se almacena en el sistema de archivos como archivos .eml. Los valores System.FileName de esos archivos no son descriptivos para el usuario, ya que son GUID. En este ejemplo, promover System.Subject como System.ItemNameDisplay tiene más sentido.

Notas de compatibilidad:

  • Implementaciones de carpetas de Shell en Windows Vista: use PKEY_ItemNameDisplay para la columna de nombre cuando desee que el Explorador de Windows llame a IShellFolder::GetDisplayNameOf(SHGDN_NORMAL) para obtener el valor del nombre. Usa otro PKEY, como PKEY_ItemName, cuando quieras que el Explorador de Windows llame al almacén de propiedades de la carpeta o a IShellFolder2::GetDetailsEx para obtener el valor del nombre.
  • Implementaciones de carpetas de Shell en Windows XP: la primera columna debe ser la columna de nombre y el Explorador de Windows llama a IShellFolder::GetDisplayNameOf para obtener el valor del nombre. El PKEY/SCID no importa.
Tipo de elemento Ejemplo
Archivo hello.txt
Message Re: ¿Dónde está la reunión?
Carpeta del dispositivo song.wma
Carpeta Documentos

 

propertyDescription

searchInfo

labelInfo

typeInfo

displayInfo

stringFormat

booleanFormat

numberFormat

dateTimeFormat

enumeratedList

drawControl

editControl

filterControl

queryControl