IPXV_Inst::ShowSaveFileDlg Method
From PDF XChange PDF SDK
(Automatic page editing by robot) |
m (Automatic page editing by robot) |
||
(12 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
+ | __NOTOC__ | ||
[[Category:Editor]] | [[Category:Editor]] | ||
{{#customTitle:IPXV_Inst::ShowSaveFileDlg Method}} | {{#customTitle:IPXV_Inst::ShowSaveFileDlg Method}} | ||
+ | {{#parentPage:PXV:IPXV_Inst#Methods|ShowSaveFileDlg|method}} | ||
+ | {{ToReview}} | ||
− | + | Shows an ''Save File'' dialog box that lets the user specify the name of a file to save. | |
== Syntax == | == Syntax == | ||
− | <pre class="brush:cpp;gutter:false">HRESULT ShowSaveFileDlg([in, | + | <pre class="brush:cpp;gutter:false">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);</pre> | ||
== Parameters == | == Parameters == | ||
− | ; | + | ;pFileFilters |
− | :[in, | + | :[in, defaultvalue("")] Specifies the set of file-filters for open dialog. For example: |
− | ; | + | ::<tt>PDF Documents (*.pdf)|*.pdf|All Files (*.*)|*.*</tt> |
− | :[in, | + | ;pInitialFolderName |
− | ; | + | :[in, defaultvalue("")] The initial folder path. If empty string is specified then current folder will be used. |
− | :[in, | + | ;pInitialFileName |
− | ; | + | :[in, defaultvalue("")] The initial file name. |
− | :[in, | + | ;pDefaultExt |
− | ; | + | :[in, defaultvalue("")] The default extension. |
− | :[in, | + | ;pDlgTitle |
− | ; | + | :[in, defaultvalue("")] The title of dialog. |
− | :[in, | + | ;hWndParent |
− | ; | + | :[in, defaultvalue(0)] The optional parameter that specifies the handle of parent window. |
− | :[in, | + | ;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. |
− | :[in, | + | ;bShowHidden |
− | ; | + | :[in, defaultvalue(0)] Forces the showing of system and hidden files. |
− | :[in, | + | ;nFilterIndex |
− | + | :[in, defaultvalue(0)] The index of filter that should be selected initially. | |
− | + | ;pRes | |
− | ; | + | :[out, retval] Returns pointer to [[PXV:IPXV_SaveFileDlgRes|IPXV_SaveFileDlgRes]] object. |
− | :[out, retval] | + | |
== Return Value == | == Return Value == | ||
Line 35: | Line 46: | ||
== See Also == | == See Also == | ||
− | + | [[PXV:IPXV_Inst|IPXV_Inst]] |
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.