Enumeração de status (gdiplustypes.h)

A enumeração Status indica o resultado de uma chamada de método GDI+ do 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 a chamada de método foi bem-sucedida.
GenericError Valor: 1 Indica que houve um erro na chamada de método, que é identificado como algo diferente daqueles definidos pelos outros elementos dessa enumeração.
InvalidParameter Valor: 2 Indica que um dos argumentos passados para o método não era válido.
OutOfMemory Valor: 3 Indica que o sistema operacional está sem memória e não pôde alocar memória para processar a chamada de método. Para obter uma explicação de como os construtores usam o status OutOfMemory, consulte a seção Comentários no final deste tópico.
ObjectBusy Valor: 4 Indica que um dos argumentos especificados na chamada à API já está em uso em outro thread.
InsufficientBuffer Valor: 5 Indica que um buffer especificado como um argumento na chamada à API não é grande o suficiente para manter os dados a serem recebidos.
NotImplemented Valor: 6 Indica que o método não está implementado.
Win32Error Valor: 7 Indica que o método gerou um erro win32.
WrongState Valor: 8 Indica que o objeto está em um estado inválido para atender à chamada à API. Por exemplo, chamar Pen::GetColor de uma caneta que não é uma única cor sólida resulta em um status WrongState.
Aborted Valor: 9 Indica que o método foi anulado.
FileNotFound Valor: 10 Indica que o arquivo de imagem ou o meta-arquivo especificado não pode ser encontrado.
ValueOverflow Valor: 11 Indica que o método executou uma operação aritmética que produziu um estouro numérico.
AccessDenied Valor: 12 Indica que uma operação de gravação não é permitida no arquivo especificado.
UnknownImageFormat Valor: 13 Indica que o formato de arquivo de imagem especificado não é conhecido.
FontFamilyNotFound Valor: 14 Indica que a família de fontes especificada não pode ser encontrada. O nome da família de fontes está incorreto ou a família de fontes não está instalada.
FontStyleNotFound Valor: 15 Indica que o estilo especificado não está disponível para a família de fontes especificada.
NotTrueTypeFont Valor: 16 Indica que a fonte foi recuperada de um HDC ou LOGFONT não é uma fonte TrueType e não pode ser usado com GDI+.
UnsupportedGdiplusVersion Valor: 17 Indica que a versão do GDI+ instalada no sistema é incompatível com a versão com a qual o aplicativo foi compilado.
GdiplusNotInitialized Valor: 18 Indica que a GDI+API não está em um estado inicializado. Para funcionar, todos os objetos GDI+ exigem que o GDI+ esteja em um estado inicializado. Inicializar GDI+ chamando GdiplusStartup.
PropertyNotFound Valor: 19 Indica que a propriedade especificada não existe na imagem.
PropertyNotSupported Valor: 20 Indica que a propriedade especificada não tem suporte no formato da imagem e, portanto, não pode ser definida.
ProfileNotFound Valor: 21 Indica que o perfil de cor necessário para salvar uma imagem no formato CMYK não foi encontrado.

Comentários

Se você construir um objeto GDI+ e chamar imediatamente o método GetLastStatus desse objeto, poderá determinar se o construtor teve êxito ou falhou. Nesses casos, GetLastStatus pode retornar OutOfMemory mesmo que houvesse muita memória disponível para criar o objeto. Vários construtores GDI+ definem o status como OutOfMemory quando falham, independentemente do motivo da falha.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho	gdiplustypes.h (inclua Gdiplus.h)