Metode IInkStrokeDisp::GetBoundingBox (msinkaut.h)

Artikel
03/05/2024

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

Opsional. Menentukan karakteristik goresan yang akan digunakan untuk menghitung kotak pembatas. Nilai defaultnya adalah -1, menunjukkan bahwa semua karakteristik goresan digunakan untuk menentukan kotak pembatas.

Untuk detail selengkapnya tentang penggunaan karakteristik goresan untuk menghitung kotak pembatas, lihat jenis enumerasi BoundingBoxMode .

[out, retval] Rectangle

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 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, itu adalah 53 secara default. Anda harus mengalikan lebar pena dengan akar kuadrat dari penenun 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 penentun 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 pembatas 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

Antarmuka IInkStrokeDisp

Enumerasi InkBoundingBoxMode

Kelas InkRectangle

Bagikan melalui