Fungsi SetBoundsRect (wingdi.h)

  • Artikel

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