fSelectDir (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Standard functions / External file functions

Selecting files
Operating mode in Java
Former and new directory picker

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

fSelectDir (Function)

In french: fRepSélecteur

Opens a directory picker.

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

Note: It is possible to select a local directory or a directory on a network drive..

Example

See additional examples

// Sélection d'un répertoire
Répertoire = fSelectDir("C:\Répertoires\", "Sélectionnez un répertoire", ...
	"Sélectionnez le répertoire que vous désirez copier")

Syntax

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

<Result>: Character string

Path and full name of the selected directory,
Empty string ("") if no directory was selected. To get more details on the error, use ErrorInfo with the errMessage constant.

<Directory selected by default>: Character string

Name and full (or relative) path of the 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.
This parameter can be in Ansi or Unicode format.

<Picker title>: Character string

Text displayed in the title bar of the directory picker.
If this parameter is an empty string (""), the "Find a folder" title will be displayed.
This parameter can be in Ansi or Unicode format.

<Picker comments>: Optional character string

Comments displayed at the top of the directory picker.
This parameter can be in Ansi or Unicode format.

<Root directory>: Optional character string

Name and full path of the "root" directory in the suggested 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 subdirectories of a given directory.
This parameter can be in Ansi or Unicode format.
If this parameter differs from empty string (""), the former directory picker will be used.

<Options>: Optional Integer constant

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

Remarks

Selecting files

fSelectDir is used 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 behavior of the Windows directory picker.

To force the use of the Java directory picker, use the System property <wd.prop.sel_rep_defaut> property at application launch, passing it one of the following values: yes/o/yes/y/true/true.
Example of command line used to start a Java application by forcing the use of the 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 appearance and operation of the native Windows directory picker, use the system property <wd.prop.sel_rep_windows> property at application launch, passing it one of the following values: yes/o/yes/y/true/true.
Example of command line used to start a Java application by forcing the use of the Windows directory picker:

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

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.

Business / UI classification: UI Code

Component: wd300std.dll