Metode ITextServices::TxQueryHitPoint (textserv.h)

Artikel
08/26/2023

Menguji apakah titik tertentu berada dalam persegi panjang objek layanan teks.

Sintaks

HRESULT TxQueryHitPoint(
  [in]  DWORD          dwDrawAspect,
        LONG           lindex,
  [in]  void           *pvAspect,
  [in]  DVTARGETDEVICE *ptd,
  [in]  HDC            hdcDraw,
  [in]  HDC            hicTargetDev,
  [in]  LPCRECT        lprcClient,
  [in]  INT            x,
  [in]  INT            y,
  [out] DWORD          *pHitResult
);

Parameter

[in] dwDrawAspect

Jenis: DWORD

Aspek gambar bisa menjadi salah satu nilai berikut.

Nilai	Makna
DVASPECT_CONTENT	Merender gambar layar konten teks ke konteks perangkat hdcDraw . Parameter hicTargetDev dan ptd memberikan informasi tentang konteks perangkat target jika ada (biasanya printer).
DVASPECT_DOCPRINT	Merender objek ke konteks perangkat hdcDraw seolah-olah dicetak ke printer. Dengan demikian, objek layanan teks dapat mengoptimalkan printer (misalnya, tidak mengecat warna latar belakang, jika putih). Selain itu, elemen khusus layar tertentu (seperti pilihan) tidak boleh dirender. ITextServices::TxGetNaturalSize harus merender persegi panjang lprcClient , dimulai pada posisi pengguliran saat ini.

Nilai

Makna

DVASPECT_CONTENT

Merender gambar layar konten teks ke konteks perangkat hdcDraw .

Parameter hicTargetDev dan ptd memberikan informasi tentang konteks perangkat target jika ada (biasanya printer).

DVASPECT_DOCPRINT

Merender objek ke konteks perangkat hdcDraw seolah-olah dicetak ke printer. Dengan demikian, objek layanan teks dapat mengoptimalkan printer (misalnya, tidak mengecat warna latar belakang, jika putih). Selain itu, elemen khusus layar tertentu (seperti pilihan) tidak boleh dirender.

ITextServices::TxGetNaturalSize harus merender persegi panjang lprcClient , dimulai pada posisi pengguliran saat ini.

lindex

Jenis: LONG

Tidak didukung.

[in] pvAspect

Jenis: void*

Informasi untuk pengoptimalan gambar.

[in] ptd

Jenis: DVTARGETDEVICE*

Informasi tentang perangkat target.

[in] hdcDraw

Jenis: HDC

Merender konteks perangkat.

[in] hicTargetDev

Jenis: HDC

Konteks informasi target.

[in] lprcClient

Jenis: LPCRECT

Persegi panjang klien kontrol, dalam koordinat klien (perangkat) tampilan tempat pengujian temuan dilakukan.

[in] x

Jenis: INT

koordinat x untuk memeriksa, dalam koordinat klien, dari tampilan di mana pengujian hit dilakukan.

[in] y

Jenis: INT

koordinat y untuk memeriksa, dalam koordinat klien, dari tampilan di mana pengujian temuan dilakukan.

[out] pHitResult

Jenis: DWORD*

Hasil dari tes hit. Ini bisa menjadi salah satu nilai enumerasi TXTHITRESULT berikut.

Nilai	Makna
TXTHITRESULT_CLOSE	Titik berada di persegi panjang klien dan dekat dengan area yang tidak transparan.
TXTHITRESULT_HIT	Titik berada di persegi panjang klien dan melalui teks atau latar belakang tidak transparan.
TXTHITRESULT_NOHIT	Titik berada di luar persegi panjang klien.
TXTHITRESULT_TRANSPARENT	Titik berada di persegi panjang klien dan tidak melalui teks atau latar belakang transparan.

Nilai kembali

Jenis: HRESULT

Nilai yang dikembalikan adalah kode HRESULT .

Keterangan

Metode ini memungkinkan host untuk menerapkan pengujian temuan transparan pada teks.

Untuk informasi selengkapnya, lihat bagian Keterangan di ITextServices::TxDraw dan ITextServices::OnTxSetCursor.

Persyaratan


Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	textserv.h
DLL	Msftedit.dll