System.ItemNameDisplay

  • Artikel

Nama tampilan dalam formulir "paling lengkap". Ini adalah representasi unik dari nama item yang paling sesuai untuk pengguna akhir.

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

Keterangan

Nilai PKEY ditentukan dalam Propkey.h.

Nilai ini adalah perangkaian System.ItemNamePrefix dan System.ItemName.

Jika item adalah file, properti ini menyertakan nama tampilan seperti yang ditunjukkan dalam File Explorer. Ada kasus yang dapat diterima ketika System.FileName diberikan tetapi nilai properti ini benar-benar berbeda. Pesan email adalah contoh yang baik. Jika item adalah pesan email, nama item biasanya menjadi subjek. Dalam hal ini, nilai harus merupakan perangkaian System.ItemNamePrefix dan System.ItemName. Karena nilai System.ItemNamePrefix mengecualikan spasi berikutnya, perangkaian harus menyertakan spasi saat membuat System.ItemNameDisplay. Perhatikan bahwa properti ini tidak dijamin unik, tetapi dirancang untuk mempromosikan kandidat yang paling mungkin unik dan juga masuk akal bagi pengguna akhir.

Misalnya, untuk dokumen, System.Title dapat digunakan sebagai System.ItemNameDisplay, tetapi dalam praktiknya judul dokumen mungkin tidak berguna atau cukup unik untuk berfungsi sebagai satu-satunya System.ItemNameDisplay. Sebaliknya, menyediakan System.FileName sebagai nilai System.ItemNameDisplay adalah pilihan yang lebih baik. Di Windows Mail, email disimpan dalam sistem file sebagai file .eml. Nilai System.FileName untuk file tersebut tidak ramah manusia karena merupakan GUID. Dalam contoh ini, mempromosikan System.Subject sebagai System.ItemNameDisplay lebih masuk akal.

Catatan kompatibilitas:

  • Implementasi folder Shell di Windows Vista: gunakan PKEY_ItemNameDisplay untuk kolom nama saat Anda ingin Windows Explorer memanggil IShellFolder::GetDisplayNameOf(SHGDN_NORMAL) untuk mendapatkan nilai nama. Gunakan PKEY lain, seperti PKEY_ItemName, saat Anda ingin Windows Explorer memanggil penyimpanan properti folder atau IShellFolder2::GetDetailsEx untuk mendapatkan nilai nama.
  • Implementasi folder Shell pada Windows XP: kolom pertama harus berupa kolom nama, dan Windows Explorer memanggil IShellFolder::GetDisplayNameOf untuk mendapatkan nilai nama. PKEY/SCID tidak masalah.
Tipe item Contoh
File hello.txt
Pesan Re: Di mana rapatnya?
Folder perangkat song.wma
Folder Dokumen

 

propertyDescription

searchInfo

labelInfo

typeInfo

displayInfo

stringFormat

booleanFormat

numberFormat

dateTimeFormat

enumeratedList

drawControl

editKontrol

filterControl

queryControl