Antarmuka ITfRange (msctf.h)

Artikel
03/08/2023

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