System.ItemNameDisplay

Nazwa wyświetlana w formularzu "najbardziej kompletnym". Jest to unikatowa reprezentacja nazwy elementu najbardziej odpowiednia dla użytkowników końcowych.

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

Uwagi

Wartości PKEY są definiowane w pliku Propkey.h.

Ta wartość jest połączeniem System.ItemNamePrefix i System.ItemName.

Jeśli element jest plikiem, ta właściwość zawiera nazwę wyświetlaną, jak pokazano w Eksploratorze plików. Istnieją dopuszczalne przypadki, gdy System.FileName jest podana, ale wartość tej właściwości jest zupełnie inna. Wiadomości e-mail są dobrym przykładem. Jeśli element jest wiadomością e-mail, nazwa elementu jest zwykle tematem. W takim przypadku wartość musi być łączeniem System.ItemNamePrefix i System.ItemName. Ponieważ wartość Elementu System.ItemNamePrefix wyklucza wszystkie spacje końcowe, łączenie musi zawierać miejsce podczas generowania System.ItemNameDisplay. Należy pamiętać, że ta właściwość nie ma gwarancji, że jest unikatowa, ale jest przeznaczona do promowania najbardziej prawdopodobnego kandydata, który może być unikatowy, a także ma sens dla użytkowników końcowych.

Na przykład w przypadku dokumentów System.Title można użyć jako System.ItemNameDisplay, ale w praktyce tytuł dokumentów może nie być przydatny lub wystarczająco unikatowy, aby działał jako jedyny element System.ItemNameDisplay. Zamiast tego podaj System.FileName, ponieważ wartość System.ItemNameDisplay jest lepszym wyborem. W programie Poczta systemu Windows poczta e-mail jest przechowywana w systemie plików jako pliki .eml. Wartości System.FileName dla tych plików nie są przyjazne dla człowieka, ponieważ są to identyfikatory GUID. W tym przykładzie promowanie System.Subject jak System.ItemNameDisplay ma większe znaczenie.

Uwagi dotyczące zgodności :

• Implementacje folderów powłoki w systemie Windows Vista: użyj PKEY_ItemNameDisplay dla kolumny nazwy, gdy chcesz, aby Eksplorator Windows wywoływać IShellFolder::GetDisplayNameOf(SHGDN_NORMAL), aby uzyskać wartość nazwy. Użyj innego klucza PKEY, takiego jak PKEY_ItemName, jeśli chcesz, aby Eksplorator Windows wywołał magazyn właściwości folderu lub IShellFolder2::GetDetailsEx, aby uzyskać wartość nazwy.
• Implementacje folderów powłoki w systemie Windows XP: pierwsza kolumna musi być kolumną nazwy, a Eksplorator Windows wywołuje IShellFolder::GetDisplayNameOf, aby uzyskać wartość nazwy. PKEY/SCID nie ma znaczenia.

Tematy pokrewne

propertyDescription

searchInfo

labelInfo

typeInfo

displayInfo

stringFormat

wartość logicznaFormat

numberFormat

dateTimeFormat

wyliczanalista

drawControl

editControl

filterControl

queryControl