IPXV_Inst::ShowOpenFilesDlg Method

From PDF XChange PDF SDK
Jump to: navigation, search


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.

See Also

IPXV_Inst