gdiplustypes.) h (狀態列舉

Status 列舉表示 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
} ;

常數

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 來自不是單一純色的畫筆，會導致 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)