Função UnrealizeObject (wingdi.h)

A função UnrealizeObject redefine a origem de um pincel ou redefine uma paleta lógica. Se o parâmetro hgdiobj for um identificador para um pincel, UnrealizeObject direcionará o sistema para redefinir a origem do pincel na próxima vez que ele for selecionado. Se o parâmetro hgdiobj for um identificador para uma paleta lógica, UnrealizeObject orientará o sistema a realizar a paleta como se não tivesse sido realizada anteriormente. Na próxima vez que o aplicativo chamar a função RealizePalette para a paleta especificada, o sistema remapea completamente a paleta lógica para a paleta do sistema.

Sintaxe

BOOL UnrealizeObject(
       HGDIOBJ h
);

Parâmetros

h

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero.

Comentários

A função UnrealizeObject não deve ser usada com objetos de estoque. Por exemplo, a paleta padrão, obtida chamando GetStockObject (DEFAULT_PALETTE), é um objeto de estoque.

Uma paleta identificada por hgdiobj pode ser a paleta selecionada no momento de um contexto de dispositivo.

Se hgdiobj for um pincel, UnrealizeObject não fará nada e a função retornará TRUE. Use SetBrushOrgEx para definir a origem de um pincel.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho wingdi.h (inclua Windows.h)
Biblioteca Gdi32.lib
DLL Gdi32.dll

Confira também

Funções de cor

Visão geral de cores

Getstockobject

Realizepalette

Setbrushorgex