Gambar::SaveAdd(constEncoderParameters*) metode (gdiplusheaders.h)

Artikel
08/24/2023

Metode Image::SaveAdd menambahkan bingkai ke file atau aliran yang ditentukan dalam panggilan sebelumnya ke metode Simpan . Gunakan metode ini untuk menyimpan bingkai yang dipilih dari gambar multi-bingkai ke gambar multi-bingkai lainnya.

Sintaks

Status SaveAdd(
  const EncoderParameters *encoderParams
);

Parameter

encoderParams

Arahkan ke objek EncoderParameters yang menyimpan parameter yang diperlukan oleh encoder gambar yang digunakan oleh operasi simpan-tambahkan.

Menampilkan nilai

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

Contoh

Contoh berikut membuat objek Gambar berdasarkan file TIFF yang memiliki empat bingkai. Kode memanggil metode Image::SelectActiveFrame untuk menavigasi ke bingkai kedua dalam dimensi halaman objek Gambar tersebut. (Dimensi halaman adalah satu-satunya dimensi dalam hal ini.) Kemudian kode memanggil metode Simpan untuk menyimpan bingkai kedua ke file baru bernama TwoFrames.tif. Kode memanggil metode Image::SelectActiveFrame lagi untuk menavigasi ke bingkai keempat objek Gambar. Kemudian kode memanggil metode Image::SaveAdd untuk menambahkan bingkai keempat ke TwoFrames.tif. Kode memanggil metode Image::SaveAdd untuk kedua kalinya untuk menutup TwoFrames.tif, lalu menggambar dua bingkai yang disimpan dalam file tersebut.

VOID Example_SaveAdd(HDC hdc)
{
   Graphics graphics(hdc);
   EncoderParameters encoderParameters;
   ULONG parameterValue;
   GUID dimension = FrameDimensionPage;

   // An EncoderParameters object has an array of
   // EncoderParameter objects. In this case, there is only
   // one EncoderParameter object in the array.
   encoderParameters.Count = 1;

   // Initialize the one EncoderParameter object.
   encoderParameters.Parameter[0].Guid = EncoderSaveFlag;
   encoderParameters.Parameter[0].Type = EncoderParameterValueTypeLong;
   encoderParameters.Parameter[0].NumberOfValues = 1;
   encoderParameters.Parameter[0].Value = &parameterValue;

   // Get the CLSID of the TIFF encoder.
   CLSID encoderClsid;
   GetEncoderClsid(L"image/tiff", &encoderClsid);

   // Create an image object based on a TIFF file that has four frames.
   Image fourFrames(L"FourFrames.tif");

   // Save the second page (frame).
   parameterValue = EncoderValueMultiFrame;
   fourFrames.SelectActiveFrame(&dimension, 1);
   fourFrames.Save(L"TwoFrames.tif", &encoderClsid, &encoderParameters);

   // Save the fourth page (frame).
   parameterValue = EncoderValueFrameDimensionPage;
   fourFrames.SelectActiveFrame(&dimension, 3);
   fourFrames.SaveAdd(&encoderParameters);

   // Close the multiframe file.
   parameterValue = EncoderValueFlush;
   fourFrames.SaveAdd(&encoderParameters);

   // Draw the two frames of TwoFrames.tif.
   Image twoFrames(L"TwoFrames.tif");
   twoFrames.SelectActiveFrame(&dimension, 0);
   graphics.DrawImage(&twoFrames, 10, 10);
   twoFrames.SelectActiveFrame(&dimension, 1);
   graphics.DrawImage(&twoFrames, 150, 10);
}