Enumerazione status (gdiplustypes.h)

  • Articolo

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)