Antarmuka ITfRange (msctf.h)
Antarmuka ITfRange digunakan oleh layanan teks dan aplikasi untuk mereferensikan dan memanipulasi teks dalam konteks tertentu. ID antarmuka IID_ITfRange.
Warisan
Antarmuka ITfRange mewarisi dari antarmuka IUnknown . ITfRange juga memiliki jenis anggota ini:
Metode
Antarmuka ITfRange memiliki metode ini.
| ITfRange::AdjustForInsert Metode ITfRange::AdjustForInsert memperluas atau mengontrak rentang teks untuk menyesuaikan penyisipan teks. |
| ITfRange::Clone Metode ITfRange::Clone menduplikasi rentang teks ini. |
| ITfRange::Ciutkan Metode ITfRange::Collapse menghapus rentang teks dengan memindahkan jangkar awal dan jangkar akhir ke posisi yang sama. |
| ITfRange::CompareEnd Metode ITfRange::CompareEnd membandingkan posisi jangkar akhir dari rentang teks ini dengan jangkar dalam rentang lain. |
| ITfRange::CompareStart Metode ITfRange::CompareStart membandingkan posisi jangkar awal rentang teks ini dengan jangkar dalam rentang lain. |
| ITfRange::GetContext Metode ITfRange::GetContext |
| ITfRange::GetEmbedded Metode ITfRange::GetEmbedded mendapatkan konten yang sesuai dengan karakter TS_CHAR_EMBEDDED dalam aliran teks. Jangkar awal rentang teks diposisikan tepat sebelum karakter yang diminati. |
| ITfRange::GetFormattedText Metode ITfRange::GetFormattedText mendapatkan konten yang diformat yang terkandung dalam rentang teks. Konten dibungkus dalam objek yang mendukung antarmuka IDataObject. |
| ITfRange::GetGravity Metode ITfRange::GetGravity |
| ITfRange::GetText Metode ITfRange::GetText mendapatkan konten yang dicakup oleh rentang teks ini. |
| ITfRange::InsertEmbedded Metode ITfRange::InsertEmbedded menyisipkan objek di lokasi jangkar awal rentang teks. |
| ITfRange::IsEmpty Metode ITfRange::IsEmpty memverifikasi bahwa rentang teks kosong karena jangkar awal dan akhir menempati posisi yang sama. |
| ITfRange::IsEqualEnd Metode ITfRange::IsEqualStart memverifikasi bahwa jangkar akhir rentang teks ini cocok dengan jangkar rentang lain yang ditentukan. |
| ITfRange::IsEqualStart Metode ITfRange::IsEqualStart memverifikasi bahwa jangkar awal rentang teks ini cocok dengan jangkar rentang lain yang ditentukan. |
| ITfRange::SetGravity Metode ITfRange::SetGravity |
| ITfRange::SetText Metode ITfRange::SetText menggantikan konten yang dicakup oleh rentang teks. |
| ITfRange::ShiftEnd Metode ITfRange::ShiftEnd |
| ITfRange::ShiftEndRegion Metode ITfRange::ShiftEndRegion |
| ITfRange::ShiftEndToRange Metode ITfRange::ShiftEndToRange |
| ITfRange::ShiftStart Metode ITfRange::ShiftStart |
| ITfRange::ShiftStartRegion Metode ITfRange::ShiftStartRegion |
| ITfRange::ShiftStartToRange Metode ITfRange::ShiftStartToRange |
Keterangan
Manajer TSF mengimplementasikan antarmuka ini. Untuk informasi selengkapnya tentang rentang, jangkar, objek yang disematkan, dan properti teks lainnya yang digunakan oleh TSF, lihat Rentang, Objek Tersemat, dan topik lain dalam Menggunakan Kerangka Kerja Layanan Teks.
Contoh
Setelah objek komposisi ITfComposition dibuat, pointer ke penunjuk antarmuka ITfRange dapat diperoleh dengan memanggil metode ITfComposition::GetRange , seperti yang ditunjukkan dalam contoh kode berikut.
HRESULT hr;
ITfComposition *pComposition;
ITfRange *pRange;
WCHAR *achBuffer[64]; // Buffer to receive text.
ULONG cch;
hr = pComposition->GetRange(&pRange);
if(SUCCEEDED(hr))
{
// Loop to scan text:
do
{
cch = ARRAYSIZE(achBuffer);
hr = pRange->GetText(ec, TF_TF_MOVESTART | TF_TF_IGNOREEND, achBuffer, cch, &cch);
if(SUCCEEDED(hr))
{
// Do something with the text.
pRange->Release();
}
}
while (cch == ARRAYSIZE(achBuffer));
pComposition->Release();
}
Penunjuk ke objek ITfRange saat ini dapat diperoleh dari <elemen rentang> struktur TF_SELECTION .
Persyaratan
| Klien minimum yang didukung | Windows 2000 Professional [aplikasi desktop | Aplikasi UWP] |
| Server minimum yang didukung | Windows 2000 Server [aplikasi desktop | Aplikasi UWP] |
| Target Platform | Windows |
| Header | msctf.h |
| Redistribusi | TSF 1.0 di Windows 2000 Professional |