fImageSelect (Function)

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Functions for managing external files

fImageSelect

Presentation

Example

Selecting directories

Opening mode of the image picker

See also

Constants for the external files

Functions for managing external files

Handling the external files

Storing files in Android

Summary table: Managing the application directories according to the platform

fDetectRemovableStorage

fReadLineRegularExpression

fRemoveDir

fRename

fReportsAndQueriesDir

Selecting directories
Opening mode of the image picker

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

fImageSelect (Function)

In french: fSélecteurImage

Opens the image picker of Windows. The image picker is as follows:

Example

See additional examples

// Select an image file
File = fImageSelect("C:\Directories", "File.gif", "Select an image", ...
"JPEG (*.JPG)" + TAB + "*.jpg" + RC + "BMP (*.BMP)" + TAB + "*.gif")

Syntax

<Result> = fImageSelect(<Initial directory> , <File selected by default> , <Picker title> [, <Types of files> [, <Option>]])

<Result>: Character string

Full name of the selected file,
Empty string ("") if no file was selected.

<Initial directory>: Character string (with quotes)

Full or relative path of initial directory (up to 260 characters). This directory name may (or may not) end with "\". The files found in this directory are displayed in the image picker.
If this parameter is an empty string (""), the initial directory will be the current 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.

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

Name and extension of the file selected by default. If this parameter is an empty string (""), no file 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 the image picker. If this parameter is an empty string (""), the title of the current WINDEV window 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.

<Types of files>: Optional character string (with quotes)

Description of types of files that can be selected. This description has the following format:

<Types Files> + TAB + <List Extensions>
[ + CR + <Types Files 2> + TAB + <List Extensions 2>]

<Types Files>: character string describing the type of file ("BMP (*.BMP;*.RLE)" for example).
<List Extensions>: extensions corresponding to the described type ("*.BMP;*.RLE" for example).
For example:

"BMP (*.BMP;*.RLE)"+TAB+"*.BMP;*.RLE"+CR+"Icon (*.ICO)"+TAB+"*.ICO"+CR+
"Other"+TAB+"*.GIF;*.TIF;*.JPG"

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.

<Option>: Optional Integer constant (or combination of constants)

Versions 15 and later
Options that must be taken into account:
fPathUNICODE <Result> will be a character string in Unicode format (by default, fImageSelect returns an Ansi character string).
Versions 21 and later
fSelMulti
New in version 21
fSelMulti
fSelMulti Opens the file picker in multiselection mode. The user can select several image files by pressing the "Ctrl" and "Shift" keys.
New in version 15
Options that must be taken into account:
fPathUNICODE <Result> will be a character string in Unicode format (by default, fImageSelect returns an Ansi character string).
Versions 21 and later
fSelMulti
New in version 21
fSelMulti
fSelMulti Opens the file picker in multiselection mode. The user can select several image files by pressing the "Ctrl" and "Shift" keys.
Options that must be taken into account:
fPathUNICODE <Result> will be a character string in Unicode format (by default, fImageSelect returns an Ansi character string).
Versions 21 and later
fSelMulti
New in version 21
fSelMulti
fSelMulti Opens the file picker in multiselection mode. The user can select several image files by pressing the "Ctrl" and "Shift" keys.

Remarks

Selecting directories

fImageSelect is used to select image files. To select a directory, use fSelectDir.

Opening mode of the image picker

Only the "Open" button is displayed in the image picker. In order for the "Save" button to be displayed in the image picker, fSelect and fGraphicFilter must be combined (see the example of fGraphicFilter).

Component : wd240std.dll