Metode ITextStoreACP2::GetTextExt (textstor.h)

Artikel
03/04/2024

Mendapatkan kotak pembatas, dalam koordinat layar, teks pada posisi karakter tertentu. Pemanggil harus memiliki kunci baca-saja pada dokumen sebelum memanggil metode ini.

Sintaks

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

Parameter

[in] vcView

Menentukan tampilan konteks.

[in] acpStart

Menentukan posisi karakter awal teks yang akan didapatkan dalam dokumen.

[in] acpEnd

Menentukan posisi karakter akhir teks untuk 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 diperluas melewati awal atau akhir 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 8 [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2012 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	textstor.h
DLL	Msctf.dll

Lihat juga

ITextStoreACP2

Bagikan melalui