IDWriteTextAnalysisSource::GetTextAtPosition method (dwrite.h)

Mendapatkan blok teks yang dimulai pada posisi teks yang ditentukan.

Sintaks

HRESULT GetTextAtPosition(
        UINT32      textPosition,
  [out] WCHAR const **textString,
  [out] UINT32      *textLength
);

Parameter

textPosition

Jenis: UINT32

Posisi pertama dari bagian yang diperoleh. Semua posisi berada di unit kode UTF16 , bukan seluruh karakter, yang penting ketika karakter tambahan digunakan.

[out] textString

Jenis: const WCHAR**

Ketika metode ini kembali, berisi alamat blok teks sebagai array karakter yang akan diambil dari analisis teks.

[out] textLength

Jenis: UINT32*

Ketika metode ini kembali, berisi jumlah unit UTF16 dari gugus yang diambil. Panjang yang dikembalikan bukan panjang blok, tetapi panjang yang tersisa di blok, dari posisi yang ditentukan hingga akhir. Misalnya, mengkueri posisi yaitu 75 posisi ke dalam blok posisi 100 akan mengembalikan 25.

Menampilkan nilai

Jenis: HRESULT

Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Mengembalikan NULL menunjukkan akhir teks, yang merupakan posisi setelah karakter terakhir. Fungsi ini disebut berulang untuk setiap blok berturut-turut, mengikat beberapa blok terfragmentasi di penyimpanan backing menjadi string virtual yang berdampingan.

Meskipun aplikasi dapat menerapkan konten tekstual jarang yang hanya memetakan bagian dari penyimpanan cadangan, aplikasi harus memetakan teks apa pun yang berada dalam rentang yang diteruskan ke fungsi analisis apa pun.

Persyaratan

Klien minimum yang didukung	Windows 7, Windows Vista dengan SP2 dan Pembaruan Platform untuk Windows Vista [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 R2, Windows Server 2008 dengan SP2 dan Pembaruan Platform untuk Windows Server 2008 [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	dwrite.h
Pustaka	Dwrite.lib
DLL	Dwrite.dll

Lihat juga

IDWriteTextAnalysisSource