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 |