Bagikan melalui

enumerasi _SHCONTF (shobjidl_core.h)

  • Artikel

Menentukan jenis item yang disertakan dalam enumerasi. Nilai-nilai ini digunakan dengan metode IShellFolder::EnumObjects .

Sintaks

typedef enum _SHCONTF {
  SHCONTF_CHECKING_FOR_CHILDREN = 0x10,
  SHCONTF_FOLDERS = 0x20,
  SHCONTF_NONFOLDERS = 0x40,
  SHCONTF_INCLUDEHIDDEN = 0x80,
  SHCONTF_INIT_ON_FIRST_NEXT = 0x100,
  SHCONTF_NETPRINTERSRCH = 0x200,
  SHCONTF_SHAREABLE = 0x400,
  SHCONTF_STORAGE = 0x800,
  SHCONTF_NAVIGATION_ENUM = 0x1000,
  SHCONTF_FASTITEMS = 0x2000,
  SHCONTF_FLATLIST = 0x4000,
  SHCONTF_ENABLE_ASYNC = 0x8000,
  SHCONTF_INCLUDESUPERHIDDEN = 0x10000
} ;

Konstanta

 
SHCONTF_CHECKING_FOR_CHILDREN
Nilai: 0x10
0x00010. Windows 7 dan yang lebih baru. Aplikasi panggilan sedang memeriksa keberadaan item anak dalam folder.
SHCONTF_FOLDERS
Nilai: 0x20
0x00020. Sertakan item yang merupakan folder dalam enumerasi.
SHCONTF_NONFOLDERS
Nilai: 0x40
0x00040. Sertakan item yang bukan folder dalam enumerasi.
SHCONTF_INCLUDEHIDDEN
Nilai: 0x80
0x00080. Sertakan item tersembunyi dalam enumerasi. Ini tidak termasuk item sistem tersembunyi. (Untuk menyertakan item sistem tersembunyi, gunakan SHCONTF_INCLUDESUPERHIDDEN.)
SHCONTF_INIT_ON_FIRST_NEXT
Nilai: 0x100
0x00100. Tidak lagi digunakan; selalu diasumsikan. IShellFolder::EnumObjects dapat kembali tanpa memvalidasi objek enumerasi. Validasi dapat ditunda hingga panggilan pertama ke IEnumIDList::Next. Gunakan bendera ini saat antarmuka pengguna mungkin ditampilkan sebelum IEnumIDList pertama::Panggilan berikutnya . Agar antarmuka pengguna disajikan, hwnd harus diatur ke handel jendela yang valid.
SHCONTF_NETPRINTERSRCH
Nilai: 0x200
0x00200. Aplikasi panggilan mencari objek printer.
SHCONTF_SHAREABLE
Nilai: 0x400
0x00400. Aplikasi panggilan mencari sumber daya yang dapat dibagikan.
SHCONTF_STORAGE
Nilai: 0x800
0x00800. Sertakan item dengan penyimpanan yang dapat diakses dan leluhurnya, termasuk item tersembunyi.
SHCONTF_NAVIGATION_ENUM
Nilai: 0x1000
0x01000. Windows 7 dan yang lebih baru. Folder anak harus menyediakan enumerasi navigasi.
SHCONTF_FASTITEMS
Nilai: 0x2000
0x02000. Windows Vista dan yang lebih baru. Aplikasi panggilan mencari sumber daya yang dapat dijumlahkan dengan cepat.
SHCONTF_FLATLIST
Nilai: 0x4000
0x04000. Windows Vista dan yang lebih baru. Kedaluwarsa. Jangan gunakan.
SHCONTF_ENABLE_ASYNC
Nilai: 0x8000
0x08000. Windows Vista dan yang lebih baru. Aplikasi panggilan memantau pemberitahuan perubahan. Ini berarti bahwa enumerator tidak harus mengembalikan semua hasil. Item dapat dilaporkan melalui pemberitahuan perubahan.
SHCONTF_INCLUDESUPERHIDDEN
Nilai: 0x10000
0x10000. Windows 7 dan yang lebih baru. Sertakan item sistem tersembunyi dalam enumerasi. Nilai ini tidak termasuk item non-sistem tersembunyi. (Untuk menyertakan item non-sistem tersembunyi, gunakan SHCONTF_INCLUDEHIDDEN.)

Keterangan

Dengan mengatur bendera SHCONTF_INIT_ON_FIRST_NEXT , aplikasi panggilan menyarankan agar metode IShellFolder::EnumObjects dapat mempercepat proses enumerasi dengan mengembalikan objek enumerasi yang tidak diinisialisasi. Inisialisasi dapat ditangguhkan sampai proses enumerasi dimulai. Jika menginisialisasi objek enumerasi adalah proses yang panjang, implementasi metode harus segera mengembalikan objek yang tidak diinisialisasi. Tangguhkan inisialisasi hingga pertama kalinya metode IEnumIDList::Next dipanggil. Jika inisialisasi memerlukan input pengguna, implementasi metode harus menggunakan hwnd sebagai jendela induk untuk antarmuka pengguna. Untuk penjelasan tentang apa yang harus dilakukan ketika hwnd diatur ke NULL, lihat referensi IShellFolder::EnumObjects .

Catatan Nama enumerasi ini diubah menjadi _SHCONTF di Windows Vista. Sebelumnya, itu bernama tagSHCONTF. Untuk kompatibilitas dengan kode warisan, nama SHCONTF didefinisikan melalui pernyataan typedef untuk menjadi sinonim untuk DWORD.
 

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Header shobjidl_core.h (termasuk Shobjidl.h)