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

  • Article

L’énumération Status indique le résultat d’un appel de méthode Windows GDI+.

Syntax

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 autre chose que ceux définis par les autres éléments de cette énumération.
InvalidParameter
Valeur : 2
Indique que l’un des arguments passés à la méthode n’était pas valide.
OutOfMemory
Valeur : 3
Indique que le système d’exploitation est en mémoire insuffisante et qu’il 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 les status OutOfMemory, consultez la section Remarques à 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 en tant qu’argument dans l’appel d’API n’est pas assez 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, appeler
Stylet ::GetColor à partir d’un stylet qui n’est pas une seule couleur unie entraîne une status WrongState.
Aborted
Valeur : 9
Indique que la méthode a été abandonnée.
FileNotFound
Valeur : 10
Indique que le fichier image ou métafichier spécifié est introuvable.
ValueOverflow
Valeur : 11
Indique que la méthode a effectué une opération arithmétique qui a produit un dépassement de capacité 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é avec GDI+.
UnsupportedGdiplusVersion
Valeur : 17
Indique que la version de GDI+ installée sur le système est incompatible avec la version avec laquelle l’application a été compilée.
GdiplusNotInitialized
Valeur : 18
Indique que GDI+API 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 CMJN est introuvable.

Remarques

Si vous construisez un objet GDI+ et que vous 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 le status sur OutOfMemory lorsqu’ils échouent, quelle que soit la raison de l’échec.

Configuration requise

Condition requise Valeur
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 (inclure Gdiplus.h)