Fungsi SetBrushOrgEx (wingdi.h)

Artikel
03/08/2023

Fungsi SetBrushOrgEx mengatur asal kuas yang ditetapkan GDI ke kuas berikutnya yang dipilih aplikasi ke dalam konteks perangkat yang ditentukan.

Sintaks

BOOL SetBrushOrgEx(
  [in]  HDC     hdc,
  [in]  int     x,
  [in]  int     y,
  [out] LPPOINT lppt
);

Parameter

[in] hdc

Handel ke konteks perangkat.

[in] x

Koordinat x, dalam unit perangkat, dari asal kuas baru. Jika nilai ini lebih besar dari lebar kuas, nilainya dikurangi menggunakan operator modulus (lebar kuas modnXOrg).

[in] y

Koordinat y, dalam unit perangkat, dari asal kuas baru. Jika nilai ini lebih besar dari tinggi kuas, nilainya dikurangi menggunakan operator modulus (tinggi kuas modnYOrg).

[out] lppt

Pointer ke struktur POINT yang menerima asal kuas sebelumnya.

Parameter ini bisa NULL jika asal kuas sebelumnya tidak diperlukan.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

Keterangan

Kuas adalah bitmap yang digunakan sistem untuk melukis interior bentuk yang diisi.

Asal kuas adalah sepasang koordinat yang menentukan lokasi satu piksel dalam bitmap. Koordinat asal kuas default adalah (0,0). Untuk koordinat horizontal, nilai 0 sesuai dengan kolom piksel paling kiri; lebar sesuai dengan kolom paling kanan. Untuk koordinat vertikal, nilai 0 sesuai dengan baris piksel paling atas; tinggi sesuai dengan baris paling bawah.

Sistem secara otomatis melacak asal semua konteks perangkat yang dikelola jendela dan menyesuaikan kuasnya seperlunya untuk mempertahankan keselarasan pola di permukaan. Asal kuas yang diatur dengan panggilan ini relatif terhadap sudut kiri atas area klien.

Aplikasi harus memanggil SetBrushOrgEx setelah mengatur mode peregangan bitmap ke HALFTONE dengan menggunakan SetStretchBltMode. Ini harus dilakukan untuk menghindari ketidakselarasan kuas.

Sistem secara otomatis melacak asal semua konteks perangkat yang dikelola jendela dan menyesuaikan kuasnya seperlunya untuk mempertahankan keselarasan pola di permukaan.

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