wingdi.h


DeleteObject

La función DeleteObject elimina una pluma lógica, pincel, fuente, mapa de bits, región o paleta, liberando todos los recursos del sistema asociados con el objeto. Después de que el objeto es borrado, el manipulador especificado ya no es válido.

Sintaxis

BOOL DeleteObject(
    HGDIOBJ hObject   // manipulador al objeto gráfico
   );

Parámetros:

hObject: identifica una pluma lógica, pincel, fuente, mapa de bits, región o paleta.

Valor de retorno

Si la función tiene éxito, el valor de retorno es TRUE.

Si el manipulador suministrado no es válido o está actualmente seleccionado en algún contexto de dispositivo (DC), el valor de retorno es FALSE.

Observaciones

No se debe borrar un objeto de dibujo (pluma o pincel) mientras esté seleccionado en un DC.

Cuando se borra un pincel con patrón, el mapa de bits asociado con el pincel no se borrará. Ese mapa de bits debe ser borrado independientemente.