Metode IInkDisp::HitTestCircle (msinkaut.h)

Artikel
03/05/2024

Mengambil koleksi InkStrokes yang sepenuhnya berada di dalam atau dipotong oleh lingkaran yang diketahui.

Sintaks

HRESULT HitTestCircle(
  [in]          long        X,
  [in]          long        Y,
  [in]          float       radius,
  [out, retval] IInkStrokes **Strokes
);

Parameter

[in] X

Posisi x pusat lingkaran uji hit dalam unit ruang tinta.

[in] Y

Posisi y di tengah lingkaran uji hit dalam unit ruang tinta.

[in] radius

Radius lingkaran untuk digunakan dalam tes hit, dalam unit ruang tinta.

[out, retval] Strokes

Ketika metode ini kembali, berisi kumpulan goresan yang benar-benar berada di dalam atau berpotongan oleh lingkaran yang ditentukan.

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Berhasil.
E_POINTER	Parameter berisi penunjuk yang tidak valid.
E_INK_EXCEPTION	Pengecualian terjadi di dalam metode .
E_INVALIDARG	Gagang tampilan tidak valid.
E_UNEXPECTED	Parameter atau jenis properti yang tidak terduga.

Keterangan

Jika stroke berpotongan lingkaran, stroke lengkap dikembalikan.

Metode ini menghitung persimpangan, mempertimbangkan set lengkap atribut gambar yang berlaku untuk goresan, termasuk lebar pena penuh, penghalusan Bezier (jika ada), dan bentuk ujung pena.

Setelah transformasi rotasi atau geser dilakukan pada stroke atau kumpulan stroke, koordinat dan y- yang diubah x- tidak lagi berkonsentrasi dengan koordinat asli. Karena itu, radius argumen tidak boleh dihitung dari koordinat x- atau y- .

Untuk menentukan titik mana dari stroke yang diketahui berpotongan area pengujian, panggil metode HitTest dari objek IInkStrokeDisp .

Aplikasi harus selalu meneruskan pointer tujuan untuk pengumpulan stroke yang dihasilkan. Jika tidak ada persimpangan, koleksi memiliki hitungan nol.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP Tablet PC Edition [hanya aplikasi desktop]
Server minimum yang didukung	Tidak ada yang didukung
Target Platform	Windows
Header	msinkaut.h
Pustaka	InkObj.dll