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

public final class FileDialogHints

Object
FileDialogHints

Platform specific hints for FileDialogRequest#hint(String, Object).

A hint tunes a native dialog in a way only some platforms can. A platform that does not know a hint ignores it, so an application can set every hint it cares about unconditionally. The prefix names the platform that reads it.

Fields

`public static final` `String MAC_SHOWS_TAG_FIELD = "mac.showsTagField"`	`Boolean`: show the Finder tag field in a macOS save panel.
`public static final` `String MAC_CAN_CREATE_DIRECTORIES = "mac.canCreateDirectories"`	`Boolean`: allow creating folders from a macOS panel.
`public static final` `String MAC_SHOWS_HIDDEN_FILES = "mac.showsHiddenFiles"`	`Boolean`: show hidden files in a macOS panel.
`public static final` `String MAC_CAN_SELECT_HIDDEN_EXTENSION = "mac.canSelectHiddenExtension"`	`Boolean`: let the user hide the extension in a macOS save panel.
`public static final` `String MAC_TREATS_PACKAGES_AS_DIRECTORIES = "mac.treatsFilePackagesAsDirectories"`	`Boolean`: treat packages (`.app`, `.bundle`) as folders in a macOS open panel.
`public static final` `String IOS_SHOWS_FILE_EXTENSIONS = "ios.showsFileExtensions"`	`Boolean`: show file extensions in the iOS document picker.
`public static final` `String IOS_EXPORT_AS_MOVE = "ios.exportAsMove"`	`Boolean`: move rather than copy the exported file on iOS.
`public static final` `String ANDROID_INITIAL_URI = "android.initialUri"`	`String`: a `content://` URI the Android picker starts in.
`public static final` `String ANDROID_PERSIST_PERMISSION = "android.persistPermission"`	`Boolean`: keep persistable read/write permission to the picked Android document across restarts.
`public static final` `String WIN_CLIENT_GUID = "win.clientGuid"`	`String`: a GUID string; Windows remembers the last folder and size separately per GUID, so different dialogs of one app do not share state.
`public static final` `String WIN_DEFAULT_FOLDER = "win.defaultFolder"`	`String`: the folder Windows shows when the user has no recent folder, as opposed to `FileDialogRequest#initialDirectory`, which always wins.
`public static final` `String DESKTOP_SHOW_HIDDEN = "desktop.showHidden"`	`Boolean`: show hidden files in the GTK chooser and the simulator.

Inherited methods

From Object

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

Field details

MAC_SHOWS_TAG_FIELD

public static final String MAC_SHOWS_TAG_FIELD = "mac.showsTagField"

Boolean: show the Finder tag field in a macOS save panel.

MAC_CAN_CREATE_DIRECTORIES

public static final String MAC_CAN_CREATE_DIRECTORIES = "mac.canCreateDirectories"

Boolean: allow creating folders from a macOS panel. Defaults to true.

MAC_SHOWS_HIDDEN_FILES

public static final String MAC_SHOWS_HIDDEN_FILES = "mac.showsHiddenFiles"

Boolean: show hidden files in a macOS panel.

MAC_CAN_SELECT_HIDDEN_EXTENSION

public static final String MAC_CAN_SELECT_HIDDEN_EXTENSION = "mac.canSelectHiddenExtension"

Boolean: let the user hide the extension in a macOS save panel.

MAC_TREATS_PACKAGES_AS_DIRECTORIES

public static final String MAC_TREATS_PACKAGES_AS_DIRECTORIES = "mac.treatsFilePackagesAsDirectories"

Boolean: treat packages (.app, .bundle) as folders in a macOS open panel.

IOS_SHOWS_FILE_EXTENSIONS

public static final String IOS_SHOWS_FILE_EXTENSIONS = "ios.showsFileExtensions"

Boolean: show file extensions in the iOS document picker.

IOS_EXPORT_AS_MOVE

public static final String IOS_EXPORT_AS_MOVE = "ios.exportAsMove"

Boolean: move rather than copy the exported file on iOS. Defaults to copy.

ANDROID_INITIAL_URI

public static final String ANDROID_INITIAL_URI = "android.initialUri"

String: a content:// URI the Android picker starts in.

ANDROID_PERSIST_PERMISSION

public static final String ANDROID_PERSIST_PERMISSION = "android.persistPermission"

Boolean: keep persistable read/write permission to the picked Android document across restarts.

WIN_CLIENT_GUID

public static final String WIN_CLIENT_GUID = "win.clientGuid"

String: a GUID string; Windows remembers the last folder and size separately per GUID, so different dialogs of one app do not share state.

WIN_DEFAULT_FOLDER

public static final String WIN_DEFAULT_FOLDER = "win.defaultFolder"

String: the folder Windows shows when the user has no recent folder, as opposed to FileDialogRequest#initialDirectory, which always wins.

DESKTOP_SHOW_HIDDEN

public static final String DESKTOP_SHOW_HIDDEN = "desktop.showHidden"

Boolean: show hidden files in the GTK chooser and the simulator.