狀態列舉 (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 呼叫。 例如，呼叫
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)