Enumerasi status (gdiplustypes.h)

  • Artikel

Enumerasi Status menunjukkan hasil panggilan metode Windows GDI+.

Sintaks

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
} ;

Konstanta

 
Ok
Nilai: 0
Menunjukkan bahwa panggilan metode berhasil.
GenericError
Nilai: 1
Menunjukkan bahwa ada kesalahan pada panggilan metode, yang diidentifikasi sebagai sesuatu selain yang didefinisikan oleh elemen lain dari enumerasi ini.
InvalidParameter
Nilai: 2
Menunjukkan bahwa salah satu argumen yang diteruskan ke metode tidak valid.
OutOfMemory
Nilai: 3
Menunjukkan bahwa sistem operasi kehabisan memori dan tidak dapat mengalokasikan memori untuk memproses panggilan metode. Untuk penjelasan tentang bagaimana konstruktor menggunakan status OutOfMemory , lihat bagian Keterangan di akhir topik ini.
ObjectBusy
Nilai: 4
Menunjukkan bahwa salah satu argumen yang ditentukan dalam panggilan API sudah digunakan di utas lain.
InsufficientBuffer
Nilai: 5
Menunjukkan bahwa buffer yang ditentukan sebagai argumen dalam panggilan API tidak cukup besar untuk menyimpan data yang akan diterima.
NotImplemented
Nilai: 6
Menunjukkan bahwa metode tidak diimplementasikan.
Win32Error
Nilai: 7
Menunjukkan bahwa metode menghasilkan kesalahan Win32.
WrongState
Nilai: 8
Menunjukkan bahwa objek dalam status tidak valid untuk memenuhi panggilan API. Misalnya, memanggil
Pena::GetColor dari pena yang bukan satu pun, warna solid menghasilkan status WrongState .
Aborted
Nilai: 9
Menunjukkan bahwa metode dibatalkan.
FileNotFound
Nilai: 10
Menunjukkan bahwa file gambar atau metafile yang ditentukan tidak dapat ditemukan.
ValueOverflow
Nilai: 11
Menunjukkan bahwa metode melakukan operasi aritmatika yang menghasilkan luapan numerik.
AccessDenied
Nilai: 12
Menunjukkan bahwa operasi tulis tidak diizinkan pada file yang ditentukan.
UnknownImageFormat
Nilai: 13
Menunjukkan bahwa format file gambar yang ditentukan tidak diketahui.
FontFamilyNotFound
Nilai: 14
Menunjukkan bahwa keluarga font yang ditentukan tidak dapat ditemukan. Nama keluarga fonta salah atau keluarga fonta tidak diinstal.
FontStyleNotFound
Nilai: 15
Menunjukkan bahwa gaya yang ditentukan tidak tersedia untuk keluarga font yang ditentukan.
NotTrueTypeFont
Nilai: 16
Menunjukkan bahwa font yang diambil dari
HDC atau
LOGFONT bukan font TrueType dan tidak dapat digunakan dengan GDI+.
UnsupportedGdiplusVersion
Nilai: 17
Menunjukkan bahwa versi GDI+ yang diinstal pada sistem tidak kompatibel dengan versi yang aplikasinya dikompilasi.
GdiplusNotInitialized
Nilai: 18
Menunjukkan bahwa GDI+API tidak dalam status diinisialisasi. Agar berfungsi, semua objek GDI+ mengharuskan GDI+ berada dalam status diinisialisasi. Menginisialisasi GDI+ dengan memanggil
GdiplusStartup.
PropertyNotFound
Nilai: 19
Menunjukkan bahwa properti yang ditentukan tidak ada dalam gambar.
PropertyNotSupported
Nilai: 20
Menunjukkan bahwa properti yang ditentukan tidak didukung oleh format gambar dan, oleh karena itu, tidak dapat diatur.
ProfileNotFound
Nilai: 21
Menunjukkan bahwa profil warna yang diperlukan untuk menyimpan gambar dalam format CMYK tidak ditemukan.

Keterangan

Jika Anda membuat objek GDI+ dan kemudian segera memanggil metode GetLastStatus dari objek tersebut, Anda dapat menentukan apakah konstruktor berhasil atau gagal. Dalam kasus seperti itu, GetLastStatus mungkin mengembalikan OutOfMemory meskipun ada banyak memori yang tersedia untuk membuat objek. Beberapa konstruktor GDI+ menetapkan status ke OutOfMemory ketika gagal terlepas dari alasan kegagalan.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 [hanya aplikasi desktop]
Header gdiplustypes.h (termasuk Gdiplus.h)