wingdi.h


SelectObject

La función SelectObject selecciona un objeto para un contexto de dispositivo especificado. El nuevo objeto reemplaza al anterior objeto del mismo tipo.

Sintaxis

HGDIOBJ SelectObject(
    HDC hdc,        // manipulador de un contexto de dispositivo
    HGDIOBJ hgdiobj // manipulador de objeto
   );

Parámetros:

hdc: identifica el contexto de dispositivo.

hgdiobj: identifica el objeto a seleccionar. El objeto debe haber sido creado usando una de las siguientes funciones:

Valor de retorno

Si el objeto seleccionado no es una región, y la función tiene éxito, el valor de retorno es el manipulador del objeto reemplazado. Si el objeto seleccionado es una región, y la función tiene éxito, el valor de retorno es uno de los siguientes valores:

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

Si ocurre un error y el objeto seleccionado no es una región, el valor de retorno es NULL. En cualquier otro caso, será GDI_ERROR.

Observaciones

Esta función retorna el objeto seleccionado previamente del mismo tipo que el especificado. Una aplicación debe remplazar siempre el objeto nuevo con el objeto por defecto original después de que haya terminado de pintar con el nuevo objeto.

Una aplicación no puede seleccionar un bitmap para más de un contexto de dispositivo a la vez.