Compartir a través de


Función SelectObject (wingdi.h)

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

Consulte también

CombineRgn

CreateBitmap

CreateBitmapIndirect

CreateBrushIndirect

CreateCompatibleBitmap

CreateDIBPatternBrush

CreateDIBitmap

CreateEllipticRgn

CreateEllipticRgnIndirect

CreateFont

CreateFontIndirect

CreateHatchBrush

CreatePatternBrush

CreatePen

CreatePenIndirect

CreatePolygonRgn

CreateRectRgn

CreateRectRgnIndirect

CreateSolidBrush

Funciones de contexto de dispositivo

Información general sobre contextos de dispositivo

SelectClipRgn

SelectPalette