Class OpenFileRequest

java.lang.Object

com.codename1.io.filechooser.FileDialogRequest<OpenFileRequest>

com.codename1.io.filechooser.OpenFileRequest

public class OpenFileRequest
extends FileDialogRequest<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.

Constructor Summary

Constructors

Constructor	Description
OpenFileRequest()

Method Summary

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

Methods inherited from class FileDialogRequest

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

Methods inherited from class Object

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

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: 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: 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: 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