共用方式為

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)