Partager via


SelectObject, fonction (wingdi.h)

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

Voir aussi

CombineRgn

CreateBitmap

CreateBitmapIndirect

CreateBrushIndirect

CreateCompatibleBitmap

CreateDIBPatternBrush

CreateDIBitmap

CreateEllipticRgn

CreateEllipticRgnIndirect

CreateFont

CreateFontIndirect

CreateHatchBrush

CreatePatternBrush

CreatePen

CreatePenIndirect

CreatePolygonRgn

CreateRectRgn

CreateRectRgnIndirect

CreateSolidBrush

Fonctions de contexte de l’appareil

Vue d’ensemble des contextes d’appareil

SélectionnerClipRgn

SélectionnerPalette