Compartilhar via


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

Visão geral dos contextos do dispositivo

Selectobject