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

  • Статья
  • Чтение занимает 2 мин

Перечисление 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)