Enumeración status (gdiplustypes.h)

  • Artículo

La enumeración Status indica el resultado de una llamada al método GDI+ de Windows.

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
Valor: 0
Indica que la llamada al método se realizó correctamente.
GenericError
Valor: 1
Indica que se produjo un error en la llamada al método , que se identifica como algo distinto de los definidos por los demás elementos de esta enumeración.
InvalidParameter
Valor: 2
Indica que uno de los argumentos pasados al método no era válido.
OutOfMemory
Valor: 3
Indica que el sistema operativo está sin memoria y no pudo asignar memoria para procesar la llamada al método. Para obtener una explicación de cómo los constructores usan el estado OutOfMemory , vea la sección Comentarios al final de este tema.
ObjectBusy
Valor: 4
Indica que uno de los argumentos especificados en la llamada API ya está en uso en otro subproceso.
InsufficientBuffer
Valor: 5
Indica que un búfer especificado como argumento en la llamada API no es lo suficientemente grande como para contener los datos que se van a recibir.
NotImplemented
Valor: 6
Indica que el método no está implementado.
Win32Error
Valor: 7
Indica que el método generó un error win32.
WrongState
Valor: 8
Indica que el objeto está en un estado no válido para satisfacer la llamada API. Por ejemplo, llamar a
Pen::GetColor de un lápiz que no es un único color sólido da como resultado un estado WrongState .
Aborted
Valor: 9
Indica que se anuló el método.
FileNotFound
Valor: 10
Indica que no se encuentra el archivo de imagen o el metarchivo especificados.
ValueOverflow
Valor: 11
Indica que el método realizó una operación aritmética que generó un desbordamiento numérico.
AccessDenied
Valor: 12
Indica que no se permite una operación de escritura en el archivo especificado.
UnknownImageFormat
Valor: 13
Indica que no se conoce el formato de archivo de imagen especificado.
FontFamilyNotFound
Valor: 14
Indica que no se encuentra la familia de fuentes especificada. El nombre de familia de fuentes es incorrecto o la familia de fuentes no está instalada.
FontStyleNotFound
Valor: 15
Indica que el estilo especificado no está disponible para la familia de fuentes especificada.
NotTrueTypeFont
Valor: 16
Indica que la fuente recuperada de un
HDC o
LOGFONT no es una fuente TrueType y no se puede usar con GDI+.
UnsupportedGdiplusVersion
Valor: 17
Indica que la versión de GDI+ instalada en el sistema no es compatible con la versión con la que se compiló la aplicación.
GdiplusNotInitialized
Valor: 18
Indica que la API de GDI+no está en un estado inicializado. Para funcionar, todos los objetos GDI+ requieren que GDI+ esté en un estado inicializado. Inicialización de GDI+ mediante una llamada a
GdiplusStartup.
PropertyNotFound
Valor: 19
Indica que la propiedad especificada no existe en la imagen.
PropertyNotSupported
Valor: 20
Indica que el formato de la imagen no admite la propiedad especificada y, por lo tanto, no se puede establecer.
ProfileNotFound
Valor: 21
Indica que no se encontró el perfil de color necesario para guardar una imagen en formato CMYK.

Comentarios

Si construye un objeto GDI+ y, a continuación, llama inmediatamente al método GetLastStatus de ese objeto, puede determinar si el constructor se realizó correctamente o no. En tales casos, GetLastStatus puede devolver OutOfMemory aunque haya mucha memoria disponible para crear el objeto. Varios constructores de GDI+ establecen el estado en OutOfMemory cuando fallan independientemente del motivo del error.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado gdiplustypes.h (include Gdiplus.h)