SSSavePicture Function

---

See Also    ActiveX    Example

Applies To

fpSpread DLL control

Description

Saves a picture to the specified file.

Syntax

HANDLE SSSavePicture(HANDLE hPict, HPALETTE hPal, LPCTSTR lpszFileName, short nSaveType);

BOOL TSpread::SavePicture(HANDLE hPict, HPALETTE hPal, LPCTSTR lpszFileName, short nSaveType);

Parameters

The following parameters are available:

Parameter	Description
hPict	Picture to save to file
hPal	Handle to palette to use with picture (This value can be 0 if no palette is to be used.)
lpszFileName	Path and file name of picture file to save
nSaveType	Graphic type of file to save Can be one of the following:
	Constant	Value	Description
	SS_PICTURE_TYPE_BMP	1	Windows Bitmap graphic
	SS_PICTURE_TYPE_GIF	2	Graphics Interchange Format graphic
	SS_PICTURE_TYPE_JPEG	3	Joint Photographic Experts Group graphic
	SS_PICTURE_TYPE_PNG	4	Portable Network Graphic graphic
	SS_PICTURE_TYPE_ICO	5	Windows Icon graphic
	SS_PICTURE_TYPE_TIFF	6	Tagged Image File Format graphic
	SS_PICTURE_TYPE_TGA	7	Truevision Targa graphic
	SS_PICTURE_TYPE_PCX	8	Paintbrush graphics file graphic
	SS_PICTURE_TYPE_WBMP	9	Wireless Bitmap Format graphic (converted to monochrome)
	SS_PICTURE_TYPE_JP2	11	JPEG 2000 graphic
	SS_PICTURE_TYPE_JPC	12	JPEG 2000 graphic

Remarks

Call this function to save a picture to a file.

If you use this function with a picture cell type and there are multiple sheets, call the SSSetSheet function to specify the sheet for which you are calling this function.

Return Value

TRUE if the function completes successfully; FALSE otherwise.

See Also

Creating Picture Cells

SSLoadPicture, SSLoadResPicture, SSSetSheet functions

ActiveX Correspondence

SavePicture method