Intent.ActionGetContent 欄位

[Android.Runtime.Register("ACTION_GET_CONTENT")]
public const string ActionGetContent;

[<Android.Runtime.Register("ACTION_GET_CONTENT")>]
val mutable ActionGetContent : string

欄位值

實作

屬性

RegisterAttribute

備註

活動動作：允許使用者選擇特定類型的資料並回傳。 這和這裡我們只說想要什麼樣的資料不同 #ACTION_PICK ，而不是使用者可以選擇的既有資料的 URI。 ACTION_GET_CONTENT可以讓使用者在資料執行時即時建立（例如拍照或錄音）、瀏覽網頁並下載所需的資料等等。

使用此動作有兩種主要方式：若您需要特定類型的資料，例如人員聯絡人，則將 MIME 類型設定為您想要的資料類型，並啟動 Context#startActivity(Intent)。 系統會啟動最適合的應用程式，幫你選擇這類資料。

你也可能對用戶可選擇的一系列內容類型感興趣。 例如，一個電子郵件應用程式希望讓使用者在電子郵件訊息中加入附件，可以透過此動作調出所有可附加內容類型的清單。

在這種情況下，你應該用選擇器（透過 #createChooser）包裝 GET_CONTENT 意圖，這樣會提供使用者選擇如何傳送資料的正確介面，並允許你指定提示說明他們的行為。 你通常會指定一個廣泛的 MIME 類型（例如 image/* 或 */*），讓使用者能從中選擇多種內容類型。

在使用如此廣泛的GET_CONTENT動作時，通常只從可被表示為串流的資料中選擇。 這是透過要求意圖中達成的 #CATEGORY_OPENABLE 。

呼叫者可選擇性地指定 #EXTRA_LOCAL_ONLY ，要求啟動的內容選擇器只回傳代表裝置本地可得資料的結果。 例如，若此額外設定為 true，圖片選擇器不應顯示遠端伺服器可取得但本地裝置尚未取得的圖片（因此開啟時必須下載）。

如果呼叫者能處理多個回傳項目（即使用者執行多次選擇），則可指定 #EXTRA_ALLOW_MULTIPLE 以標示此項。

輸入： #getType 是想要檢索的 MIME 類型。 請注意，意圖中不會提供 URI，因為回傳資料的原始來源沒有限制。 你也可以包含 #CATEGORY_OPENABLE 只能接受可作為串流開啟的資料。 你可以用 #EXTRA_LOCAL_ONLY 來限制內容選擇僅限於本地資料。 你可以用來 #EXTRA_ALLOW_MULTIPLE 讓使用者選擇多個項目。

輸出：被選取項目的 URI。 這必須是 URI 內容，讓任何接收者都能存取。

Java 文件 android.content.Intent.ACTION_GET_CONTENT。

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