ActivityResultContracts.CreateDocument


open class ActivityResultContracts.CreateDocument : ActivityResultContract


An ActivityResultContract to prompt the user to select a path for creating a new document of the given mimeType, returning the content: Uri of the item that was created.

The input is the suggested name for the new file.

This can be extended to override createIntent if you wish to pass additional extras to the Intent created by super.createIntent().

Summary

Public constructors

This function is deprecated. Using a wildcard mime type with CreateDocument is not recommended as it breaks the automatic handling of file extensions.

Public functions

open Intent
@CallSuper
createIntent(context: Context, input: String)

Create an intent that can be used for android.app.Activity.startActivityForResult.

final ActivityResultContract.SynchronousResult<Uri?>?
getSynchronousResult(context: Context, input: String)

An optional method you can implement that can be used to potentially provide a result in lieu of starting an activity.

final Uri?
parseResult(resultCode: Int, intent: Intent?)

Convert result obtained from android.app.Activity.onActivityResult to O.

Public constructors

CreateDocument

Added in 1.2.0
Deprecated in 1.5.0
CreateDocument()

CreateDocument

Added in 1.5.0
CreateDocument(mimeType: String)

Public functions

createIntent

Added in 1.2.0
@CallSuper
open fun createIntent(context: Context, input: String): Intent

Create an intent that can be used for android.app.Activity.startActivityForResult.

getSynchronousResult

Added in 1.2.0
final fun getSynchronousResult(context: Context, input: String): ActivityResultContract.SynchronousResult<Uri?>?

An optional method you can implement that can be used to potentially provide a result in lieu of starting an activity.

Returns
ActivityResultContract.SynchronousResult<Uri?>?

the result wrapped in a SynchronousResult or null if the call should proceed to start an activity.

parseResult

Added in 1.10.0-rc01
final fun parseResult(resultCode: Int, intent: Intent?): Uri?

Convert result obtained from android.app.Activity.onActivityResult to O.