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 |
Argomenti correlati