状态枚举 (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 不是单一纯色的笔会导致 错误状态 。 |
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) |