FileOpenDialogW

Creates an Open dialog box that lets the user specify the drive, directory, and the name of a file or set of files to be opened.

FileOpenDialogW PROTO lpszTitle:DWORD, lpszOkLabel:DWORD, lpszFileLabel:DWORD, lpszFolder:DWORD, nMFS:DWORD, pMFS:DWORD, hWndOwner:DWORD, bMulti:DWORD, lpdwFiles:DWORD, lpFilesArray:DWORD

Parameters

  • lpszTitle - pointer to a string for the title of the open dialog.

  • lpszOkLabel - pointer to a string for the ok button in the open dialog.

  • lpszFileLabel - pointer to a string for the file label in the open dialog.

  • lpszFolder - pointer to a string for the initial folder to start in.

  • nMFS - number of COMDLG_FILTERSPEC structures pointed to by pMFS.

  • pMFS - array of COMDLG_FILTERSPEC structures for multi file spec.

  • hWndOwner - handle of the parent window that owns this open dialog.

  • bMulti - allow multiple file selection (TRUE) or single file only (FALSE)

  • lpdwFiles - pointer to a variable that stores the number of files that the user selected to ‘open’ and the number of files in the lpFilesArray array of filenames.

  • lpFilesArray - pointer to a variable that stores a pointer to a null separated list of filenames that the user selected to ‘open’. The list ends with a double null.

Returns

TRUE if successful, or FALSE otherwise.

Notes

This is the Wide/Unicode version of FileOpenDialog. All strings passed as parameters are expected to be Wide/Unicode strings, and the return results are stored in the lpFilesArray parameter as a pointer to an array of Wide/Unicode strings.

For the Ansi version see the FileOpenDialogA function.

FileOpenDialog Implements the common file open dialog (CLSID_FileOpenDialog)

See Also

FileSaveDialogW, FolderSelectDialogW