Metode ITfContextOwner::GetTextExt (msctf.h)

Metode ITfContextOwner::GetTextExt mengembalikan kotak pembatas, dalam koordinat layar, teks pada posisi karakter yang ditentukan. Pemanggil harus memiliki kunci baca-saja pada dokumen sebelum memanggil metode ini.

Sintaks

HRESULT GetTextExt(
  [in]  LONG acpStart,
  [in]  LONG acpEnd,
  [out] RECT *prc,
  [out] BOOL *pfClipped
);

Parameter

[in] acpStart

Menentukan posisi karakter awal teks yang akan didapatkan dalam dokumen.

[in] acpEnd

Menentukan posisi karakter akhir teks yang akan didapatkan dalam dokumen.

[out] prc

Menerima kotak pembatas, dalam koordinat layar, teks pada posisi karakter yang ditentukan.

[out] pfClipped

Menerima nilai Boolean yang menentukan apakah teks dalam kotak pembatas telah diklip. Jika parameter ini TRUE, kotak pembatas berisi teks yang diklip dan tidak menyertakan seluruh rentang teks yang diminta. Kotak pembatas dipotong karena rentang yang diminta tidak terlihat.

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Nilai	Deskripsi
S_OK	Metode berhasil.
TS_E_INVALIDARG	Posisi karakter awal dan akhir yang ditentukan sama.
TS_E_INVALIDPOS	Rentang yang ditentukan oleh parameter acpStart dan acpEnd meluas melewati akhir dokumen atau bagian atas dokumen.
TS_E_NOLAYOUT	Aplikasi belum menghitung tata letak teks.
TS_E_NOLOCK	Pemanggil tidak memiliki kunci baca-saja pada dokumen.

Keterangan

Jika jendela dokumen diminimalkan, atau jika teks yang ditentukan saat ini tidak terlihat, metode mengembalikan S_OK dengan parameter rangkaian diatur ke {0,0,0,0}.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	msctf.h
DLL	Msimtf.dll
Redistribusi	TSF 1.0 di Windows 2000 Professional

Lihat juga

ITextStoreACP::GetTextExt

ITfContextOwner

ITfContextView::GetTextExt