System.ItemNameDisplay

  • Artikel

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

 

propertyDescription

searchInfo

labelInfo

Typeinfo

displayInfo

Stringformat

booleanFormat

Numberformat

dateTimeFormat

enumeratedList

drawControl

editControl

filterControl

queryControl