Enumeração de status (gdiplustypes.h)

  • Artigo

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)