Funzione SelectObject (wingdi.h)

Articolo
08/27/2023

La funzione SelectObject seleziona un oggetto nel contesto di dispositivo (DC) specificato. Il nuovo oggetto sostituisce l'oggetto precedente dello stesso tipo.

Sintassi

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

Parametri

[in] hdc

Handle per il controller di dominio.

[in] h

Handle per l'oggetto da selezionare. L'oggetto specificato deve essere stato creato utilizzando una delle funzioni seguenti.

Oggetto	Funzioni
Bitmap	CreateBitmap, CreateBitmapIndirect, CreateCompatibleBitmap, CreateDIBitmap, CreateDIBSection Le bitmap possono essere selezionate solo nel controller di dominio di memoria. Non è possibile selezionare una singola bitmap in più controller di dominio contemporaneamente.
Brush	CreateBrushIndirect, CreateDIBPatternBrush, CreateDIBPatternBrushPt, CreateHatchBrush, CreatePatternBrush, CreateSolidBrush
Carattere	CreateFont, CreateFontIndirect
Penna	CreatePen, CreatePenIndirect
Area	CombineRgn, CreateEllipticRgn, CreateEllipticRgnIndirect, CreatePolygonRgn, CreateRectRgn, CreateRectRgnIndirect

Valore restituito

Se l'oggetto selezionato non è un'area e la funzione ha esito positivo, il valore restituito è un handle per l'oggetto da sostituire. Se l'oggetto selezionato è un'area e la funzione ha esito positivo, il valore restituito è uno dei valori seguenti.

Valore	Significato
SIMPLEREGION	L'area è costituita da un singolo rettangolo.
COMPLEXREGION	L'area è costituita da più rettangoli.
NULLREGION	L'area è vuota.

Se si verifica un errore e l'oggetto selezionato non è un'area, il valore restituito è NULL. In caso contrario, è HGDI_ERROR.

Commenti

Questa funzione restituisce l'oggetto selezionato in precedenza del tipo specificato. Un'applicazione deve sempre sostituire un nuovo oggetto con l'oggetto predefinito originale al termine del disegno con il nuovo oggetto.

Un'applicazione non può selezionare una singola bitmap in più controller di dominio alla volta.

ICM: Se l'oggetto selezionato è un pennello o una penna, viene eseguita la gestione dei colori.

Esempio

Per un esempio, vedere Impostazione del colore della penna o del pennello.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wingdi.h (include Windows.h)
Libreria	Gdi32.lib
DLL	Gdi32.dll