Função DeleteObject (wingdi.h)
A função DeleteObject exclui uma caneta lógica, pincel, fonte, bitmap, região ou paleta, liberando todos os recursos do sistema associados ao objeto. Depois que o objeto é excluído, o identificador especificado não é mais válido.
Sintaxe
BOOL DeleteObject(
[in] HGDIOBJ ho
);
Parâmetros
[in] ho
Um identificador para uma caneta lógica, pincel, fonte, bitmap, região ou paleta.
Valor retornado
Se a função for bem-sucedida, o valor retornado será diferente de zero.
Se o identificador especificado não for válido ou estiver selecionado atualmente em um DC, o valor retornado será zero.
Comentários
Não exclua um objeto de desenho (caneta ou pincel) enquanto ele ainda estiver selecionado em um DC.
Quando um pincel de padrão é excluído, o bitmap associado ao pincel não é excluído. O bitmap deve ser excluído independentemente.
Exemplos
Para obter um exemplo, consulte Criando canetas e pincéis coloridos.
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 contexto do dispositivo