FileOpenDialogA

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.

FileOpenDialogA 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 Ansi version of FileOpenDialog. All strings passed as parameters are expected to be Ansi strings, and the return results are stored in the lpFilesArray parameter as a pointer to an array of Ansi strings.

For the Wide/Unicode version see the FileOpenDialogW function.

FileOpenDialog Implements the common file open dialog (CLSID_FileOpenDialog)

See Also

FileSaveDialogA, FolderSelectDialogA