Bagikan melalui

Antarmuka IACList (shlobj_core.h)

  • Artikel

Mengekspos metode yang meningkatkan efisiensi pelengkapan otomatis ketika string kandidat diatur dalam hierarki.

Warisan

Antarmuka IACList mewarisi dari antarmuka IUnknown . IACList juga memiliki jenis anggota ini:

Metode

Antarmuka IACList memiliki metode ini.

 
IACList::Expand

Meminta klien pelengkapan otomatis menghasilkan string kandidat yang terkait dengan item tertentu di namespace layanannya.

Keterangan

Pelengkapan otomatis biasanya memerlukan tiga komponen berikut:

  • Klien pelengkapan otomatis. Klien ini adalah jendela, seperti kotak dialog, yang menghosting kontrol edit.
  • Objek pelengkapan otomatis (CLSID_AutoComplete). Objek ini disediakan oleh sistem, dan menangani antarmuka pengguna, penguraian, dan manajemen utas latar belakang.
  • Objek daftar pelengkapan otomatis. Objek ini bertanggung jawab untuk memberikan daftar string kandidat ke objek pelengkapan otomatis.
Objek daftar pelengkapan otomatis sederhana hanya perlu mengekspor IEnumString selain IUnknown. Saat pengguna memasukkan karakter dalam kotak edit, objek pelengkapan otomatis memanggil antarmuka IEnumString objek daftar untuk menghitung daftar string yang dapat digunakan untuk menyelesaikan string parsial. Objek daftar mempertahankan namespace layanan dan memutuskan string mana yang relevan.

Pendekatan paling sederhana yang diambil objek daftar adalah mengembalikan setiap string di namespace layanannya setiap kali objek pelengkapan otomatis membuat permintaan. Untuk diskusi tentang cara mengimplementasikan jenis objek daftar ini, lihat IAutoComplete. Namun, pendekatan ini praktis hanya jika namespace relatif kecil. Ketika sejumlah besar string terlibat, objek daftar harus membatasi dirinya sendiri ke subset kecil namespace.

Antarmuka IACList diekspor oleh objek daftar pelengkapan otomatis untuk membantu mereka memilih subset string yang masuk akal dari namespace yang diatur secara hierarkis. Dengan namespace yang besar, prosedur ini secara substansial meningkatkan efisiensi pelengkapan otomatis. Prosedur dasarnya adalah sebagai berikut:

  1. Objek pelengkapan otomatis memanggil antarmuka IEnumString objek daftar. Objek daftar mengembalikan nama item tingkat atas dalam hierarki. Misalnya, jika namespace layanan terdiri dari setiap file dan folder pada drive C: , objek daftar mengembalikan jalur folder dan file yang sepenuhnya memenuhi syarat yang terkandung dalam direktori C:\.
  2. Pengguna terus mengetik sampai dia memasuki pemisah. Karakter '\' dan '/' dikenali sebagai pemisah oleh objek pelengkapan otomatis.
  3. Objek pelengkapan otomatis memanggil metode IACList::Expand objek daftar dan meneruskannya ke string parsial saat ini.
  4. Objek pelengkapan otomatis memanggil antarmuka IEnumString objek daftar lagi untuk meminta daftar string baru. Jika string parsial cocok dengan salah satu item tingkat atas di namespace, objek daftar mengembalikan nama item yang langsung berada di bawah item yang dipilih. Misalnya, jika pengguna telah memasukkan "C:\Program Files\", objek daftar mengembalikan nama file dan folder yang terkandung dalam direktori tersebut. Jika nama yang diteruskan ke IACList::Expand tidak cocok dengan item tingkat atas apa pun, objek daftar hanya dapat berhenti mengembalikan string hingga objek pelengkapan otomatis memanggil IACList::Expand dengan string yang ada di namespace objek daftar.
  5. Proses berlanjut hingga pengguna memilih string, biasanya dengan menekan tombol ENTER .

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 2000 Professional, Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header shlobj_core.h