Función SelectObject (wingdi.h)

Artículo
08/27/2023

La función SelectObject selecciona un objeto en el contexto de dispositivo (DC) especificado. El nuevo objeto reemplaza el objeto anterior del mismo tipo.

Sintaxis

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

Parámetros

[in] hdc

Identificador del controlador de dominio.

[in] h

Identificador del objeto que se va a seleccionar. El objeto especificado debe haberse creado mediante una de las siguientes funciones.

Object	Functions
Bitmap	CreateBitmap, CreateBitmapIndirect, CreateCompatibleBitmap, CreateDIBitmap, CreateDIBSection Los mapas de bits solo se pueden seleccionar en el controlador de dominio de memoria. No se puede seleccionar un solo mapa de bits en más de un controlador de dominio al mismo tiempo.
Brush	CreateBrushIndirect, CreateDIBPatternBrush, CreateDIBPatternBrushPt, CreateHatchBrush, CreatePatternBrush, CreateSolidBrush
Fuente	CreateFont, CreateFontIndirect
Lápiz	CreatePen, CreatePenIndirect
Región	CombineRgn, CreateEllipticRgn, CreateEllipticRgnIndirect, CreatePolygonRgn, CreateRectRgn, CreateRectRgnIndirect

Valor devuelto

Si el objeto seleccionado no es una región y la función se realiza correctamente, el valor devuelto es un identificador para el objeto que se va a reemplazar. Si el objeto seleccionado es una región y la función se ejecuta correctamente, el valor devuelto es uno de los siguientes valores.

Valor	Significado
SIMPLEREGION	La región consta de un único rectángulo.
COMPLEXREGION	La región consta de más de un rectángulo.
NULLREGION	La región está vacía.

Si se produce un error y el objeto seleccionado no es una región, el valor devuelto es NULL. De lo contrario, es HGDI_ERROR.

Comentarios

Esta función devuelve el objeto seleccionado anteriormente del tipo especificado. Una aplicación siempre debe reemplazar un nuevo objeto por el objeto predeterminado original después de haber terminado de dibujar con el nuevo objeto .

Una aplicación no puede seleccionar un solo mapa de bits en más de un controlador de dominio a la vez.

ICM: Si el objeto seleccionado es un pincel o un lápiz, se realiza la administración de colores.

Ejemplos

Para obtener un ejemplo, vea Establecer el color de lápiz o pincel.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wingdi.h (incluye Windows.h)
Library	Gdi32.lib
Archivo DLL	Gdi32.dll