Client API. The Codename One framework your app is built on: this runs on the device, not in a backend.

public class OpenFileRequest

Describes a native Open dialog for com.codename1.ui.Display#showOpenDialog(OpenFileRequest, com.codename1.util.SuccessCallback).

Display.getInstance().showOpenDialog(new OpenFileRequest()
        .title("Import photos")
        .multiSelect(true)
        .addFilter(new FileTypeFilter("Images").extensions("png", "jpg").mimeTypes("image/*"))
        .preview(path -> new Label(path)),
    result -> {
        if (!result.isCancelled()) {
            for (String p : result.getPaths()) {
                Log.p("Picked " + p);
            }
        }
    });

The paths reported are readable with com.codename1.io.FileSystemStorage. On Android and iOS the picked document is copied into the app’s cache first, since those platforms hand out content that outlives no process.

Constructors

public OpenFileRequest()

Methods

`public` `OpenFileRequest multiSelect(boolean multiSelect)`	Lets the user pick several files.
`public` `OpenFileRequest directories(boolean directories)`	Picks folders instead of files, where `FileDialogFeatures#DIRECTORIES` is supported.
`public` `OpenFileRequest preview(FilePreviewProvider preview)`	Supplies a preview shown beside the file list as the selection changes, where `FileDialogFeatures#PREVIEW` is supported.
`public boolean isMultiSelect()`	Whether several files may be picked.
`public boolean isDirectories()`	Whether folders are picked.
`public` `FilePreviewProvider getPreview()`	The preview provider, or null.

Inherited fields

From FileDialogRequest

HINT_MAC_SHOWS_TAG_FIELD, HINT_MAC_CAN_CREATE_DIRECTORIES, HINT_MAC_SHOWS_HIDDEN_FILES, HINT_MAC_CAN_SELECT_HIDDEN_EXTENSION, HINT_MAC_TREATS_PACKAGES_AS_DIRECTORIES, HINT_IOS_SHOWS_FILE_EXTENSIONS, HINT_IOS_EXPORT_AS_MOVE, HINT_ANDROID_INITIAL_URI, HINT_ANDROID_PERSIST_PERMISSION, HINT_WIN_CLIENT_GUID, HINT_WIN_DEFAULT_FOLDER, HINT_DESKTOP_SHOW_HIDDEN

Inherited methods

From Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait, clone, finalize

Constructor details

OpenFileRequest

public OpenFileRequest()

Method details

multiSelect

public OpenFileRequest multiSelect(boolean multiSelect)

Lets the user pick several files. Platforms without FileDialogFeatures#MULTI_SELECT return one.

Parameters

multiSelect boolean: true to allow several files

Returns

this request

directories

public OpenFileRequest directories(boolean directories)

Picks folders instead of files, where FileDialogFeatures#DIRECTORIES is supported.

Parameters

directories boolean: true to pick folders

Returns

this request

preview

public OpenFileRequest preview(FilePreviewProvider preview)

Supplies a preview shown beside the file list as the selection changes, where FileDialogFeatures#PREVIEW is supported.

Parameters

preview FilePreviewProvider: the preview provider

Returns

this request

isMultiSelect

public boolean isMultiSelect()

Whether several files may be picked.

Returns

true for multi selection

isDirectories

public boolean isDirectories()

Whether folders are picked.

Returns

true for folders

getPreview

public FilePreviewProvider getPreview()

The preview provider, or null.

Returns

the provider