IPXV_Inst::ShowOpenFilesDlg Method
From PDF XChange PDF SDK
(Automatic page editing by robot) |
m (Automatic page editing by robot) |
||
(13 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
+ | __NOTOC__ | ||
[[Category:Editor]] | [[Category:Editor]] | ||
{{#customTitle:IPXV_Inst::ShowOpenFilesDlg Method}} | {{#customTitle:IPXV_Inst::ShowOpenFilesDlg Method}} | ||
+ | {{#parentPage:PXV:IPXV_Inst#Methods|ShowOpenFilesDlg|method}} | ||
+ | {{ToReview}} | ||
− | + | Shows an ''Open Files'' dialog box that lets the user specify the name of a file(s) to be opened. | |
== Syntax == | == Syntax == | ||
− | <pre class="brush:cpp;gutter:false">HRESULT ShowOpenFilesDlg([in, | + | <pre class="brush:cpp;gutter:false">HRESULT ShowOpenFilesDlg([in, defaultvalue("")] BSTR pFileFilters, |
+ | [in, defaultvalue("")] BSTR pInitialFolderName, | ||
+ | [in, defaultvalue(0)] VARIANT_BOOL bAllowMult, | ||
+ | [in, defaultvalue("")] BSTR pDlgTitle, | ||
+ | [in, defaultvalue(0)] HANDLE_T hWndParent, | ||
+ | [in, defaultvalue(0)] VARIANT_BOOL bShowHidden, | ||
+ | [in, defaultvalue(0)] LONG nFilterIndex, | ||
+ | [out, retval] IPXV_OpenFilesDlgRes** 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, | + | ::also you may specify some predefined sets: |
− | ; | + | ::<tt><allSupp></tt> - specifies all supported filters; |
− | :[in, | + | ::<tt><allSuppImg></tt> - specifies all supported images filters; |
− | ; | + | ::<tt><allSuppRasterImg></tt> - specifies all supported rester-images filters; |
− | :[in, | + | ;pInitialFolderName |
− | ; | + | :[in, defaultvalue("")] The initial folder path. If empty string is specified then current folder will be used. |
− | :[in, | + | ;bAllowMult |
− | ; | + | :[in, defaultvalue(0)] The flag to allow multiple files selection. |
− | :[in, | + | ;pDlgTitle |
− | ; | + | :[in, defaultvalue("")] The title of dialog. |
− | :[in, | + | ;hWndParent |
− | + | :[in, defaultvalue(0)] The optional parameter that specifies the handle of parent window. | |
− | + | ;bShowHidden | |
− | ; | + | :[in, defaultvalue(0)] Forces the showing of system and hidden files. |
− | :[out, retval] | + | ;nFilterIndex |
+ | :[in, defaultvalue(0)] The index of filter that should be selected initially. | ||
+ | ;pRes | ||
+ | :[out, retval] Returns pointer to [[PXV:IPXV_OpenFilesDlgRes|IPXV_OpenFilesDlgRes]] object. | ||
== Return Value == | == Return Value == | ||
Line 31: | Line 44: | ||
== See Also == | == See Also == | ||
− | + | [[PXV:IPXV_Inst|IPXV_Inst]] |
Latest revision as of 03:57, 15 June 2015
Shows an Open Files dialog box that lets the user specify the name of a file(s) to be opened.
Syntax
HRESULT ShowOpenFilesDlg([in, defaultvalue("")] BSTR pFileFilters, [in, defaultvalue("")] BSTR pInitialFolderName, [in, defaultvalue(0)] VARIANT_BOOL bAllowMult, [in, defaultvalue("")] BSTR pDlgTitle, [in, defaultvalue(0)] HANDLE_T hWndParent, [in, defaultvalue(0)] VARIANT_BOOL bShowHidden, [in, defaultvalue(0)] LONG nFilterIndex, [out, retval] IPXV_OpenFilesDlgRes** pRes);
Parameters
- pFileFilters
- [in, defaultvalue("")] Specifies the set of file-filters for open dialog. For example:
- PDF Documents (*.pdf)|*.pdf|All Files (*.*)|*.*
- also you may specify some predefined sets:
- <allSupp> - specifies all supported filters;
- <allSuppImg> - specifies all supported images filters;
- <allSuppRasterImg> - specifies all supported rester-images filters;
- pInitialFolderName
- [in, defaultvalue("")] The initial folder path. If empty string is specified then current folder will be used.
- bAllowMult
- [in, defaultvalue(0)] The flag to allow multiple files selection.
- pDlgTitle
- [in, defaultvalue("")] The title of dialog.
- hWndParent
- [in, defaultvalue(0)] The optional parameter that specifies the handle of parent window.
- 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_OpenFilesDlgRes object.
Return Value
Returns S_OK if operation was successful or error code in other cases.