IPXV_Inst::ShowSaveFileDlg Method
From PDF XChange PDF SDK
m (Automatic page editing by robot) |
m (Automatic page editing by robot) |
||
(5 intermediate revisions by 2 users not shown) | |||
Line 2: | Line 2: | ||
[[Category:Editor]] | [[Category:Editor]] | ||
{{#customTitle:IPXV_Inst::ShowSaveFileDlg Method}} | {{#customTitle:IPXV_Inst::ShowSaveFileDlg Method}} | ||
− | {{#parentPage:PXV:IPXV_Inst#Methods|ShowSaveFileDlg | + | {{#parentPage:PXV:IPXV_Inst#Methods|ShowSaveFileDlg|method}} |
− | + | ||
{{ToReview}} | {{ToReview}} | ||
− | + | Shows an ''Save File'' dialog box that lets the user specify the name of a file to save. | |
== Syntax == | == Syntax == | ||
Line 18: | Line 17: | ||
[in, defaultvalue(0)] VARIANT_BOOL bShowHidden, | [in, defaultvalue(0)] VARIANT_BOOL bShowHidden, | ||
[in, defaultvalue(0)] LONG nFilterIndex, | [in, defaultvalue(0)] LONG nFilterIndex, | ||
− | [out, retval] IPXV_SaveFileDlgRes** | + | [out, retval] IPXV_SaveFileDlgRes** pRes);</pre> |
== Parameters == | == Parameters == | ||
;pFileFilters | ;pFileFilters | ||
− | :[in, defaultvalue("")] | + | :[in, defaultvalue("")] Specifies the set of file-filters for open dialog. For example: |
+ | ::<tt>PDF Documents (*.pdf)|*.pdf|All Files (*.*)|*.*</tt> | ||
;pInitialFolderName | ;pInitialFolderName | ||
− | :[in, defaultvalue("")] | + | :[in, defaultvalue("")] The initial folder path. If empty string is specified then current folder will be used. |
;pInitialFileName | ;pInitialFileName | ||
− | :[in, defaultvalue("")] | + | :[in, defaultvalue("")] The initial file name. |
;pDefaultExt | ;pDefaultExt | ||
− | :[in, defaultvalue("")] | + | :[in, defaultvalue("")] The default extension. |
;pDlgTitle | ;pDlgTitle | ||
− | :[in, defaultvalue("")] | + | :[in, defaultvalue("")] The title of dialog. |
;hWndParent | ;hWndParent | ||
− | :[in, defaultvalue(0)] | + | :[in, defaultvalue(0)] The optional parameter that specifies the handle of parent window. |
;bOverwritePrompt | ;bOverwritePrompt | ||
− | :[in, defaultvalue(-1)] | + | :[in, defaultvalue(-1)] The flag that causes to generate a message box if the selected file already exists. The user must confirm whether to overwrite the file. |
;bShowHidden | ;bShowHidden | ||
− | :[in, defaultvalue(0)] | + | :[in, defaultvalue(0)] Forces the showing of system and hidden files. |
;nFilterIndex | ;nFilterIndex | ||
− | :[in, defaultvalue(0)] | + | :[in, defaultvalue(0)] The index of filter that should be selected initially. |
− | ; | + | ;pRes |
− | :[out, retval] | + | :[out, retval] Returns pointer to [[PXV:IPXV_SaveFileDlgRes|IPXV_SaveFileDlgRes]] object. |
== Return Value == | == Return Value == |
Latest revision as of 03:57, 15 June 2015
Shows an Save File dialog box that lets the user specify the name of a file to save.
Syntax
HRESULT ShowSaveFileDlg([in, defaultvalue("")] BSTR pFileFilters, [in, defaultvalue("")] BSTR pInitialFolderName, [in, defaultvalue("")] BSTR pInitialFileName, [in, defaultvalue("")] BSTR pDefaultExt, [in, defaultvalue("")] BSTR pDlgTitle, [in, defaultvalue(0)] HANDLE_T hWndParent, [in, defaultvalue(-1)] VARIANT_BOOL bOverwritePrompt, [in, defaultvalue(0)] VARIANT_BOOL bShowHidden, [in, defaultvalue(0)] LONG nFilterIndex, [out, retval] IPXV_SaveFileDlgRes** pRes);
Parameters
- pFileFilters
- [in, defaultvalue("")] Specifies the set of file-filters for open dialog. For example:
- PDF Documents (*.pdf)|*.pdf|All Files (*.*)|*.*
- pInitialFolderName
- [in, defaultvalue("")] The initial folder path. If empty string is specified then current folder will be used.
- pInitialFileName
- [in, defaultvalue("")] The initial file name.
- pDefaultExt
- [in, defaultvalue("")] The default extension.
- pDlgTitle
- [in, defaultvalue("")] The title of dialog.
- hWndParent
- [in, defaultvalue(0)] The optional parameter that specifies the handle of parent window.
- bOverwritePrompt
- [in, defaultvalue(-1)] The flag that causes to generate a message box if the selected file already exists. The user must confirm whether to overwrite the file.
- bShowHidden
- [in, defaultvalue(0)] Forces the showing of system and hidden files.
- nFilterIndex
- [in, defaultvalue(0)] The index of filter that should be selected initially.
- pRes
- [out, retval] Returns pointer to IPXV_SaveFileDlgRes object.
Return Value
Returns S_OK if operation was successful or error code in other cases.