Skip to content

Most visited

Recently visited

navigation

WebChromeClient.FileChooserParams

public static abstract class WebChromeClient.FileChooserParams
extends Object

java.lang.Object
   ↳ android.webkit.WebChromeClient.FileChooserParams


Parameters used in the onShowFileChooser(WebView, ValueCallback, WebChromeClient.FileChooserParams) method.

Summary

Constants

int MODE_OPEN

Open single file.

int MODE_OPEN_MULTIPLE

Like Open but allows multiple files to be selected.

int MODE_SAVE

Allows picking a nonexistent file and saving it.

Public constructors

WebChromeClient.FileChooserParams()

Public methods

abstract Intent createIntent()

Creates an intent that would start a file picker for file selection.

abstract String[] getAcceptTypes()

Returns an array of acceptable MIME types.

abstract String getFilenameHint()

The file name of a default selection if specified, or null.

abstract int getMode()

Returns file chooser mode.

abstract CharSequence getTitle()

Returns the title to use for this file selector, or null.

abstract boolean isCaptureEnabled()

Returns preference for a live media captured value (e.g.

static Uri[] parseResult(int resultCode, Intent data)

Parse the result returned by the file picker activity.

Inherited methods

From class java.lang.Object

Constants

MODE_OPEN

added in API level 21
int MODE_OPEN

Open single file. Requires that the file exists before allowing the user to pick it.

Constant Value: 0 (0x00000000)

MODE_OPEN_MULTIPLE

added in API level 21
int MODE_OPEN_MULTIPLE

Like Open but allows multiple files to be selected.

Constant Value: 1 (0x00000001)

MODE_SAVE

added in API level 21
int MODE_SAVE

Allows picking a nonexistent file and saving it.

Constant Value: 3 (0x00000003)

Public constructors

WebChromeClient.FileChooserParams

added in API level 21
WebChromeClient.FileChooserParams ()

Public methods

createIntent

added in API level 21
Intent createIntent ()

Creates an intent that would start a file picker for file selection. The Intent supports choosing files from simple file sources available on the device. Some advanced sources (for example, live media capture) may not be supported and applications wishing to support these sources or more advanced file operations should build their own Intent.

 How to use:
 1. Build an intent using createIntent()
 2. Fire the intent using startActivityForResult(Intent, int).
 3. Check for ActivityNotFoundException and take a user friendly action if thrown.
 4. Listen the result using onActivityResult(int, int, Intent)
 5. Parse the result using parseResult(int, Intent) only if media capture was not requested.
 6. Send the result using filePathCallback of onShowFileChooser(WebView, ValueCallback, WebChromeClient.FileChooserParams)
 

Returns
Intent an Intent that supports basic file chooser sources.

getAcceptTypes

added in API level 21
String[] getAcceptTypes ()

Returns an array of acceptable MIME types. The returned MIME type could be partial such as audio/*. The array will be empty if no acceptable types are specified.

Returns
String[]

getFilenameHint

added in API level 21
String getFilenameHint ()

The file name of a default selection if specified, or null.

Returns
String

getMode

added in API level 21
int getMode ()

Returns file chooser mode.

Returns
int

getTitle

added in API level 21
CharSequence getTitle ()

Returns the title to use for this file selector, or null. If null a default title should be used.

Returns
CharSequence

isCaptureEnabled

added in API level 21
boolean isCaptureEnabled ()

Returns preference for a live media captured value (e.g. Camera, Microphone). True indicates capture is enabled, false disabled. Use getAcceptTypes to determine suitable capture devices.

Returns
boolean

parseResult

added in API level 21
Uri[] parseResult (int resultCode, 
                Intent data)

Parse the result returned by the file picker activity. This method should be used with createIntent(). Refer to createIntent() for how to use it.

Parameters
resultCode int: the integer result code returned by the file picker activity.

data Intent: the intent returned by the file picker activity.

Returns
Uri[] the Uris of selected file(s) or null if the resultCode indicates activity canceled or any other error.

This site uses cookies to store your preferences for site-specific language and display options.

Get the latest Android developer news and tips that will help you find success on Google Play.

* Required Fields

Hooray!

Follow Google Developers on WeChat

Browse this site in ?

You requested a page in , but your language preference for this site is .

Would you like to change your language preference and browse this site in ? If you want to change your language preference later, use the language menu at the bottom of each page.

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a short survey?
Help us improve the Android developer experience.
(Sep 2017 survey)