SAVEPICTURE( ) Function

See Also

Creates a bitmap (.bmp) file from a picture object reference.

Syntax

SAVEPICTURE(oObjectReference, cFileName)

Returns

Logical

Arguments

oObjectReference

Specifies a picture object reference from which SAVEPICTURE( ) creates a bitmap file.

cFileName

Specifies the name of the bitmap file that SAVEPICTURE( ) creates. If cFileName includes a path, the file is created in the directory specified in the path. If a file with the same name already exists, it is overwritten without warning, even if SET SAFETY is ON. An error message is displayed if the file you specify does not exist.

Remarks

Picture object references are typically created with LOADPICTURE( ). However, certain properties (such as the PictureOpen property for the OLE Outline control) use a default picture object reference which can be used to create a bitmap file.