System.ItemNameDisplay

Nome visualizzato nel modulo "più completo". È la rappresentazione univoca del nome dell'elemento più appropriato per gli utenti finali.

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

Commenti

I valori PKEY sono definiti in Propkey.h.

Questo valore è la concatenazione di System.ItemNamePrefix e System.ItemName.

Se l'elemento è un file, questa proprietà include il nome visualizzato, come illustrato in Esplora file. Esistono casi accettabili quando System.FileName viene assegnato, ma il valore di questa proprietà è completamente diverso. I messaggi di posta elettronica sono un buon esempio. Se l'elemento è un messaggio di posta elettronica, il nome dell'elemento è in genere l'oggetto. In tal caso, il valore deve essere la concatenazione di System.ItemNamePrefix e System.ItemName. Poiché il valore di System.ItemNamePrefix esclude tutti gli spazi finali, la concatenazione deve includere uno spazio durante la generazione di System.ItemNameDisplay. Si noti che questa proprietà non è sicuramente univoca, ma è progettata per promuovere il candidato più probabile che può essere univoco e ha anche senso per gli utenti finali.

Ad esempio, per i documenti, è possibile usare System.Title come System.ItemNameDisplay, ma in pratica il titolo dei documenti potrebbe non essere utile o univoco sufficiente per funzionare come unico System.ItemNameDisplay. È invece preferibile specificare System.FileName come valore di System.ItemNameDisplay. In Windows Mail, il messaggio di posta elettronica viene archiviato nel file system come file con estensione eml. I valori System.FileName per tali file non sono descrittivi perché sono GUID. In questo esempio, la promozione di System.Subject come System.ItemNameDisplay ha più senso.

Note di compatibilità:

  • Implementazioni della cartella della shell in Windows Vista: usare PKEY_ItemNameDisplay per la colonna del nome quando si vuole che Esplora risorse chiami IShellFolder::GetDisplayNameOf(SHGDN_NORMAL) per ottenere il valore del nome. Usa un altro PKEY, ad esempio PKEY_ItemName, quando vuoi che Esplora risorse chiami l'archivio delle proprietà della cartella o IShellFolder2::GetDetailsEx per ottenere il valore del nome.
  • Implementazioni della cartella della shell in Windows XP: la prima colonna deve essere la colonna del nome e Esplora risorse chiama IShellFolder::GetDisplayNameOf per ottenere il valore del nome. PKEY/SCID non è importante.
Tipo di elemento Esempio
File hello.txt
Message Re: Dov'è la riunione?
Cartella del dispositivo song.wma
Cartella Documenti

 

propertyDescription

searchInfo

labelInfo

Typeinfo

displayInfo

Stringformat

booleanFormat

numberFormat

Datetimeformat

enumeratedList

drawControl

editControl

filterControl

queryControl