Partager via


System.ItemNameDisplay

Nom complet dans le formulaire « 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

Remarques

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

Cette valeur est la concaténtation de System.ItemNamePrefix et System.ItemName.

Si l’élément est un fichier, cette propriété inclut le nom complet, comme indiqué dans l’Explorateur de fichiers. Il existe des cas acceptables lorsque System.FileName est donné, mais que la valeur de cette propriété est complètement différente. Les messages électroniques 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 d'System.ItemNameDisplay. Notez que cette propriété n’est pas garantie d’être unique, mais est conçue pour promouvoir le candidat le plus probable qui peut être unique et qui est également logique pour les utilisateurs finaux.

Par exemple, pour les documents, le System.Title peut être utilisé comme System.ItemNameDisplay, mais dans la pratique, le titre des documents peut ne pas être utile ou assez unique pour fonctionner comme 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 sous forme de fichiers .eml. Les valeurs System.FileName pour ces fichiers ne sont pas conviviales car elles sont des GUID. Dans cet exemple, la promotion de System.Subject comme System.ItemNameDisplay est plus logique.

notes de compatibilité :

  • Implémentations de dossiers shell sur Windows Vista : utilisez PKEY_ItemNameDisplay pour la colonne nom lorsque vous souhaitez que l’Explorateur Windows appelle IShellFolder ::GetDisplayNameOf(SHGDN_NORMAL) pour obtenir la valeur du nom. Utilisez une autre clé PKEY, telle que PKEY_ItemName, lorsque vous souhaitez que l’Explorateur Windows 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 de nom et l’Explorateur Windows appelle IShellFolder ::GetDisplayNameOf pour obtenir la valeur du nom. Le PKEY/SCID n’a pas d’importance.
Type d’élément Exemple
Lime 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

énumération

drawControl

editControl

filterControl

queryControl