Перечисление состояния (gdiplustypes.h)

  • Статья

Перечисление Status указывает результат вызова метода Windows GDI+.

Синтаксис

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

Константы

 
Ok
Значение: 0
Указывает, что вызов метода выполнен успешно.
GenericError
Значение: 1
Указывает, что в вызове метода произошла ошибка, которая идентифицируется как нечто, отличное от тех, которые определены другими элементами этого перечисления.
InvalidParameter
Значение: 2
Указывает, что один из аргументов, переданных методу, был недопустимым.
OutOfMemory
Значение: 3
Указывает, что операционная система не имеет памяти и не может выделить память для обработки вызова метода. Описание того, как конструкторы используют состояние OutOfMemory , см. в разделе Примечания в конце этой статьи.
ObjectBusy
Значение: 4
Указывает, что один из аргументов, указанных в вызове API, уже используется в другом потоке.
InsufficientBuffer
Значение: 5
Указывает, что буфер, указанный в качестве аргумента в вызове API, недостаточно велик для хранения получаемых данных.
NotImplemented
Значение: 6
Указывает, что метод не реализован.
Win32Error
Значение: 7
Указывает, что метод вызвал ошибку Win32.
WrongState
Значение: 8
Указывает, что объект находится в недопустимом состоянии для удовлетворения вызова API. Например, вызов
Перо::GetColor из пера, которое не является одним сплошным цветом, приводит к состоянию WrongState .
Aborted
Значение: 9
Указывает, что метод был прерван.
FileNotFound
Значение: 10
Указывает, что не удается найти указанный файл изображения или метафайл.
ValueOverflow
Значение: 11
Указывает, что метод выполнил арифметическую операцию, которая вызвала числовое переполнение.
AccessDenied
Значение: 12
Указывает, что операция записи не разрешена для указанного файла.
UnknownImageFormat
Значение: 13
Указывает, что указанный формат файла изображения неизвестен.
FontFamilyNotFound
Значение: 14
Указывает, что не удается найти указанное семейство шрифтов. Неправильное имя семейства шрифтов или семейство шрифтов не установлено.
FontStyleNotFound
Значение: 15
Указывает, что указанный стиль недоступен для указанного семейства шрифтов.
NotTrueTypeFont
Значение: 16
Указывает, что шрифт, полученный из
HDC или
LOGFONT не является шрифтом TrueType и не может использоваться с GDI+.
UnsupportedGdiplusVersion
Значение: 17
Указывает, что версия GDI+, установленная в системе, несовместима с версией, с которой компилировалось приложение.
GdiplusNotInitialized
Значение: 18
Указывает, что GDI+API не находится в инициализированном состоянии. Для работы все объекты GDI+ требуют, чтобы GDI+ был в инициализированном состоянии. Инициализация GDI+ путем вызова
GdiplusStartup.
PropertyNotFound
Значение: 19
Указывает, что указанное свойство не существует в изображении.
PropertyNotSupported
Значение: 20
Указывает, что указанное свойство не поддерживается форматом изображения и, следовательно, не может быть задано.
ProfileNotFound
Значение: 21
Указывает, что не найден цветовой профиль, необходимый для сохранения изображения в формате CMYK.

Комментарии

Если вы создаете объект GDI+, а затем немедленно вызываете метод GetLastStatus этого объекта, можно определить, был ли конструктор успешным или неудачным. В таких случаях GetLastStatus может возвращать OutOfMemory , даже если для создания объекта было доступно много памяти. Несколько конструкторов GDI+ устанавливают состояние OutOfMemory при сбое независимо от причины сбоя.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Верхняя часть gdiplustypes.h (включая Gdiplus.h)