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

public class OpenFileRequest

  1. Object
  2. FileDialogRequest<OpenFileRequest>
  3. 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 ScaleImageLabel(loadThumbnail(path))),
    result -> {
        if (!result.isCancelled()) {
            for (String p : result.getPaths()) {
                importFile(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 methods

From FileDialogRequest

title, message, acceptLabel, initialDirectory, addFilter, selectedFilter, hint, addOption, accessory, getTitle, getMessage, getAcceptLabel, getInitialDirectory, getFilters, getSelectedFilter, getHint, getBooleanHint, getStringHint, getOptions, getAccessory, toAcceptString

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