get_saveas_box_by_file_group

1 Description
2 Syntax
3 Parameters
4 Return
5 Examples
6 Remark
7 See Also
8 header to Include
9 Reference

Description

Show a file save as dialog using the specified settings.

Syntax

int get_saveas_box_by_file_group( string & strFile, LPCSTR lpcszGroup, LPCSTR lpcszTitle = NULL, DWORD dwFlags = 0, LPCSTR lpcszDefaultPath = NULL, LPCSTR lpcszDefaultFilename = NULL, LPCSTR lpcszCheckBoxName = NULL, int * lpnCheckBoxState = NULL, LPCSTR lpcszFuncName = NULL )

Parameters

strFile: [output] user selected file names separated by "\r\n"
lpcszGroup: [input] name of file extension group
lpcszTitle: [input] optional dialog title
dwFlags: [input] see OPENBOX_FLAG_* constants
lpcszDefaultPath: [input] default path, NULL will use default path of file extension group, empty will use last used path.
lpcszDefaultFilename: [input] default file name
lpcszCheckBoxName: [input] optional check box label
lpnCheckBoxState: [input/output] state of optional check box
lpcszFuncName: [input] optional registry key name to save check box state, if NULL use last XF name

Return

returns 0 if click cancel button.

Examples

EX1

int get_saveas_box_by_file_group_Ex1()
{     
    string    strFiles;
    LPCSTR    strGroup = "CodeBuilder";// the same file group as in Code Builder file dialog
    LPCSTR    strTitle = "SaveFileAsDlg"; 

    if( 0 == get_saveas_box_by_file_group( strFiles, strGroup, strTitle) )
        printf("User click Cancel to close file without save");
    else
        out_str( "Files Saved as :\n" + strFiles );

    return 0;
}