FileSelectPopup

int FileSelectPopup (char defaultDirectory[], char defaultFileSpec[], char fileTypeList[], char title[], int buttonLabel, int restrictDirectory, int restrictExtension, int allowCancel, int allowMakeDirectory, char pathName[]);

Purpose

Note  This function has been superseded by FileSelectPopupEx. Use FileSelectPopupEx to display a Windows Vista and later style dialog box.

Displays a file selection dialog box and waits for the user to select a file or cancel.

Parameters

Input
Name	Type	Description
defaultFileSpec	char []	String that specifies which value is displayed by default in the file type list of the dialog box. For example, "*.c" causes all files with the .c extension to be displayed. LabWindows/CVI adds a new file type item if needed. If an actual file name is specified, such as "test.c", that name appears in the file name box when the dialog box is displayed and the extension of the file, "*.c", is selected by default in the file type list. The default file specification (spec) cannot contain a directory path. The maximum length of the default file spec is 255 bytes.
fileTypeList	char []	List of file types, separated by semicolons, to display in the file type list of the dialog box when restrictExtension is FALSE. For example, "*.c; *.h" allows the user to select "*.c" or "*.h" from the file type list. The all files, *.*, option is always available. You can group multiple file types under one entry in the drop-down list by enclosing the file types in parentheses and separating the file types by semicolons. You can include descriptive text along with the file types. For example, "JPEG Files (*.jpg;*.jpeg);PNG Files (*.png);*.bmp;" allows the user to see all JPEG file types at once, or to select "*.png" or "*.bmp" from the file type list.
title	char []	Title of the dialog box.
buttonLabel	int	The label for the file select button. You can select from the following choices: Button Label Value Description OK VAL_OK_BUTTON Allows users to select a file Save VAL_SAVE_BUTTON Allows users to save a file Select VAL_SELECT_BUTTON (affects existing files only) Confirms the selected file exists Load VAL_LOAD_BUTTON (affects existing files only) Displays an existing file Note   If VAL_SELECT_BUTTON or VAL_LOAD_BUTTON is passed to the buttonLabel parameter, the FileSelectPopup function confirms the selected file exists. If the file does not exist, the function prompts the user to select an existing file.
restrictDirectory	int	Specify a nonzero value or select yes in the function panel to restrict the user from changing directories or drives. Specify 0 or select no in the function panel to allow the user to change directories or drives.
restrictExtension	int	Specify a nonzero value or select yes in the function panel to limit the user to files with the default extension. Specify 0 or select no in the function panel to allow the user to select files with any extension.
allowCancel	int	Specify a nonzero value or select yes in the function panel to allow the user to cancel out of the dialog box. Specify 0 or select no in the function panel to force the user to make a selection before exiting the dialog box.
allowMakeDirectory	int	Specify a nonzero value or select yes in the function panel to display a new directory icon that allows the user to create a new directory from the dialog box. This option is useful when a user wants to save a file into a new directory. Specify 0 or select no in the function panel to not include the icon in the dialog box. Note  Specifying 0 or selecting no in the function panel does not prevent users from right-clicking in the file list of the dialog box and selecting New»Folder to create a new directory.
Output
Name	Type	Description

Return Value

Additional Information

Library: User Interface Library

Include file: userint.h

LabWindows/CVI compatibility: LabWindows/CVI 3.0 and later