Fungsi GetBoundsRect (wingdi.h)

Artikel
08/27/2023

Fungsi GetBoundsRect mendapatkan persegi panjang batas akumulasi saat ini untuk konteks perangkat tertentu.

Sistem mempertahankan akumulasi persegi panjang pembatas untuk setiap aplikasi. Aplikasi dapat mengambil dan mengatur persegi panjang ini.

Sintaks

UINT GetBoundsRect(
  [in]  HDC    hdc,
  [out] LPRECT lprect,
  [in]  UINT   flags
);

Parameter

[in] hdc

Handel ke konteks perangkat yang persegi panjang pembatasnya akan kembali.

[out] lprect

Penunjuk ke struktur RECT yang akan menerima persegi panjang pembatas saat ini. Persegi panjang aplikasi dikembalikan dalam koordinat logis, dan persegi panjang pembatas dikembalikan dalam koordinat layar.

[in] flags

Menentukan bagaimana fungsi GetBoundsRect akan bertingkah laku. Parameter ini bisa menjadi nilai berikut.

Nilai	Makna
DCB_RESET	Menghapus persegi panjang pembatas setelah mengembalikannya. Jika bendera ini tidak diatur, persegi panjang pembatas tidak akan dibersihkan.

Mengembalikan nilai

Nilai yang dikembalikan menentukan status akumulasi persegi panjang pembatas; bisa menjadi salah satu nilai berikut.

Nilai	Makna
0	Terjadi kesalahan. Handel konteks perangkat yang ditentukan tidak valid.
DCB_DISABLE	Akumulasi batas tidak aktif.
DCB_ENABLE	Akumulasi batas menyala.
DCB_RESET	Persegi panjang pembatas kosong.
DCB_SET	Persegi panjang pembatas tidak kosong.

Keterangan

Nilai DCB_SET adalah kombinasi dari nilai bit DCB_ACCUMULATE dan DCB_RESET. Aplikasi yang memeriksa bit DCB_RESET untuk menentukan apakah persegi panjang pembatas kosong juga harus memeriksa bit DCB_ACCUMULATE. Persegi panjang pembatas kosong hanya jika bit DCB_RESET adalah 1 dan bit DCB_ACCUMULATE adalah 0.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	wingdi.h (sertakan Windows.h)
Pustaka	Gdi32.lib
DLL	Gdi32.dll

Lihat juga

Fungsi Melukis dan Menggambar

Gambaran Umum Melukis dan Menggambar

SetBoundsRect

Bagikan melalui