Metode IInkDisp::GetBoundingBox (msinkaut.h)

Artikel
08/24/2023

Mengambil kotak pembatas dalam koordinat ruang tinta untuk semua goresan dalam objek InkDisp , goresan individual, atau koleksi InkStrokes .

Sintaks

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

Parameter

[in, optional] BoundingBoxMode

Pilihan. 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 .

Nilai defaultnya adalah -1 (IBBM_DEFAULT), yang berarti bahwa semua karakteristik goresan digunakan untuk menentukan kotak pembatas.

[out, retval] Rectangle

Ketika metode ini kembali, berisi 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

Ketika 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


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

IInkDisp

Enumerasi InkBoundingBoxMode

Kelas InkDisp

Kelas InkRectangle

Bagikan melalui