UnrealizeObject, fonction (wingdi.h)
La fonction UnrealizeObject réinitialise l’origine d’un pinceau ou réinitialise une palette logique. Si le paramètre hgdiobj est un handle pour un pinceau, UnrealizeObject indique au système de réinitialiser l’origine du pinceau la prochaine fois qu’il est sélectionné. Si le paramètre hgdiobj est un handle pour une palette logique, UnrealizeObject indique au système de réaliser la palette comme si elle n’avait pas été réalisée précédemment. La prochaine fois que l’application appelle la fonction RealizePalette pour la palette spécifiée, le système remappe complètement la palette logique sur la palette système.
Syntaxe
BOOL UnrealizeObject(
HGDIOBJ h
);
Paramètres
h
Valeur retournée
Si la fonction réussit, la valeur de retour est différente de zéro.
Si la fonction échoue, la valeur de retour est égale à zéro.
Remarques
La fonction UnrealizeObject ne doit pas être utilisée avec les objets stock. Par exemple, la palette par défaut, obtenue en appelant GetStockObject (DEFAULT_PALETTE), est un objet stock.
Une palette identifiée par hgdiobj peut être la palette actuellement sélectionnée d’un contexte d’appareil.
Si hgdiobj est un pinceau, UnrealizeObject ne fait rien et la fonction retourne TRUE. Utilisez SetBrushOrgEx pour définir l’origine d’un pinceau.
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 |