Intent.ExtraChooserAdditionalContentUri 欄位

[Android.Runtime.Register("EXTRA_CHOOSER_ADDITIONAL_CONTENT_URI", ApiSince=35)]
public const string ExtraChooserAdditionalContentUri;

[<Android.Runtime.Register("EXTRA_CHOOSER_ADDITIONAL_CONTENT_URI", ApiSince=35)>]
val mutable ExtraChooserAdditionalContentUri : string

欄位值

實作

屬性

RegisterAttribute

備註

可選參數用於提供 ContentProviderUri 一個意圖 #ACTION_CHOOSER ，允許在共享介面中加入更多可切換的項目。

例如，這可用於顯示在使用者整個照片卷中分享的照片，並可選擇更改分享的照片集合。

當此資訊在 #ACTION_CHOOSER 帶有 #ACTION_SEND 或 #ACTION_SEND_MULTIPLE 目標意圖的 Intent 中提供時，sharesheet 會查詢（見 ContentProvider#query(Uri, String[], Bundle, CancellationSignal)）此 URI，以取得一組可供選擇的額外項目。 內容提供者回傳的項目集合預期包含參數中所有項目 #EXTRA_STREAM ，並依相對順序排列，該項目會被標記為已選取。 URI 的權限必須與 URI 提供 #EXTRA_STREAM 或由提供者回傳的任何共享項目不同。

Bundle方法的ContentProvider#query(Uri, String[], Bundle, CancellationSignal)參數會包含 Chooser 啟動時的原始意圖，作為#EXTRA_INTENT當前分享會話的上下文。 回傳 android.database.Cursor 的欄位應包含 android.service.chooser.AdditionalContentContract.Columns#URI 項目 URI 的欄位，並可選擇性地新增 AdditionalContentContract.CursorExtraKeys#POSITION 指定游標起始位置的欄位;該位置的項目預期與 由 #EXTRA_CHOOSER_FOCUSED_ITEM_POSITION所指定的項目相符。

當使用者進行選擇變更時， ContentProvider#call(String, String, Bundle) 會呼叫「method」參數 android.service.chooser.AdditionalContentContract.MethodNames#ON_SELECTION_CHANGED為 ，「arg」參數設為該參數的值，「extras」 Bundle 參數包含 #EXTRA_INTENT 原始意圖的鍵，但目標意圖已修改——選擇器會根據使用者所做的選擇變更修改目標意圖。 應用程式可實作此方法，透過返回結果包中的新值來更改以下任一 Chooser 參數：#EXTRA_CHOOSER_TARGETS， #EXTRA_ALTERNATE_INTENTS， #EXTRA_CHOOSER_CUSTOM_ACTIONS#EXTRA_CHOOSER_MODIFY_SHARE_ACTION#EXTRA_METADATA_TEXT#EXTRA_CHOOSER_REFINEMENT_INTENT_SENDER#EXTRA_CHOOSER_RESULT_INTENT_SENDER。

Java 文件 android.content.Intent.EXTRA_CHOOSER_ADDITIONAL_CONTENT_URI。

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