Fungsi SelectObject (wingdi.h)

Artikel
03/08/2023

Fungsi SelectObject memilih objek ke dalam konteks perangkat (DC) yang ditentukan. Objek baru menggantikan objek sebelumnya dengan jenis yang sama.

Sintaks

HGDIOBJ SelectObject(
  [in] HDC     hdc,
  [in] HGDIOBJ h
);

Parameter

[in] hdc

Handel ke DC.

[in] h

Handel ke objek yang akan dipilih. Objek yang ditentukan harus dibuat dengan menggunakan salah satu fungsi berikut.

Object	Fungsi
Bitmap	CreateBitmap, CreateBitmapIndirect, CreateCompatibleBitmap, CreateDIBitmap, CreateDIBSection Bitmap hanya dapat dipilih ke dalam DC memori. Bitmap tunggal tidak dapat dipilih ke lebih dari satu DC secara bersamaan.
Kuas	CreateBrushIndirect, CreateDIBPatternBrush, CreateDIBPatternBrushPt, CreateHatchBrush, CreatePatternBrush, CreateSolidBrush
Font	CreateFont, CreateFontIndirect
Pena	CreatePen, CreatePenIndirect
Wilayah	CombineRgn, CreateEllipticRgn, CreateEllipticRgnIndirect, CreatePolygonRgn, CreateRectRgn, CreateRectRgnIndirect

Mengembalikan nilai

Jika objek yang dipilih bukan wilayah dan fungsi berhasil, nilai yang dikembalikan adalah handel ke objek yang diganti. Jika objek yang dipilih adalah wilayah dan fungsi berhasil, nilai yang dikembalikan adalah salah satu nilai berikut.

Nilai	Makna
SIMPLEREGION	Wilayah terdiri dari satu persegi panjang.
COMPLEXREGION	Wilayah terdiri dari lebih dari satu persegi panjang.
NULLREGION	Wilayah kosong.

Jika terjadi kesalahan dan objek yang dipilih bukan wilayah, nilai yang dikembalikan adalah NULL. Jika tidak, itu HGDI_ERROR.

Keterangan

Fungsi ini mengembalikan objek yang dipilih sebelumnya dari jenis yang ditentukan. Aplikasi harus selalu mengganti objek baru dengan objek default asli setelah selesai menggambar dengan objek baru.

Aplikasi tidak dapat memilih bitmap tunggal ke lebih dari satu DC pada satu waktu.

ICM: Jika objek yang dipilih adalah kuas atau pena, manajemen warna dilakukan.

Contoh

Misalnya, lihat Mengatur Pena atau Warna Kuas.

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