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

Article
10/05/2022
3 minutes de lecture

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)