Metode IInkStrokeDisp::Clip (msinkaut.h)

Menghapus bagian objek IInkStrokeDisp atau koleksi InkStrokes yang berada di luar persegi panjang.

Sintaks

HRESULT Clip(
  [in] IInkRectangle *Rectangle
);

Parameter

[in] Rectangle

Menentukan persegi panjang di luar di mana goresan atau goresan dipotong. Persegi panjang ditentukan dalam koordinat ruang tinta.

Menampilkan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode Deskripsi
S_OK
Berhasil.
E_POINTER
Parameter berisi penunjuk yang tidak valid.
REGDB_CLASSNOTREG
Objek InkDisp tidak terdaftar.
E_INVALIDARG
Persegi klip tidak valid.
E_INK_EXCEPTION
Pengecualian terjadi di dalam metode .
E_FAIL
Terjadi kesalahan yang tidak ditentukan.

Keterangan

Untuk objek InkDisp , semua goresan yang bersinggungan dengan persegi panjang dibagi pada titik persimpangan. Semua bagian goresan di luar persegi panjang dihapus dari objek InkDisp . Metode ini dapat menambahkan titik baru ke stroke pada titik di mana goresan bersinggungan persegi panjang. Setelah Anda memanggil metode Klip pada objek InkDisp , ID goresan dalam koleksi goresan objek InkDisp dijamin unik, tetapi tidak dijamin untuk mempertahankan informasi lain.

Metode ini tidak mempertimbangan lebar pena saat mengklip. Ini hanya mengklip data tinta atau goresan yang sebenarnya.

Untuk objek IInkStrokeDisp atau koleksi InkStrokes , metode Klip memperbarui objek InkDisp induk. Setiap kali tinta dihapus dari objek InkDisp , objek IInkStrokeDisp atau koleksi InkStrokes apa pun yang ditentukan untuk objek InkDisp tersebut mungkin tidak valid.

Untuk informasi selengkapnya tentang data tinta, lihat Data Tinta.

Persyaratan

   
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(Rectangle, Single)

Antarmuka IInkStrokeDisp

Kelas InkRectangle