Fungsi SHAutoComplete (shlwapi.h)
Menginstruksikan kontrol pengeditan sistem untuk menggunakan LengkapiOtomatis untuk membantu menyelesaikan URL atau jalur sistem file.
Sintaks
LWSTDAPI SHAutoComplete(
[in] HWND hwndEdit,
DWORD dwFlags
);
Parameter
[in] hwndEdit
Jenis: HWND
Handel jendela kontrol edit sistem. Biasanya, parameter ini adalah handel kontrol edit atau kontrol edit yang disematkan dalam kontrol ComboBoxEx .
dwFlags
Jenis: DWORD
Bendera untuk mengontrol operasi SHAutoComplete. Empat bendera pertama digunakan untuk mengambil alih pengaturan registri Internet Explorer. Pengguna dapat mengubah pengaturan ini secara manual dengan meluncurkan lembar properti Opsi Internet dari menu Alat dan mengklik tab Tingkat Lanjut .
SHACF_AUTOAPPEND_FORCE_OFF (0x80000000)
Abaikan default registri dan paksa fitur AutoAppend nonaktif. Bendera ini harus digunakan dalam kombinasi dengan satu atau beberapa bendera SHACF_FILESYS* atau SHACF_URL*.
SHACF_AUTOAPPEND_FORCE_ON (0x40000000)
Abaikan nilai registri dan paksa fitur AutoAppend aktif. String yang sudah selesai akan ditampilkan dalam kotak edit dengan karakter yang ditambahkan disorot. Bendera ini harus digunakan dalam kombinasi dengan satu atau beberapa bendera SHACF_FILESYS* atau SHACF_URL*.
SHACF_AUTOSUGGEST_FORCE_OFF (0x20000000)
Abaikan default registri dan matikan fitur AutoSuggest. Bendera ini harus digunakan dalam kombinasi dengan satu atau beberapa bendera SHACF_FILESYS* atau SHACF_URL*.
SHACF_AUTOSUGGEST_FORCE_ON (0x10000000)
Abaikan nilai registri dan paksa fitur AutoSuggest aktif. Pilihan kemungkinan string yang diselesaikan akan ditampilkan sebagai daftar drop-down, di bawah kotak edit. Bendera ini harus digunakan dalam kombinasi dengan satu atau beberapa bendera SHACF_FILESYS* atau SHACF_URL*.
SHACF_DEFAULT (0x00000000)
Pengaturan default, setara dengan SHACF_URLALL SHACF_FILESYSTEM | . SHACF_DEFAULT tidak dapat digabungkan dengan bendera lain.
SHACF_FILESYS_ONLY (0x00000010)
Sertakan sistem file saja.
SHACF_FILESYS_DIRS (0x00000020)
Sertakan sistem file dan direktori, server UNC, dan berbagi server UNC.
SHACF_FILESYSTEM (0x00000001)
Sertakan sistem file dan Shell lainnya (Desktop, Komputer, dan Panel Kontrol, misalnya).
SHACF_URLALL (SHACF_URLHISTORY | SHACF_URLMRU)
Sertakan URL dalam daftar Riwayat pengguna dan Yang Baru Digunakan . Setara dengan SHACF_URLMRU SHACF_URLHISTORY | .
SHACF_URLHISTORY (0x00000002)
Sertakan URL dalam daftar Riwayat pengguna.
SHACF_URLMRU (0x00000004)
Sertakan URL dalam daftar Pengguna yang Baru Digunakan .
SHACF_USETAB (0x00000008)
Izinkan pengguna untuk memilih dari daftar autosuggest dengan menekan tombol TAB. Jika bendera ini tidak diatur, menekan tombol TAB akan mengalihkan fokus ke kontrol berikutnya dan menutup daftar autosuggest. Jika SHACF_USETAB diatur, menekan tombol TAB akan memilih item pertama dalam daftar. Menekan TAB lagi akan memilih item berikutnya dalam daftar, dan sebagainya. Ketika pengguna mencapai akhir daftar, tekan tombol TAB berikutnya akan memutar fokus kembali ke kontrol edit. Bendera ini harus digunakan dalam kombinasi dengan satu atau beberapa bendera SHACF_FILESYS* atau SHACF_URL* yang tercantum di halaman ini.
SHACF_VIRTUAL_NAMESPACE (0x00000040)
Nilai kembali
Jenis: HRESULT
Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.
Keterangan
SHAutoComplete berfungsi pada kontrol edit sistem apa pun, termasuk kontrol edit dan kontrol yang berisi kontrol edit seperti kontrol ComboBoxEx . Untuk mengambil handel ke kontrol edit yang disematkan dalam kontrol ComboBoxEx, kirim kontrol ComboBoxEx pesan CBEM_GETEDITCONTROL .
Aplikasi harus memanggil CoInitialize atau OleInitialize sebelum memanggil fungsi ini. CoUninitialize atau OleUninitialize tidak dapat dipanggil sampai kotak edit selesai memproses pesan WM_DESTROY untuk hwndEdit.
Jumlah maksimum item yang dapat ditampilkan dalam kotak daftar drop-down autosuggest adalah 1000.
Pada versi Windows sebelum Windows Vista dan versi server sebelum Windows Server 2008, SHAutoComplete tidak boleh dipanggil lebih dari sekali dengan HWND yang sama. Melakukannya menghasilkan kebocoran memori. Ini mencegah sumber daya asli dirilis, termasuk instans objek AutoComplete sebelumnya, objek enumerator yang telah direferensikan objek AutoComplete sebelumnya, dan sumber daya Windows Graphics Device Interface (GDI). Daripada memanggil SHAutoComplete lagi dengan sekumpulan bendera yang berbeda untuk mengubah daftar LengkapiOtomatis, panggil CoCreateInstance dengan CLSID_AutoComplete untuk mendapatkan objek AutoComplete. Kemudian berikan HWND ke objek untuk menginisialisasinya dan menyediakan enumerator kustom Anda sendiri. Anda bisa menggunakan CLSID_ACLMulti jika Anda ingin LengkapiOtomatis menggunakan beberapa daftar.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 2000 Professional, Windows XP [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | shlwapi.h |
| Pustaka | Shlwapi.lib |
| DLL | Shlwapi.dll (versi 5.0 atau yang lebih baru) |