状态枚举 (gdiplustypes.h)

状态枚举指示 Windows GDI+ 方法调用的结果。

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

Constants

 
Ok
值:0
指示方法调用成功。
GenericError
值:1
指示方法调用中存在错误,该方法被标识为此枚举的其他元素定义的错误。
InvalidParameter
值:2
指示传递给方法的参数之一无效。
OutOfMemory
值: 3
指示作系统内存不足,无法分配内存来处理方法调用。 有关如何使用 OutOfMemory 状态的构造函数的说明,请参阅本主题末尾的“备注”部分。
ObjectBusy
值: 4
指示 API 调用中指定的某个参数已在另一个线程中使用。
InsufficientBuffer
值:5
指示在 API 调用中指定为参数的缓冲区不够大,无法容纳要接收的数据。
NotImplemented
值: 6
指示未实现该方法。
Win32Error
值: 7
指示该方法生成了 Win32 错误。
WrongState
值: 8
指示对象处于无效状态以满足 API 调用。 例如,调用
Pen::GetColor 来自不是单个纯色的笔会导致 错误状态
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 ,而不考虑失败的原因。

要求

Requirement 价值
最低支持的客户端 Windows Vista [仅限桌面应用]
支持的最低服务器 Windows Server 2008 [仅限桌面应用]
Header gdiplustypes.h (包括 Gdiplus.h)