Énumération d’état (gdiplustypes.h)
L’énumération Status indique le résultat d’un appel de méthode Windows GDI+.
Syntaxe
typedef enum Status {
Ok = 0,
GenericError = 1,
InvalidParameter = 2,
OutOfMemory = 3,
ObjectBusy = 4,
InsufficientBuffer = 5,
NotImplemented = 6,
Win32Error = 7,
WrongState = 8,
Aborted = 9,
FileNotFound = 10,
ValueOverflow = 11,
AccessDenied = 12,
UnknownImageFormat = 13,
FontFamilyNotFound = 14,
FontStyleNotFound = 15,
NotTrueTypeFont = 16,
UnsupportedGdiplusVersion = 17,
GdiplusNotInitialized = 18,
PropertyNotFound = 19,
PropertyNotSupported = 20,
ProfileNotFound = 21
} ;
Constantes
Ok Valeur : 0 Indique que l’appel de méthode a réussi. |
GenericError Valeur : 1 Indique qu’il y a eu une erreur sur l’appel de méthode, qui est identifié comme quelque chose d’autre que ceux définis par les autres éléments de cette énumération. |
InvalidParameter Valeur : 2 Indique qu’un des arguments passés à la méthode n’était pas valide. |
OutOfMemory Valeur : 3 Indique que le système d’exploitation est hors mémoire et n’a pas pu allouer de mémoire pour traiter l’appel de méthode. Pour obtenir une explication de la façon dont les constructeurs utilisent l’état OutOfMemory , consultez la section Notes à la fin de cette rubrique. |
ObjectBusy Valeur : 4 Indique qu’un des arguments spécifiés dans l’appel d’API est déjà utilisé dans un autre thread. |
InsufficientBuffer Valeur : 5 Indique qu’une mémoire tampon spécifiée comme argument dans l’appel d’API n’est pas suffisamment grande pour contenir les données à recevoir. |
NotImplemented Valeur : 6 Indique que la méthode n’est pas implémentée. |
Win32Error Valeur : 7 Indique que la méthode a généré une erreur Win32. |
WrongState Valeur : 8 Indique que l’objet est dans un état non valide pour satisfaire l’appel d’API. Par exemple, appel Pen::GetColor à partir d’un stylet qui n’est pas une seule couleur unie entraîne un état WrongState . |
Aborted Valeur : 9 Indique que la méthode a été abandonnée. |
FileNotFound Valeur : 10 Indique que le fichier image ou le métafichier spécifié ne peuvent pas être trouvés. |
ValueOverflow Valeur : 11 Indique que la méthode a effectué une opération arithmétique qui a produit un dépassement numérique. |
AccessDenied Valeur : 12 Indique qu’une opération d’écriture n’est pas autorisée sur le fichier spécifié. |
UnknownImageFormat Valeur : 13 Indique que le format de fichier image spécifié n’est pas connu. |
FontFamilyNotFound Valeur : 14 Indique que la famille de polices spécifiée est introuvable. Le nom de la famille de polices est incorrect ou la famille de polices n’est pas installée. |
FontStyleNotFound Valeur : 15 Indique que le style spécifié n’est pas disponible pour la famille de polices spécifiée. |
NotTrueTypeFont Valeur : 16 Indique que la police récupérée à partir d’un HDC ou LOGFONT n’est pas une police TrueType et ne peut pas être utilisée avec GDI+. |
UnsupportedGdiplusVersion Valeur : 17 Indique que la version de GDI+ installée sur le système n’est pas compatible avec la version avec laquelle l’application a été compilée. |
GdiplusNotInitialized Valeur : 18 Indique que l’API GDI+n’est pas dans un état initialisé. Pour fonctionner, tous les objets GDI+ nécessitent que GDI+ soit dans un état initialisé. Initialiser GDI+ en appelant GdiplusStartup. |
PropertyNotFound Valeur : 19 Indique que la propriété spécifiée n’existe pas dans l’image. |
PropertyNotSupported Valeur : 20 Indique que la propriété spécifiée n’est pas prise en charge par le format de l’image et, par conséquent, ne peut pas être définie. |
ProfileNotFound Valeur : 21 Indique que le profil de couleur requis pour enregistrer une image au format CMYK n’a pas été trouvé. |
Notes
Si vous construisez un objet GDI+, puis appelez immédiatement la méthode GetLastStatus de cet objet, vous pouvez déterminer si le constructeur a réussi ou échoué. Dans ce cas, GetLastStatus peut renvoyer OutOfMemory même s’il y avait beaucoup de mémoire disponible pour créer l’objet. Plusieurs constructeurs GDI+ définissent l’état sur OutOfMemory lorsqu’ils échouent, quelle que soit la raison de l’échec.
Configuration requise
Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
En-tête | gdiplustypes.h (include Gdiplus.h) |