Gambar::Save(constWCHAR,constCLSID,constEncoderParameters*) metode (gdiplusheaders.h)

Artikel
02/29/2024

Metode Image::Save menyimpan gambar ini ke file.

Sintaks

Status Save(
  const WCHAR             *filename,
  const CLSID             *clsidEncoder,
  const EncoderParameters *encoderParams
);

Parameter

filename

Penunjuk ke string yang dihentikan null yang menentukan nama jalur untuk gambar yang disimpan.

clsidEncoder

Penunjuk ke CLSID yang menentukan encoder yang akan digunakan untuk menyimpan gambar.

encoderParams

Opsional. Penunjuk ke objek EncoderParameters yang menyimpan parameter yang digunakan oleh encoder. Nilai defaultnya adalah NULL.

Nilai kembali

Jenis: Status

Jika metode berhasil, metode mengembalikan Ok, yang merupakan elemen dari enumerasi Status .

Jika metode gagal, metode mengembalikan salah satu elemen lain dari enumerasi Status .

Keterangan

GDI+ tidak memungkinkan Anda menyimpan gambar ke file yang sama dengan yang Anda gunakan untuk membuat gambar. Kode berikut membuat objek Gambar dengan meneruskan nama MyImage.jpg file ke konstruktor Gambar . Nama file yang sama diteruskan ke metode Gambar::Simpan objek Gambar, sehingga metode Gambar::Simpan gagal.

Image image(L"myImage.jpg");

// Do other operations.

// Save the image to the same file name. (This operation will fail.)
image.Save(L"myImage.jpg", ...);

Contoh

Contoh berikut membuat objek Gambar dari file PNG lalu membuat objek Grafis berdasarkan objek Gambar tersebut. Kode menggambar gambar, mengubah gambar, dan menggambar gambar lagi. Akhirnya, kode menyimpan gambar yang diubah ke file.

Kode ini bergantung pada fungsi pembantu, GetEncoderClsid, untuk mendapatkan pengidentifikasi kelas untuk encoder PNG. Fungsi GetEncoderClsid ditampilkan dalam Mengambil Pengidentifikasi Kelas untuk Encoder.

Teknik membangun objek Grafis berdasarkan gambar hanya berfungsi untuk format gambar tertentu. Misalnya, Anda tidak dapat membuat objek Grafis berdasarkan gambar yang memiliki kedalaman warna 4 bit per piksel. Untuk informasi selengkapnya tentang format mana yang didukung oleh konstruktor Grafis , lihat Grafik.

VOID Example_SaveFile(HDC hdc)
{
   Graphics graphics(hdc);

   // Create an Image object based on a PNG file.
   Image  image(L"Mosaic.png");

   // Draw the image.
   graphics.DrawImage(&image, 10, 10);

   // Construct a Graphics object based on the image.
   Graphics imageGraphics(&image);

   // Alter the image.
   SolidBrush brush(Color(255, 0, 0, 255));
   imageGraphics.FillEllipse(&brush, 20, 30, 80, 50);

   // Draw the altered image.
   graphics.DrawImage(&image, 200, 10);

   // Save the altered image.
   CLSID pngClsid;
   GetEncoderClsid(L"image/png", &pngClsid);
   image.Save(L"Mosaic2.png", &pngClsid, NULL);
}