Función UnrealizeObject (wingdi.h)

La función UnrealizeObject restablece el origen de un pincel o restablece una paleta lógica. Si el parámetro hgdiobj es un identificador de un pincel, UnrealizeObject dirige al sistema para restablecer el origen del pincel la próxima vez que se seleccione. Si el parámetro hgdiobj es un identificador de una paleta lógica, UnrealizeObject dirige al sistema para que se dé cuenta de la paleta como si no se hubiera realizado anteriormente. La próxima vez que la aplicación llame a la función RealizePalette para la paleta especificada, el sistema reasigna completamente la paleta lógica a la paleta del sistema.

Sintaxis

BOOL UnrealizeObject(
       HGDIOBJ h
);

Parámetros

h

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero.

Comentarios

La función UnrealizeObject no debe usarse con objetos stock. Por ejemplo, la paleta predeterminada, obtenida llamando a GetStockObject (DEFAULT_PALETTE), es un objeto stock.

Una paleta identificada por hgdiobj puede ser la paleta seleccionada actualmente de un contexto de dispositivo.

Si hgdiobj es un pincel, UnrealizeObject no hace nada y la función devuelve TRUE. Use SetBrushOrgEx para establecer el origen de un 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

Funciones de color

Información general sobre colores

GetStockObject

RealizePalette

SetBrushOrgEx