DTWAIN_SetCustomFileSave

[Note that this is an advanced function that requires programming knowledge of the Windows API "Save As" common dialog box]

The DTWAIN_SetCustomFileSave function allows advanced customization of the "File Save" dialog.

DTWAIN_BOOL  DTWAIN_SetCustomFileSave ( OPENFILENAME* pOpenFileName );

Parameters

Points to an OPENFILENAME structure.

Return Values

If successful, the return value is TRUE.  Otherwise FALSE is returned.

Comments

The DTWAIN_SetCustomFileSave allows an application to set the "File Save" dialog with respect to the options that are set in the pOpenFileName OPENFILENAME structure.  This function should be called by programmers who are familiar with setting up the common File Save dialog using the OPENFILENAME structure.  Consult a Windows API programmer's manual for more information on the OPENFILENAME structure and the usage of this structure in setting up a custom File Save dialog.

The File Save dialog is displayed whenever DTWAIN_AcquireFile or DTWAIN_AcquireFileEx is called with the DTWAIN_USEPROMPT flag set.

TWAIN State Transitions

None

Prerequisite Calls

DTWAIN_SysInitialize

Optional Prerequisite Calls

None.