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
} ;
Constants
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+ 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） |