Metode IInkStrokes::GetBoundingBox (msinkaut.h)

Artikel
02/29/2024

Mendapatkan kotak pembatas dalam koordinat ruang tinta untuk semua goresan dalam objek InkDisp , stroke individu, atau koleksi InkStrokes .

Sintaks

HRESULT GetBoundingBox(
  [in, optional] InkBoundingBoxMode BoundingBoxMode,
  [out, retval]  IInkRectangle      **BoundingBox
);

Parameter

[in, optional] BoundingBoxMode

Opsional. Menentukan karakteristik goresan yang akan digunakan untuk menghitung kotak pembatas. Untuk detail selengkapnya tentang penggunaan karakteristik goresan untuk menghitung kotak pembatas, lihat jenis enumerasi BoundingBoxMode .

Parameter BoundingBoxMode dari metode GetBoundingBox memiliki nilai default -1, yang berarti bahwa semua karakteristik stroke digunakan untuk menentukan kotak pembatas.

[out, retval] BoundingBox

Ketika metode ini kembali, berisi penunjuk ke persegi panjang yang menentukan kotak pembatas objek InkDisp , objek IInkStrokeDisp , atau koleksi InkStrokes .

Catatan Untuk objek IInkStrokeDisp , kotak pembatas yang dikembalikan adalah salinan kotak pembatas goresan, sehingga mengubah kotak pembatas yang dikembalikan tidak memengaruhi lokasi goresan.

Mengembalikan nilai

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_UNEXPECTED	Parameter atau jenis properti yang tidak terduga.
REGDB_CLASSNOTREG	Objek InkRectangle tidak terdaftar.

Keterangan

Saat kotak pembatas dipengaruhi oleh lebar pena, lebar ini diskalakan dengan tepat untuk transformasi tampilan InkRenderer. Untuk melakukan ini, lebar pena dikalikan dengan akar kuadrat dari penentu transformasi tampilan.

Catatan Di Windows Vista dan versi yang lebih baru, Metode GetBoundingBox tidak mempertimbangkan lebar goresan.

Catatan Jika Anda belum mengatur lebar pena secara eksplisit, secara default adalah 53. Anda harus mengalikan lebar pena dengan akar kuadrat dari determinan untuk menghasilkan kotak pembatas yang benar. Tinggi dan lebar kotak pembatas diperluas setengah jumlah ini di setiap arah. Misalnya, pertimbangkan bahwa lebar pena adalah 53, akar kuadrat dari determinan adalah 50, dan kotak pembatas adalah (0, 0, 1000, 1000). Penyesuaian lebar pena ke kotak pembatas di setiap arah dihitung sebagai (53 * 50) / 2, dan sisi kanan dan bawah bertambah satu. Ini menghasilkan kotak batas yang dirender (-1325, -1325, 2326, 2326).

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

IInkStrokes

Enumerasi InkBoundingBoxMode

Kelas InkRectangle

Koleksi InkStrokes

Bagikan melalui