Metode IInkStrokeDisp::GetRectangleIntersections (msinkaut.h)

  • Artikel

Menemukan titik di mana objek IInkStrokeDisp berpotongan persegi panjang tertentu.

Sintaks

HRESULT GetRectangleIntersections(
  [in]          IInkRectangle *Rectangle,
  [out, retval] VARIANT       *Intersections
);

Parameter

[in] Rectangle

Persegi panjang dalam koordinat ruang tinta , yang menggambarkan area uji hit.

[out, retval] Intersections

Ketika metode ini kembali, berisi array VARIAN yang menunjukkan di mana goresan bersinggungan persegi panjang. Indeks titik mengambang awal disimpan dalam indeks genap. Indeks titik mengambang akhir disimpan dalam indeks ganjil. Pasangan indeks pertama mewakili persimpangan pertama.

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

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_OUTOFMEMORY
 Tidak dapat mengalokasikan objek pembantu handler Stroke.
E_UNEXPECTED
 Parameter atau jenis properti yang tidak terduga.
E_INK_EXCEPTION
 Pengecualian terjadi di dalam metode .

Keterangan

Metode ini mengembalikan array yang menunjukkan di mana goresan bersinggungan dengan persegi panjang yang ditentukan. Setiap segmen goresan yang bersinggungan persegi panjang adalah sepasang indeks, bergantian dengan indeks awal diikuti oleh indeks akhir.

Jika stroke dimulai dalam persegi panjang pengujian, indeks pertama diatur ke -1. Jika stroke berakhir dalam persegi panjang pengujian, indeks terakhir diatur ke -1. Jika stroke sepenuhnya berada di luar persegi panjang pengujian, array kosong akan dikembalikan. Misalnya, jika stroke dimulai di dalam persegi panjang pengujian, meninggalkan batas persegi panjang, kembali ke dalam, dan meninggalkan lagi, maka metode GetRectangleIntersections mungkin mengembalikan {-1, 1,4, 5,5, 10,1} untuk menggambarkan dua segmen stroke yang jatuh dalam persegi panjang.

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 Klip

Metode FindIntersections

Antarmuka IInkStrokeDisp