win32gui.GetSaveFileNameW

(PyUNICODE,PyUNICODE,int) = GetSaveFileNameW(hwndOwner, hInstance , Filter , CustomFilter , FilterIndex , File , MaxFile , InitialDir , Title , Flags , DefExt , TemplateName )

Creates a dialog for user to specify location to save a file or files

Parameters

hwndOwner=None : PyHANDLE

Handle to window that owns dialog

hInstance=None : PyHANDLE

Handle to module that contains dialog template

Filter=None : PyUNICODE

Contains pairs of descriptions and filespecs separated by NULLS, with a final trailing NULL. Example: 'Python Scripts\\0*.py;*.pyw;*.pys\\0Text files\\0*.txt\\0'

CustomFilter=None : PyUNICODE

Description to be used for filter that user selected or typed, can also contain a filespec as above

FilterIndex=0 : int

Specifies which of the filters is initially selected, use 0 for CustomFilter

File=None : PyUNICODE

The file name initially displayed

MaxFile=1024 : int

Number of characters to allocate for selected filename(s), override if large number of files expected

InitialDir=None : PyUNICODE

The starting directory

Title=None : PyUNICODE

The title of the dialog box

Flags=0 : int

Combination of win32con.OFN_* constants

DefExt=None : PyUNICODE

The default extension to use

TemplateName=None : PyResourceId

Name or resource id of dialog box template

Comments

Accepts keyword arguments, all arguments optional

Return Value

Returns a tuple of 3 values (PyUNICODE, PyUNICODE, int):
First is the selected file(s). If multiple files are selected, returned string will be the directory followed by files names separated by nulls, otherwise it will be the full path.
Second is a unicode string containing user-selected filter, will be None if CustomFilter was not specified
Third item contains flags pertaining to users input, such as OFN_READONLY and OFN_EXTENSIONDIFFERENT