狀態列舉 (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)