Tentang API Pemeriksa Ejaan
Untuk pengguna di seluruh dunia, input tekstual adalah bagian dari pengalaman komputasi modern, untuk blogging, komentar, tweeting, pesan instan, atau jenis pengetikan teks lainnya. Di Windows 8, pemeriksaan ejaan terintegrasi ke dalam kontrol pengeditan.
Pengembang dapat menggunakan API pemeriksaan ejaan di aplikasi mereka untuk menggunakan layanan pemeriksaan ejaan yang tersedia. Pengembang juga dapat membuat pemeriksa ejaan yang menjadi penyedia dan diintegrasikan ke dalam kerangka kerja pemeriksaan ejaan Windows.
API Pemeriksa Ejaan dirancang untuk digunakan oleh pengembang C/C++ profesional aplikasi Windows Component Object Model (COM). API Pemeriksa Ejaan tidak didukung untuk digunakan dalam layanan Windows atau ASP.NET.
Pengelolaan versi
API Pemeriksa Ejaan tersedia dimulai dengan Windows 8 atau Windows Server 2012. Penambahan di masa mendatang ke API akan ditangani dengan membuat antarmuka baru yang dapat ditentukan menggunakan QueryInterface pada yang sudah ada.
Antarmuka
Semua antarmuka harus dirilis ketika tidak lagi digunakan. Semua string LPWSTR yang dikembalikan (dan item LPOLESTR dari IEnumString) harus dibebaskan dengan CoTaskMemFree ketika tidak lagi digunakan.
Penanganan kesalahan
Kesalahan-kesalahan dikembalikan sebagai HRESULT . IErrorInfo dan ISupportErrorInfo tidak didukung dalam API ini. Kesalahan tidak terlalu dapat ditindakkan kecuali untuk argumen yang salah.
Kode kesalahan RPC standar dapat dikembalikan oleh salah satu panggilan API karena berada di luar proses. Batas waktu RPC standar berlaku.
Keamanan
API Pemeriksa Ejaan dapat memuat kode eksternal (penyedia pemeriksaan ejaan). Ini akan menjalankan kode ini di luar proc dan dalam konteks keamanan terbatas.
Berkas kamus
Kamus khusus pengguna untuk bahasa, yang menyimpan konten untuk daftar kata Ditambahkan, Dikecualikan, dan Koreksi Otomatis, terletak di bawah %AppData%\Microsoft\Spelling\<tag bahasa>. Nama file adalah default.dic (Ditambahkan), default.exc (Dikecualikan) dan default.acl (Koreksi Otomatis). File adalah teks biasa LE UTF-16 yang harus dimulai dengan Byte Order Mark (BOM) yang sesuai. Setiap baris berisi kata (dalam daftar kata yang Ditambahkan dan Dikecualikan), atau pasangan koreksi otomatis dengan kata yang dipisahkan oleh bilah vertikal ("|") (dalam daftar kata Koreksi Otomatis). File .dic, .exc, dan .acl lainnya yang ada di direktori akan terdeteksi oleh layanan pemeriksaan ejaan dan ditambahkan ke daftar kata pengguna. File-file ini dianggap baca-saja dan tidak dimodifikasi oleh API pemeriksaan ejaan.
Menginstal penyedia pemeriksaan ejaan
Penginstalan penyedia pemeriksaan ejaan harus menempatkan semua file yang digunakannya di lokasi yang memungkinkan akses baca dari SID (pengidentifikasi keamanan) "SEMUA PAKET APLIKASI". Menginstalnya di folder di bawah "Program Files" berfungsi dengan baik. Selain itu, penyedia harus mengatur beberapa kunci dalam registri agar muncul ke API pemeriksaan ejaan. Ini dapat berada di sarang HKEY_CURRENT_USER atau sarang HKEY_LOCAL_MACHINE tergantung pada apakah itu harus diinstal hanya untuk pengguna saat ini atau semua pengguna.
Key: <Registry hive>\SOFTWARE\Classes\CLSID\<Server CLSID>
Default (REG_SZ) = <Name of the provider>
Key: <Registry hive>\SOFTWARE\Classes\CLSID\<Server CLSID>\InprocServer32
ThreadingModel (REG_SZ) = "Both"
Key: <Registry hive>\SOFTWARE\Classes\CLSID\<Server CLSID>\Version
Version (REG_SZ) = <Version>
Key: <Registry hive>\SOFTWARE\Microsoft\Spelling\Spellers\<Provider id string>
CLSID (REG_SZ) = <CLSID of the COM Server that implements the provider>
Sampel penyedia pemeriksaan ejaan memberikan contoh pendaftaran yang diperlukan untuk menginstal penyedia.
Jika Anda membuat opsi pemeriksaan ejaan baru untuk penyedia pemeriksaan ejaan, lihat IOptionDescription::Id untuk panduan tentang penamaan.
Topik terkait