System.ItemNameDisplay
Der Anzeigename in "vollständigster" Form. Dies ist die eindeutige Darstellung des Elementnamens, der für Endbenutzer am besten geeignet ist.
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
Bemerkungen
PKEY-Werte werden in Propkey.h definiert.
Dieser Wert ist die Verkettung von System.ItemNamePrefix und System.ItemName.
Wenn es sich bei dem Element um eine Datei handelt, enthält diese Eigenschaft den Anzeigenamen, wie in Explorer dargestellt. Es gibt akzeptable Fälle, in denen System.FileName angegeben wird, der Wert dieser Eigenschaft jedoch völlig anders ist. E-Mail-Nachrichten sind ein gutes Beispiel. Wenn es sich bei dem Element um eine E-Mail-Nachricht handelt, ist der Elementname normalerweise der Betreff. In diesem Fall muss der Wert die Verkettung von System.ItemNamePrefix und System.ItemName sein. Da der Wert von System.ItemNamePrefix nachgestellte Leerzeichen ausschließt, muss die Verkettung beim Generieren von System.ItemNameDisplay ein Leerzeichen enthalten. Beachten Sie, dass diese Eigenschaft nicht garantiert eindeutig ist, sondern darauf ausgelegt ist, den wahrscheinlichsten Kandidaten zu bewerben, der eindeutig sein kann und auch für Endbenutzer sinnvoll ist.
Für Dokumente könnte system.Title beispielsweise als System.ItemNameDisplay verwendet werden, aber in der Praxis ist der Titel der Dokumente möglicherweise nicht nützlich oder eindeutig genug, um als einziges System.ItemNameDisplay zu fungieren. Stattdessen ist die Angabe von System.FileName als Wert von System.ItemNameDisplay eine bessere Wahl. In Windows Mail wird E-Mail im Dateisystem als EML-Dateien gespeichert. Die System.FileName-Werte für diese Dateien sind nicht benutzerfreundlich, da es sich um GUIDs handelt. In diesem Beispiel ist das Höherstufen von System.Subject als System.ItemNameDisplay sinnvoller.
Kompatibilitätshinweise:
- Shellordnerimplementierungen unter Windows Vista: Verwenden Sie PKEY_ItemNameDisplay für die Namensspalte, wenn Windows Explorer IShellFolder::GetDisplayNameOf(SHGDN_NORMAL) aufrufen soll, um den Wert des Namens abzurufen. Verwenden Sie einen anderen PKEY, z. B. PKEY_ItemName, wenn Windows Explorer entweder den Eigenschaftenspeicher des Ordners oder IShellFolder2::GetDetailsEx aufrufen soll, um den Wert des Namens abzurufen.
- Shellordnerimplementierungen unter Windows XP: Die erste Spalte muss die Namensspalte sein, und Windows Explorer ruft IShellFolder::GetDisplayNameOf auf, um den Wert des Namens abzurufen. Die PKEY/SCID spielt keine Rolle.
| Elementtyp | Beispiel |
|---|---|
| Datei | hello.txt |
| Nachricht | Re: Wo ist die Besprechung? |
| Geräteordner | song.wma |
| Ordner | Dokumente |
Zugehörige Themen