java.lang.Object | |
↳ | com.google.android.gms.drive.CreateFileActivityBuilder |
A builder that is used to configure and display the create file activity. This dialog creates a new file in the user's drive with a destination and file title selected by the user. If the device is currently offline, the file will be created locally and committed to the server when connectivity is restored.
To create a new DriveFile
, the following objects should be provided through the setters
in this class before build(GoogleApiClient)
is called:
DriveContents
, created using newDriveContents(GoogleApiClient)
, used to write the
file contents, and provided here through setInitialDriveContents(DriveContents)
.
MetadataChangeSet
, created through a MetadataChangeSet.Builder
, used to
specify the initial file metadata and provided here through
setInitialMetadata(MetadataChangeSet)
.
To display the activity, pass the result of build(GoogleApiClient)
to #startActivityForResult()
.
When the activity completes, a successful response will include an extra
EXTRA_RESPONSE_DRIVE_ID
that specifies the DriveId
for the newly created file.
Note: you cannot use #startActivity
to invoke the activity. This will fail.
Constants | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
String | EXTRA_RESPONSE_DRIVE_ID | A successful result will return an extra by this name which will contain the DriveId
of the created file. |
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Gets an Intent that can be used to start the Create File activity.
| |||||||||||
Sets the default folder that will be presented at activity startup as the location for
file creation.
| |||||||||||
Sets the title displayed in the activity.
| |||||||||||
This method is deprecated.
use
setInitialDriveContents(DriveContents) instead.
| |||||||||||
Sets the initial
DriveContents for the new file. | |||||||||||
Sets the initial metadata for the new file.
|
[Expand]
Inherited Methods | |||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
![]() |
A successful result will return an extra by this name which will contain the DriveId
of the created file.
Gets an Intent that can be used to start the Create File activity. Note that you must start
this activity with startActivityForResult
, not startActivity
. Once this is
invoked, the provided contents are finalized and cannot be edited. To make additional edits,
reopen the contents with the returned DriveId.
apiClient | The GoogleApiClient to service the call. The client must be
connected before invoking this method and must have a scope to create files in the
target directory (e.g. SCOPE_FILE ).
|
---|
Sets the default folder that will be presented at activity startup as the location for file creation. The activity supports navigation from this point to other folders. If not set, defaults to the root folder in the user's Drive.
If this method is called multiple times before build(GoogleApiClient)
, the last call will overwrite
any previous value.
Sets the title displayed in the activity.
If this method is called multiple times before build(GoogleApiClient)
, the last call will overwrite
any previous value.
title | the title to set on the activity (may not be null) |
---|
Sets the initial DriveContents
for the new file. This will persist the contents as
the initial contents for the file. To continue editing the contents, open them again through
open(GoogleApiClient, int, DriveFile.DownloadProgressListener)
once the file has been created.
This method must always be called or the build(GoogleApiClient)
method will fail. If this method is
called multiple times before build(GoogleApiClient)
, the last call will overwrite any previous value.
driveContents | The initial contents. The provided contents must have been obtained
through newDriveContents(GoogleApiClient) . This DriveContents cannot be reused
after this method returns.
|
---|
Sets the initial metadata for the new file.
This method must be called or the build(GoogleApiClient)
method will fail. A new
MetadataChangeSet
can be created using MetadataChangeSet.Builder
. If this
method is called multiple times before build(GoogleApiClient)
, the last call will overwrite any
previous value.