更新 : 2007 年 11 月
イメージを指定されたストリームまたはディスク上のファイルに保存します。
HRESULT Save(
IStream* pStream,
REFGUID guidFileType
) const throw();
HRESULT Save(
LPCTSTR pszFileName,
REFGUID guidFileType= GUID_NULL
) const throw();
パラメータ
pStream
ファイル イメージ データを保持する COM IStream オブジェクトへのポインタ。pszFileName
イメージのファイル名へのポインタ。guidFileType
イメージを保存するときのファイル形式。次のいずれかの値を指定します。ImageFormatBMP 圧縮されていないビットマップ イメージ
ImageFormatPNG PNG (Portable Network Graphic) 形式の圧縮イメージ
ImageFormatJPEG JPEG 形式の圧縮イメージ
ImageFormatGIF GIF 形式の圧縮イメージ
メモ :
定数の一覧については、Windows SDK の「Image File Format Constants」を参照してください。
戻り値
標準の HRESULT を返します。
解説
名前と形式を指定してイメージを保存するには、このメソッドを呼び出します。guidFileType パラメータが指定されていない場合は、ファイル名の拡張子によってイメージ形式が決定します。拡張子が指定されていない場合は、BMP 形式でイメージが保存されます。
例 :
// Demonstrating saving various file formats
// save an image in BMP format
m_myImage.Save(_T("c:\\temp\\image1.bmp"));
// save an image in BMP format
m_myImage.Save(_T("c:\\temp\\image2"), Gdiplus::ImageFormatBMP);
// save an image in JPEG format
m_myImage.Save(_T("c:\\temp\\image3.jpg"));
// save an image in BMP format, even though jpg file extension is used
m_myImage.Save(_T("c:\\temp\\image4.jpg"), Gdiplus::ImageFormatBMP);
必要条件
ヘッダー : atlimage.h