ImgDlog_SavingOptions¶
imgDocRef | Text | The image document reference. |
savingOptionsPtr | Pointer | Pointer to the format options object. |
formatListPtr | Pointer | Pointer to the array of format iDs. |
success | Longint | Completion status: 1 on success, 0 otherwise. |
Display the image format saving options dialog for an image document, and return the options selected by the user.
Parameter imgDocRef
is the reference to the image document for which
to display the saving options.
If imgDocRef
is a valid image document reference, the options displayed in
the dialog are adjusted to the characteristics and edited state of the document.
imgDocRef
may be an NULL reference (an empty string), in which case the
dialog displays generic saving options for the selected format.
The savingOptionsPtr
parameter is a pointer to a 4D object containing
the saving options. On entry, these options are used to set the initial state of
the dialog. On successful completion, the 4D object will contain the options
selected by the user.
The options 4D object may contain the encoding properties supported by the
ImgDoc_SaveInBLOB
method.
The optional formatListPtr
parameter is a pointer to a text array containing
the identifiers of the formats that will be available in the dialog. Can be
used to restrict the available export formats. If not specified, all supported
formats are listed.
If the user accepts the dialog, 1
is returned in success
, 0
otherwise.