SelectObject, fonction (wingdi.h)

Article
03/13/2024

La fonction SelectObject sélectionne un objet dans le contexte d’appareil (DC) spécifié. Le nouvel objet remplace l’objet précédent du même type.

Syntaxe

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

Paramètres

[in] hdc

Handle pour le contrôleur de domaine.

[in] h

Handle de l’objet à sélectionner. L’objet spécifié doit avoir été créé à l’aide de l’une des fonctions suivantes.

Object	Fonctions
Bitmap	CreateBitmap, CreateBitmapIndirect, CreateCompatibleBitmap, CreateDIBitmap, CreateDIBSection Les bitmaps ne peuvent être sélectionnées que dans les contrôleurs de domaine de mémoire. Une image bitmap ne peut pas être sélectionnée dans plusieurs contrôleurs de domaine en même temps.
Brush	CreateBrushIndirect, CreateDIBPatternBrush, CreateDIBPatternBrushPt, CreateHatchBrush, CreatePatternBrush, CreateSolidBrush
Police	CreateFont, CreateFontIndirect
Stylet	CreatePen, CreatePenIndirect
Région	CombineRgn, CreateEllipticRgn, CreateEllipticRgnIndirect, CreatePolygonRgn, CreateRectRgn, CreateRectRgn, CreateRectRgnIndirect

Valeur retournée

Si l’objet sélectionné n’est pas une région et que la fonction réussit, la valeur de retour est un handle de l’objet en cours de remplacement. Si l’objet sélectionné est une région et que la fonction réussit, la valeur de retour est l’une des valeurs suivantes.

Valeur	Signification
SIMPLEREGION	La région se compose d’un rectangle unique.
COMPLEXREGION	La région se compose de plusieurs rectangles.
NULLREGION	La région est vide.

Si une erreur se produit et que l’objet sélectionné n’est pas une région, la valeur de retour est NULL. Sinon, c’est HGDI_ERROR.

Remarques

Cette fonction retourne l’objet précédemment sélectionné du type spécifié. Une application doit toujours remplacer un nouvel objet par l’objet par défaut d’origine une fois le dessin terminé avec le nouvel objet.

Une application ne peut pas sélectionner une seule bitmap dans plusieurs contrôleurs de domaine à la fois.

ICM: Si l’objet sélectionné est un pinceau ou un stylet, la gestion des couleurs est effectuée.

Exemples

Pour obtenir un exemple, consultez Définition du stylet ou de la couleur du pinceau.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wingdi.h (inclure Windows.h)
Bibliothèque	Gdi32.lib
DLL	Gdi32.dll