Bagikan melalui


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

Lihat juga

Komposisi

Objek Tertanam

ITfComposition

ITfComposition::GetRange

IUnknown

Rentang

TF_SELECTION

Menggunakan Kerangka Kerja Layanan Teks