LabWindows/CVI

Content Type
Programming Language
Current manual
Table of Contents

DirSelectPopup

int DirSelectPopup (char defaultDirectory[], char title[], int allowCancel, int allowMakeDirectory, char pathName[]);

Purpose

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

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

Parameters

Input
Name Type Description
title char [] Title of the dialog box.
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 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

Name Type Description
selectionStatus int The selection status or error codes generated during the function call.

0 VAL_NO_DIRECTORY_SELECTED
1 VAL_DIRECTORY_SELECTED

Negative values indicate that an error occurred.

Additional Information

Library: User Interface Library

Include file: userint.h

LabWindows/CVI compatibility: LabWindows/CVI 4.0 and later

Was this information helpful?

Log in to get a better experience