Fonction DeleteObject (wingdi.h)

La fonction DeleteObject supprime un stylet logique, un pinceau, une police, une bitmap, une région ou une palette, libérant toutes les ressources système associées à l’objet. Une fois l’objet supprimé, le handle spécifié n’est plus valide.

Syntaxe

BOOL DeleteObject(
  [in] HGDIOBJ ho
);

Paramètres

[in] ho

Poignée d’un stylet logique, d’un pinceau, d’une police, d’une bitmap, d’une région ou d’une palette.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si le handle spécifié n’est pas valide ou est actuellement sélectionné dans un contrôleur de domaine, la valeur de retour est zéro.

Remarques

Ne supprimez pas un objet dessin (stylet ou pinceau) alors qu’il est toujours sélectionné dans un contrôleur de domaine.

Lorsqu’un pinceau de modèle est supprimé, l’image bitmap associée au pinceau n’est pas supprimée. La bitmap doit être supprimée indépendamment.

Exemples

Pour obtenir un exemple, consultez Création de stylets et de pinceaux colorés.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wingdi.h (inclure Windows.h)
Bibliothèque	Gdi32.lib
DLL	Gdi32.dll

Voir aussi

Fonctions de contexte d’appareil

Vue d’ensemble des contextes d’appareil

SélectionnerObject