System.ItemNameDisplay

  • Article

Nom complet au format « le plus complet ». Il s’agit de la représentation unique du nom d’élément le plus approprié pour les utilisateurs finaux.

Windows 10, version 1703, Windows 10, version 1607, Windows 10, version 1511, Windows 10, version 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

Notes

Les valeurs PKEY sont définies dans Propkey.h.

Cette valeur est la concatentation de System.ItemNamePrefix et System.ItemName.

Si l’élément est un fichier, cette propriété inclut le nom d’affichage tel qu’indiqué dans Explorateur de fichiers. Il existe des cas acceptables où System.FileName est donné, mais la valeur de cette propriété est complètement différente. Les messages électroniques en sont un bon exemple. Si l’élément est un message électronique, le nom de l’élément est normalement l’objet. Dans ce cas, la valeur doit être la concaténation de System.ItemNamePrefix et System.ItemName. Étant donné que la valeur de System.ItemNamePrefix exclut les espaces de fin, la concaténation doit inclure un espace lors de la génération de System.ItemNameDisplay. Notez que cette propriété n’est pas garantie d’être unique, mais qu’elle est conçue pour promouvoir le candidat le plus probable qui peut être unique et qui a également un sens pour les utilisateurs finaux.

Par exemple, pour les documents, system.Title peut être utilisé en tant que System.ItemNameDisplay, mais dans la pratique, le titre des documents peut ne pas être suffisamment utile ou unique pour fonctionner comme le seul System.ItemNameDisplay. Au lieu de cela, fournir System.FileName comme valeur de System.ItemNameDisplay est un meilleur choix. Dans Windows Mail, le courrier électronique est stocké dans le système de fichiers en tant que fichiers .eml. Les valeurs System.FileName de ces fichiers ne sont pas conviviales, car il s’agit de GUID. Dans cet exemple, il est plus logique de promouvoir System.Subject en tant que System.ItemNameDisplay.

Notes de compatibilité :

  • Implémentations de dossiers d’interpréteur de commandes sur Windows Vista : utilisez PKEY_ItemNameDisplay pour la colonne name lorsque vous souhaitez que Windows Explorer appelle IShellFolder::GetDisplayNameOf(SHGDN_NORMAL) pour obtenir la valeur du nom. Utilisez une autre PKEY, telle que PKEY_ItemName, lorsque vous souhaitez que Windows Explorer appelle le magasin de propriétés du dossier ou IShellFolder2::GetDetailsEx pour obtenir la valeur du nom.
  • Implémentations de dossiers shell sur Windows XP : la première colonne doit être la colonne name, et Windows Explorer appelle IShellFolder::GetDisplayNameOf pour obtenir la valeur du nom. Le PKEY/SCID n’a pas d’importance.
Type d'élément Exemple
Fichier hello.txt
Message Re : Où se trouve la réunion ?
Dossier de l’appareil song.wma
Dossier Documents

 

propertyDescription

searchInfo

labelInfo

typeInfo

displayInfo

stringFormat

booleanFormat

numberFormat

dateTimeFormat

enumeratedList

drawControl

editControl

filterControl

queryControl