語言

Intent.ActionOpenDocument 欄位

定義

活動動作:允許使用者選擇並返回一份或多份現有文件。

[Android.Runtime.Register("ACTION_OPEN_DOCUMENT")]
public const string ActionOpenDocument;
[<Android.Runtime.Register("ACTION_OPEN_DOCUMENT")>]
val mutable ActionOpenDocument : string

欄位值

實作

屬性

備註

活動動作:允許使用者選擇並返回一份或多份現有文件。 啟動時,系統會顯示裝置上安裝的各種 DocumentsProvider 實例,讓使用者能互動地瀏覽。 這些文件包括本地媒體,如照片和影片,以及由已安裝的雲端儲存供應商提供的文件。

每份文件以 content:// URI 表示,並以 DocumentsProvider作為 支援,可以 為串流 ContentResolver#openFileDescriptor(Uri, String)開啟,或查詢元 android.provider.DocumentsContract.Document 資料。

所有被選中的文件都會以持久的讀寫權限回傳給呼叫應用程式。 如果你想在裝置重啟後維持對文件的存取權,你需要明確使用 ContentResolver#takePersistableUriPermission(Uri, int)

來電者必須透過 標示可接受的文件 MIME 類型。#setType(String) 例如,要選取照片,請使用 image/*。 如果多個不相交的 MIME 類型被接受,請將它們定義在 #EXTRA_MIME_TYPES#setType(String) 和 到 */*。

如果呼叫者能處理多個回傳項目(使用者執行多次選擇),你可以指定 #EXTRA_ALLOW_MULTIPLE 此項。

來電者必須在意圖中包含 #CATEGORY_OPENABLE 才能取得可開啟的 ContentResolver#openFileDescriptor(Uri, String)URI。

呼叫者可以透過 URI DocumentsContract#EXTRA_INITIAL_URI 設定文件,以指示文件的初始位置,導航器。 系統會盡力在指定文件中啟動導航器(如果是資料夾),如果不是該文件的資料夾,就會啟動。

輸出:被選取項目的 URI,回傳於 #getData()。 這必須是 content:// URI,讓任何接收者都能存取。 若選取多份文件,則會以 返回。#getClipData()

Java 文件 android.content.Intent.ACTION_OPEN_DOCUMENT

本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。

適用於

另請參閱