Condividi tramite


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

Osservazioni

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, il system.title può essere usato come System.ItemNameDisplay, ma in pratica il titolo dei documenti potrebbe non essere utile o univoco sufficiente per funzionare come unico System.ItemNameDisplay. In alternativa, fornire System.FileName come valore di System.ItemNameDisplay è una scelta migliore. In Windows Mail la posta elettronica viene archiviata nel file system come file .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 sulla compatibilità :

  • Implementazioni delle cartelle della shell in Windows Vista: usare PKEY_ItemNameDisplay per la colonna del nome quando si vuole che Esplora risorse di Windows 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 delle cartelle della shell in Windows XP: la prima colonna deve essere la colonna name e Esplora risorse chiama IShellFolder::GetDisplayNameOf per ottenere il valore del nome. PKEY/SCID non è importante.
Tipo di elemento Esempio
File hello.txt
Messaggio Re: Dov'è la riunione?
Cartella del dispositivo song.wma
Cartella Documenti

 

propertyDescription

searchInfo

labelInfo

typeInfo

displayInfo

stringFormat

booleanFormat

numberFormat

dateTimeFormat

enumeratoList

drawControl

editControl

filterControl

queryControl