Metode IInkDisp::HitTestWithLasso (msinkaut.h)

Artikel
03/05/2024

Mengambil goresan dalam area pemilihan poliline.

Sintaks

HRESULT HitTestWithLasso(
  [in]                VARIANT     Points,
  [in]                float       IntersectPercent,
  [in, out, optional] VARIANT     *LassoPoints,
  [out, retval]       IInkStrokes **Strokes
);

Parameter

[in] Points

Titik-titik yang digunakan dalam alat pemilihan untuk memilih goresan. Area pilihan adalah area di dalam batas pemilihan di mana batas pertama bersinggungan dengan dirinya sendiri. Jika batas tidak bersinggungan dengan dirinya sendiri, metode menambahkan titik ke akhir array untuk membuat garis lurus dari titik pertama ke titik terakhir. Jika batas adalah garis lurus (tidak ada area dalam batas pemilihan), tidak ada goresan yang dipilih.

Untuk informasi selengkapnya tentang struktur VARIAN, lihat Menggunakan Pustaka COM.

[in] IntersectPercent

Persentase titik stroke yang harus terkandung dalam alat pemilihan untuk memasukkan stroke dalam koleksi stroke yang dihasilkan. Jika nol (0), semua goresan yang terkandung di dalam atau disinggung oleh alat pemilihan disertakan dalam kumpulan goresan yang dihasilkan. Jika 100, hanya goresan yang sepenuhnya terkandung dalam alat pemilihan yang disertakan dalam koleksi. Goresan yang berpotongan alat pemilihan disertakan dalam koleksi jika persentase titik dalam goresan yang terkandung dalam alat pemilihan lebih besar dari atau sama dengan persentaseIntersect . Persentase pecahan dibulatkan ke atas.

[in, out, optional] LassoPoints

Opsional. Mengambil bagian tertentu dari alat pemilihan yang digunakan untuk pemilihan. Karena pengguna dapat menggambar berbagai jenis alat pemilihan, beberapa di antaranya tumpang tindih beberapa kali, ini dapat berguna untuk mengilustrasikan bagian mana dari alat pemilihan yang digunakan untuk pemilihan. Nilai default adalah penunjuk NULL , yang berarti tidak ada informasi yang dikembalikan.

Untuk informasi selengkapnya tentang struktur VARIAN, lihat Menggunakan Pustaka COM.

[out, retval] Strokes

Ketika metode ini kembali, berisi penunjuk ke koleksi goresan yang membentuk tinta.

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_OUTOFMEMORY	Tidak dapat mengalokasikan operasi memori.

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

Lihat juga

Metode HitTest(Point, Single)

Metode HitTest(Rectangle, Single)

IInkDisp

Kelas InkDisp

Koleksi InkStrokes

Bagikan melalui