Fungsi SetBoundsRect (wingdi.h)

Artikel
08/27/2023

Fungsi SetBoundsRect mengontrol akumulasi informasi persegi panjang pembatas untuk konteks perangkat yang ditentukan. Sistem dapat mempertahankan persegi panjang pembatas untuk semua operasi menggambar. Aplikasi dapat memeriksa dan mengatur persegi panjang ini. Batas gambar berguna untuk membatalkan singgahan bitmap.

Sintaks

UINT SetBoundsRect(
  [in] HDC        hdc,
  [in] const RECT *lprect,
  [in] UINT       flags
);

Parameter

[in] hdc

Handel ke konteks perangkat untuk mengakumulasi persegi panjang pembatas.

[in] lprect

Penunjuk ke struktur RECT yang digunakan untuk mengatur persegi panjang pembatas. Dimensi persegi panjang berada dalam koordinat logis. Parameter ini bisa NULL.

[in] flags

Menentukan bagaimana persegi panjang baru akan dikombinasikan dengan persegi panjang akumulasi. Parameter ini bisa menjadi salah satu dari lebih dari nilai berikut.

Nilai	Makna
DCB_ACCUMULATE	Menambahkan persegi panjang yang ditentukan oleh parameter lprcBounds ke persegi panjang pembatas (menggunakan operasi union persegi panjang). Menggunakan DCB_RESET dan DCB_ACCUMULATE mengatur persegi panjang pembatas ke persegi panjang yang ditentukan oleh parameter lprcBounds .
DCB_DISABLE	Menonaktifkan akumulasi batas.
DCB_ENABLE	Mengaktifkan akumulasi batas, yang dinonaktifkan secara default.
DCB_RESET	Membersihkan persegi panjang pembatas.

Mengembalikan nilai

Jika fungsi berhasil, nilai pengembalian menentukan status sebelumnya dari persegi panjang pembatas. Status ini bisa menjadi kombinasi dari nilai berikut.

Nilai	Makna
DCB_DISABLE	Akumulasi batas tidak aktif.
DCB_ENABLE	Akumulasi batas menyala. DCB_ENABLE dan DCB_DISABLE saling eksklusif.
DCB_RESET	Persegi panjang pembatas kosong.
DCB_SET	Persegi panjang pembatas tidak kosong. DCB_SET dan DCB_RESET saling eksklusif.

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

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


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

GetBoundsRect

Fungsi Melukis dan Menggambar

Gambaran Umum Melukis dan Menggambar

RECT

Bagikan melalui