IInkRenderer::Metode pengukuran (msinkaut.h)

Artikel
02/29/2024

Menghitung persegi panjang pada konteks perangkat yang akan berisi kumpulan goresan jika goresan digambar dengan objek InkRenderer menggunakan metode DrawStroke .

Sintaks

HRESULT Measure(
  [in]          IInkStrokes   *Strokes,
  [out, retval] IInkRectangle **Rectangle
);

Parameter

[in] Strokes

Kumpulan goresan untuk diukur.

[out, retval] Rectangle

Ketika metode ini kembali, berisi penunjuk ke persegi panjang pada konteks perangkat yang akan berisi goresan jika digambar dengan metode DrawStroke dari objek InkRenderer . Goresan harus berisi koordinat x- dan y untuk menghitung persegi panjang. Jika tidak, metode mengembalikan persegi panjang kosong.

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_INVALIDARG	Handel tampilan tidak valid.
E_INK_INCOMPATIBLE_OBJECT	Parameter stroke tidak menunjuk ke objek yang valid.
E_INK_MISMATCHED_INK_OBJECT	Parameter stroke dikaitkan dengan objek InkDisp yang berbeda.
E_INK_EXCEPTION	Pengecualian terjadi di dalam metode .
E_UNEXPECTED	Parameter atau jenis properti yang tidak terduga.

Keterangan

Ini hanya akurat jika Anda meneruskan argumen yang sama ke Measure dan DrawStroke.

Karena 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. Tinggi dan lebar kotak pembatas diperluas setengah jumlah ini di setiap arah, dan sisi kanan dan bawah bertambah satu.

Misalnya, pertimbangkan bahwa lebar pena awalnya adalah 53, akar kuadrat dari penenun transformasi tampilan adalah 50, dan kotak pembatasnya 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