Antarmuka ITfInputScope (inputscope.h)

Artikel
02/26/2024

Antarmuka ITfInputScope digunakan oleh prosesor input teks untuk mendapatkan nilai InputScope yang mewakili konteks dokumen yang terkait dengan jendela. Cakupan input menyediakan aturan untuk membantu pengenalan ucapan dan tulisan tangan. Misalnya, jika kotak teks pada formulir digunakan untuk memasukkan alamat, cakupan input untuk kotak teks tersebut dapat diatur untuk mengenali dan hanya menerima karakter yang valid untuk alamat.

ID antarmuka IID_ITfInputScope.

Konteks dokumen digunakan oleh mesin pengenalan ucapan dan tulisan tangan dan diatur oleh prosesor input teks dengan memanggil metode SetInputScope . Aplikasi yang sadar TSF tidak memanggil SetInputScope secara langsung, melainkan mengimplementasikan ITextStoreACP atau ITfContextOwner untuk mendapatkan pointer ke ITfInputScope.

Untuk mendapatkan penunjuk ke antarmuka ITfInputScope , prosesor input teks atau aplikasi yang sadar TSF memanggil ITfContext::GetAppProperty, meneruskan GUID_PROP_INPUTSCOPE dan penunjuk ke antarmuka ITFReadOnlyProperty , seperti dalam contoh berikut.


extern const GUID GUID_PROP_INPUTSCOPE;
// 
// The TIP can call this to get the input scope of the document mgr. 
// 
HRESULT GetInputScope(ITfContext *pic, ITfRange *pRange, TfEditCookie ec, ITfInutScope **ppiscope){
    ITFReadOnlyProperty *prop;
    HRESULT hr;
    If (SUCCEEDED(hr = pic->GetAppProperty(GUID_PROP_INPUTSCOPE, &prop))
    {   VARIANT var;
        If (SUCCEEDED(hr = prop->GetValue(ec, pRange, &var)))
        {  hr = var.punkVal->QueryInterface(IID_ITfInputScope, (void **)ppiscope);
        }
        prop->Release();
    }
    return hr
}

Warisan

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

Metode

Antarmuka ITfInputScope memiliki metode ini.


ITfInputScope::GetInputScopes Metode ITfInputScope::GetInputScopes
ITfInputScope::GetPhrase Metode ITfInputScope::GetPhrase
ITfInputScope::GetRegularExpression Metode ITfInputScope::GetRegularExpression
ITfInputScope::GetSRGS Metode ITfInputScope::GetSRGS
ITfInputScope::GetXML Metode ITfInputScope::GetXML

Keterangan

Untuk menggunakan antarmuka ini dengan kontrol tanpa jendela, aplikasi memiliki dua opsi.

Buat aplikasi sadar TSF: Aplikasi yang sadar TSF harus menerapkan ITextStoreACP atau ITfContextOwner untuk mendapatkan pointer ke ITfInputScope.
SetInputScopes Ini tidak disarankan, tetapi jika aplikasi tidak sadar TSF, tidak ada cara lain untuk mempertahankan hubungan antara cakupan input dan aplikasi. Dalam hal ini, aplikasi harus memanggil SetInputScopes setiap kali fokus berubah di antara kontrol tanpa jendela.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2003 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	inputscope.h

Bagikan melalui