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
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 |
Temas relacionados