Compartir a través de


System.ItemNameDisplay

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

Observaciones

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 el 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, para los documentos, el 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 para funcionar como system.ItemNameDisplay. 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 humanos, ya que son GUID. En este ejemplo, promover System.Subject como System.ItemNameDisplay tiene más sentido.

Notas de compatibilidad de :

  • Implementaciones de carpetas de Shell en Windows Vista: use PKEY_ItemNameDisplay para la columna name cuando quiera 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 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
Mensaje 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