TClrImage.SaveToFile(string) Method

Saves this Image to the specified file or stream.

Namespace: CNClrLib.Control.Graphics
public
 procedure SaveToFile(const Filename: string); overload;

Parameters

Filename
Type: string

A string that contains the name of the file to which to save this Image.

If no encoder exists for the file format of the image, the Portable Network Graphics (PNG) encoder is used. When you use the SaveToFile method to save a graphic image as a Windows Metafile Format (WMF) or Enhanced Metafile Format (EMF) file, the resulting file is saved as a Portable Network Graphics (PNG) file. This behavior occurs because the GDI+ component of the .NET Framework does not have an encoder that you can use to save files as .wmf or .emf files.

Saving the image to the same file it was constructed from is not allowed and throws an exception.