Fungsi SetPixel (wingdi.h)

Artikel
03/13/2024

Fungsi SetPixel mengatur piksel pada koordinat yang ditentukan ke warna yang ditentukan.

Sintaks

COLORREF SetPixel(
  [in] HDC      hdc,
  [in] int      x,
  [in] int      y,
  [in] COLORREF color
);

Parameter

[in] hdc

Handel ke konteks perangkat.

[in] x

Koordinat x, dalam unit logis, dari titik yang akan ditetapkan.

[in] y

Koordinat y, dalam unit logis, dari titik yang akan ditetapkan.

[in] color

Warna yang akan digunakan untuk melukis titik. Untuk membuat nilai warna COLORREF , gunakan makro RGB .

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah nilai RGB tempat fungsi mengatur piksel. Nilai ini mungkin berbeda dari warna yang ditentukan oleh crColor; yang terjadi ketika kecocokan persis untuk warna yang ditentukan tidak dapat ditemukan.

Jika fungsi gagal, nilai yang dikembalikan adalah -1.

Ini bisa menjadi nilai berikut.

Menampilkan kode	Deskripsi
ERROR_INVALID_PARAMETER	Satu atau beberapa parameter input tidak valid.

Keterangan

Fungsi gagal jika koordinat piksel terletak di luar wilayah kliping saat ini.

Tidak semua perangkat mendukung fungsi SetPixel . Untuk informasi selengkapnya, lihat GetDeviceCaps.

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