Énumération d’état (gdiplustypes.h)

  • Article

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)