fSelectDir (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

External file management functions

Operating mode in Java

Former and new directory picker

See also

fSelectDir (Function)

In french: fRepSélecteur

Opens a directory picker.

The directory picker is as follows (the appearance of picker may change according to the system used)

Remark: You have the ability to select a local directory or a directory found on a network disk.

Versions 16 and later

This function is now available for WINDEV applications in Linux.

New in version 16

This function is now available for WINDEV applications in Linux.

Example

See additional examples

// Select a directory
Directory = fSelectDir("C:\Directories", "Select a directory", ...
"Select the directory that will be copied")

Syntax

<Result> = fSelectDir(<Directory selected by default> , <Picker title> [, <Picker comments> [, <Root directory> [, <Options>]]])

<Result>: Character string

Path and full name of selected directory,
Empty string ("") if no directory was selected. To find out the name of the error, use the function ErrorInfo with the constant errMessage.

<Directory selected by default>: Character string (with quotes)

Name and full (or relative) path of directory selected by default. A UNC path can be used. This parameter must end with "\". If this parameter is an empty string (""), no directory will be selected by default.
Versions 15 and later
This parameter can be in Ansi or Unicode format.
New in version 15
This parameter can be in Ansi or Unicode format.
This parameter can be in Ansi or Unicode format.

<Picker title>: Character string (with quotes)

Caption displayed in the title bar of directory picker.
If this parameter is an empty string (""), the "Find a folder" title will be displayed.
Versions 15 and later
This parameter can be in Ansi or Unicode format.
New in version 15
This parameter can be in Ansi or Unicode format.
This parameter can be in Ansi or Unicode format.

<Picker comments>: Optional character string (with quotes)

Comments displayed at the top of directory picker.
Versions 15 and later
This parameter can be in Ansi or Unicode format.
New in version 15
This parameter can be in Ansi or Unicode format.
This parameter can be in Ansi or Unicode format.

<Root directory>: Optional character string (with quotes)

Name and full path of "root" directory in the proposed tree structure. A UNC path can be used. If this parameter is an empty string (""), the "Desktop" directory will start the proposed tree structure.
This parameter is used to limit the selection to the directories of a given disk or to the sub-directories of a given directory.
Versions 15 and later
This parameter can be in Ansi or Unicode format.
New in version 15
This parameter can be in Ansi or Unicode format.
This parameter can be in Ansi or Unicode format.
Versions 23 and later
If this parameter differs from empty string (""), the former directory picker will be used.
New in version 23
If this parameter differs from empty string (""), the former directory picker will be used.
If this parameter differs from empty string (""), the former directory picker will be used.

<Options>: Optional Integer constant

Versions 15 and later
Allows you to specify:
the format of function result. By default, fSelectDir returns a character string in Ansi format.
Versions 23 and later
the style of directory picker.
New in version 23
the style of directory picker.
the style of directory picker.
fPathUNICODE <Result> will be a character string in Unicode format.
Versions 16 and later
This constant is not available.
New in version 16
This constant is not available.
This constant is not available.
Versions 23 and later
fdFormerAspect
New in version 23
fdFormerAspect
fdFormerAspect Allows you to use the former directory picker (old style).

This constant is not available.
Versions 18 and later
fdForbidVirtualFolder
New in version 18
fdForbidVirtualFolder
fdForbidVirtualFolder <Result> will not contain the virtual directories.
This constant is not available.
New in version 15
Allows you to specify:
the format of function result. By default, fSelectDir returns a character string in Ansi format.
Versions 23 and later
the style of directory picker.
New in version 23
the style of directory picker.
the style of directory picker.
fPathUNICODE <Result> will be a character string in Unicode format.
Versions 16 and later
This constant is not available.
New in version 16
This constant is not available.
This constant is not available.
Versions 23 and later
fdFormerAspect
New in version 23
fdFormerAspect
fdFormerAspect Allows you to use the former directory picker (old style).

This constant is not available.
Versions 18 and later
fdForbidVirtualFolder
New in version 18
fdForbidVirtualFolder
fdForbidVirtualFolder <Result> will not contain the virtual directories.
This constant is not available.
Allows you to specify:
the format of function result. By default, fSelectDir returns a character string in Ansi format.
Versions 23 and later
the style of directory picker.
New in version 23
the style of directory picker.
the style of directory picker.
fPathUNICODE <Result> will be a character string in Unicode format.
Versions 16 and later
This constant is not available.
New in version 16
This constant is not available.
This constant is not available.
Versions 23 and later
fdFormerAspect
New in version 23
fdFormerAspect
fdFormerAspect Allows you to use the former directory picker (old style).

This constant is not available.
Versions 18 and later
fdForbidVirtualFolder
New in version 18
fdForbidVirtualFolder
fdForbidVirtualFolder <Result> will not contain the virtual directories.
This constant is not available.

Remarks

Selecting files

fSelectDir is used to to select a directory. To select a file, use fSelect.

Operating mode in Java

In Java, in Windows, the use of fSelectDir displays a Java window that simulates the aspect and the operating mode of Windows directory picker.

To force the use of Java directory picker, you must use <wd.prop.sel_rep_defaut> when starting the application and you must specify one of the following values: oui/o/yes/y/vrai/true.
Example of command line used to start a Java application by forcing the use of Java directory picker:

java -Dwd.prop.sel_rep_defaut=y -jar MyApplication.jar

In Java, in the other OS (Linux, Mac, ...), the use of fSelectDir displays the Java directory picker.

To force the display of a Java window that simulates the aspect and the operating mode of native Windows directory picker, you must use <wd.prop.sel_rep_windows> when starting the application and you must specify one of the following values: oui/o/yes/y/vrai/true.
Example of command line used to start a Java application by forcing the use of Windows directory picker:

java -Dwd.prop.sel_rep_windows=y -jar MyApplication.jar

Versions 23 and later

Former and new directory picker

From version 23, the new directory picker is used by default.

If the new picker is not supported (the new picker is supported from Windows Vista) or if the <Root> parameter is not empty (the root directory is not supported by the new picker), the former picker is displayed even if the frFormerAspect constant is not specified.

New in version 23

Former and new directory picker

From version 23, the new directory picker is used by default.

Former and new directory picker

From version 23, the new directory picker is used by default.

Business / UI classification: UI Code

Component: wd260std.dll