Enumerazione status (gdiplustypes.h)

L'enumerazione Status indica il risultato di una chiamata al metodo GDI+ di Windows.

Sintassi

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
} ;

Costanti

Ok Valore: 0 Indica che la chiamata al metodo ha avuto esito positivo.
GenericError Valore: 1 Indica che si è verificato un errore nella chiamata al metodo, che viene identificato come qualcosa di diverso da quelli definiti dagli altri elementi di questa enumerazione.
InvalidParameter Valore: 2 Indica che uno degli argomenti passati al metodo non è valido.
OutOfMemory Valore: 3 Indica che il sistema operativo non è in memoria e non è stato in grado di allocare memoria per elaborare la chiamata al metodo. Per una spiegazione del modo in cui i costruttori usano lo stato OutOfMemory , vedere la sezione Osservazioni alla fine di questo argomento.
ObjectBusy Valore: 4 Indica che uno degli argomenti specificati nella chiamata API è già in uso in un altro thread.
InsufficientBuffer Valore: 5 Indica che un buffer specificato come argomento nella chiamata API non è sufficientemente grande da contenere i dati da ricevere.
NotImplemented Valore: 6 Indica che il metodo non è implementato.
Win32Error Valore: 7 Indica che il metodo ha generato un errore Win32.
WrongState Valore: 8 Indica che l'oggetto è in uno stato non valido per soddisfare la chiamata API. Ad esempio, chiamando Pen::GetColor da una penna che non è un singolo colore a tinta unita genera uno stato WrongState .
Aborted Valore: 9 Indica che il metodo è stato interrotto.
FileNotFound Valore: 10 Indica che non è possibile trovare il file di immagine o il metafile specificato.
ValueOverflow Valore: 11 Indica che il metodo ha eseguito un'operazione aritmetica che ha generato un overflow numerico.
AccessDenied Valore: 12 Indica che un'operazione di scrittura non è consentita nel file specificato.
UnknownImageFormat Valore: 13 Indica che il formato di file di immagine specificato non è noto.
FontFamilyNotFound Valore: 14 Indica che non è possibile trovare la famiglia di caratteri specificata. Il nome della famiglia di caratteri non è corretto o la famiglia di caratteri non è installata.
FontStyleNotFound Valore: 15 Indica che lo stile specificato non è disponibile per la famiglia di caratteri specificata.
NotTrueTypeFont Valore: 16 Indica che il tipo di carattere recuperato da un oggetto HDC o LOGFONT non è un tipo di carattere TrueType e non può essere usato con GDI+.
UnsupportedGdiplusVersion Valore: 17 Indica che la versione di GDI+ installata nel sistema non è compatibile con la versione con cui è stata compilata l'applicazione.
GdiplusNotInitialized Valore: 18 Indica che L'API GDI+non è in uno stato inizializzato. Per funzionare, tutti gli oggetti GDI+ richiedono che GDI+ sia in uno stato inizializzato. Inizializzare GDI+ chiamando GdiplusStartup.
PropertyNotFound Valore: 19 Indica che la proprietà specificata non esiste nell'immagine.
PropertyNotSupported Valore: 20 Indica che la proprietà specificata non è supportata dal formato dell'immagine e pertanto non può essere impostata.
ProfileNotFound Valore: 21 Indica che il profilo colore necessario per salvare un'immagine in formato CMYK non è stata trovata.

Commenti

Se si costruisce un oggetto GDI+ e quindi si chiama immediatamente il metodo GetLastStatus di tale oggetto, è possibile determinare se il costruttore ha avuto esito positivo o negativo. In questi casi, GetLastStatus potrebbe restituire OutOfMemory anche se è disponibile molta memoria per creare l'oggetto. Diversi costruttori GDI+ impostano lo stato su OutOfMemory quando hanno esito negativo indipendentemente dal motivo dell'errore.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Intestazione	gdiplustypes.h (include Gdiplus.h)