URISelect (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage functions / Mobile specific functions / URI functions

Miscellaneous

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

URISelect (Function)

In french: URISélecteur

Opens a system window to select or create a resource from:

the device file system,
the Cloud (Google Drive, Microsoft OneDrive, etc.)
one of the content managers installed on the device.

Example

URISelect(MyProcURISelect, uriAudio + TAB + uriImage + TAB + uriVidéo)

INTERNAL PROCÉDURE MyProcURISelect(Success is boolean, Result1 is URI)
IF Success = True THEN
// Displays the name of the selected resource
ToastDisplay(Result1.Value)
END
END

Syntax

Selecting or creating a resource (synchronous code) Hide the details

<Result> = URISelect([<MIME types> [, <Mode> [, <Document name>]]])

<Result>: URI variable

URI that corresponds to the selected resource.
If an error occurs, the ErrorOccurred variable is set to True. To get more details on the error, use ErrorInfo.

<MIME types>: Optional character string or constant

List of MIME types of selectable files, separated by TAB.
One of the following constants:
uriAudio Allows all types of audio files.
uriImage Allows all types of image files.
uriVideo Allows all types of video files.

Remark: It is possible to concatenate constants by separating them with TAB.
If a specified MIME type is not known by the system, it will be ignored.
If this parameter is not specified, all files will be selectable.

<Mode>: Optional Integer constant

Selection mode:
uriCreate Opens the picker in "Creation" mode to create a new document. The default name of this document can be specified in <Document name>.
uriOpen
(Default value) Opens the picker in "Open" mode to open an existing document.

<Document name>: Optional character string

Default name of the document to be created when the picker is open in creation mode. This parameter is taken into account only if <Mode> corresponds to the uriCreate constant.

Selecting or creating a resource (asynchronous code) Hide the details

URISelect(<WLanguage procedure> [, <MIME types> [, <Mode> [, <Document name>]]])

<WLanguage procedure>: Procedure name

Name of the WLanguage procedure ("callback") called for the selected file. This procedure is called when the user closes the URI selection window. For more details on this procedure, see Parameters of the procedure used by URISelect.

<MIME types>: Optional character string or constant

List of MIME types of selectable files, separated by TAB.
One of the following constants:
uriAudio Allows all types of audio files.
uriImage Allows all types of image files.
uriVideo Allows all types of video files.

Remark: It is possible to concatenate constants by separating them with TAB.
If a specified MIME type is not known by the system, it will be ignored.
If this parameter is not specified, all files will be selectable.

<Mode>: Optional Integer constant

Selection mode:
uriCreate Opens the picker in "Creation" mode to create a new document. The default name of this document can be specified in <Document name>.
uriOpen
(Default value) Opens the picker in "Open" mode to open an existing document.

<Document name>: Optional character string

Default name of the document to be created when the picker is open in creation mode. This parameter is taken into account only if <Mode> corresponds to the uriCreate constant.

Remarks

Miscellaneous

To manage the URI returned by URISelect, use the URIxxx functions.
To retrieve additional information (name, size, MIME type) on the selected resource, use URIGetInfo.
This function is mainly used to write multi-platform code.

Business / UI classification: UI Code

Component: wd290java.dll