Method

ExportPicture


Description

Exports an object of type Picture.

Usage

result=ExportPicture(pic)

Part

Type

Description

result

Boolean

True if the picture was saved successfully; False if the picture was not saved.

pic

Picture

A picture.

Notes

When ExportPicture is called, it displays a save-file dialog box so the user can save the picture in any directory. The user can also use the dialog box to choose a picture format. When the user chooses a format, the appropriate extension is automatically added to the filename.

ExportPicture returns True if the picture was saved; if the user clicks cancel, ExportPicture returns False.


Windows

The BMP format is supported on Windows.


Macos

The jpeg and png formats are supported on macOS.


Linux

The BMP format is supported on Linux.

Sample code

The following code allows the user to save a picture. The jpeg file type has already been defined as a File Type using either the FileType class or the File Types Sets Editor in the IDE. It is referred to by the name of the object.

Var p As Picture
Var r As Boolean
Var f As FolderItem
f = FolderItem.ShowOpenFileDialog(FileTypes1.Jpeg)
If f <> Nil Then
  p = Picture.Open(f)
  r = ExportPicture(p)
  If r Then
    MessageBox("Your picture was saved.")
  Else
    MessageBox("Your picture was not saved.")
  End If
End If

Compatibility

All project types on all supported operating systems.

See also

Picture, FolderItem classes.