Metode IInkDisp::ExtractWithRectangle (msinkaut.h)

Artikel
08/24/2023

Memotong atau menyalin goresan dari objek InkDisp yang ada dan menempelkannya ke objek InkDisp baru, dengan menggunakan persegi panjang yang diketahui untuk menentukan goresan mana yang akan diekstrak.

Sintaks

HRESULT ExtractWithRectangle(
  [in]           IInkRectangle   *Rectangle,
  [in, optional] InkExtractFlags extractFlags,
  [out, retval]  IInkDisp        **ExtractedInk
);

Parameter

[in] Rectangle

Menentukan objek InkRectangle yang memisahkan tinta untuk diekstrak dari objek InkDisp .

[in, optional] extractFlags

Opsional. Menentukan jenis enumerasi InkExtractFlags , yang menentukan apakah tinta harus dipotong atau disalin dari objek InkDisp yang ada. Nilai defaultnya adalah IEF_DEFAULT, yang memotong goresan dari objek InkDisp yang ada.

[out, retval] ExtractedInk

Ketika metode ini kembali, berisi penunjuk ke objek InkDisp yang berisi koleksi stroke yang diekstrak.

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_INK_SOME_STROKES_NOT_EXTRACTED	Tidak semua goresan diekstraksi.
E_OUTOFMEMORY	Tidak dapat mengalokasikan memori untuk menyelesaikan operasi.
E_INVALIDARG	Bendera ekstraksi tidak valid.
REGDB_CLASSNOTREG	Objek Tinta tidak terdaftar.

Keterangan

Objek InkDisp baru mempertahankan atribut gambar, properti, dan koordinat objek InkDisp asli.

Metode ini berguna untuk membuat objek InkDisp baru tanpa goresan yang dihapus atau dipotong dari objek asli.

Untuk mengekstrak stroke dari koleksi stroke yang diketahui, panggil Metode ExtractStrokes.

Hanya bagian stroke yang berada di dalam persegi panjang yang ditambahkan ke objek InkDisp baru.

Ketika parameter extractFlags adalah RemoveFromOriginal atau Default, setiap goresan yang melintasi persegi panjang dibagi dan bagian dalam persegi panjang dihapus dari objek InkDisp yang ada.

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