Intent.ActionGetContent 欄位

定義

命名空間:

Android.Content

組件:

Mono.Android.dll

活動動作：允許用戶選取特定種類的數據並傳回它。

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

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

欄位值

String

實作

ContentsFileDescriptor

屬性

RegisterAttribute

備註

活動動作：允許用戶選取特定種類的數據並傳回它。 這不同於 #ACTION_PICK 此處，我們只是說想要何種數據，而不是使用者可從中挑選的現有數據 URI。 ACTION_GET_CONTENT可讓使用者在數據執行時建立數據（例如拍照或錄製音效），讓他們流覽網頁並下載所需的數據等。

有兩個主要方式可以使用此動作：如果您想要特定類型的數據，例如人員聯繫人，您可以將MIME類型設定為您想要的數據類型，並使用 加以啟動 Context#startActivity(Intent)。 系統接著會啟動最佳應用程式，為您選取該類型的數據。

您也可以對使用者可以挑選的任何一組內容類型感興趣。 例如，想要允許使用者將附件新增至電子郵件訊息的電子郵件應用程式，可以使用此動作來顯示使用者可以附加之所有內容類型的清單。

在此情況下，您應該將GET_CONTENT意圖包裝成選擇器（透過 #createChooser），這會為使用者提供適當的介面，以挑選如何傳送您的數據，並允許您指定提示，指出他們正在做什麼。 您通常會指定廣泛的 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，讓任何接收者都可以存取它。

的 android.content.Intent.ACTION_GET_CONTENTJava 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。