Intent.ActionOpenDocument フィールド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
アクティビティ アクション: ユーザーが 1 つ以上の既存のドキュメントを選択して返すことを許可します。
[Android.Runtime.Register("ACTION_OPEN_DOCUMENT")]
public const string ActionOpenDocument;
[<Android.Runtime.Register("ACTION_OPEN_DOCUMENT")>]
val mutable ActionOpenDocument : string
フィールド値
実装
- 属性
注釈
アクティビティ アクション: ユーザーが 1 つ以上の既存のドキュメントを選択して返すことを許可します。 呼び出されると、システムはデバイスにインストールされているさまざまな DocumentsProvider インスタンスを表示し、ユーザーが対話形式でインスタンス間を移動できるようにします。 これらのドキュメントには、写真やビデオなどのローカル メディアや、インストールされているクラウド ストレージ プロバイダーによって提供されるドキュメントが含まれます。
各ドキュメントは、content://によってサポートされるDocumentsProvider URI として表され、ContentResolver#openFileDescriptor(Uri, String)を使用してストリームとして開いたり、android.provider.DocumentsContract.Documentメタデータを照会したりできます。
選択したすべてのドキュメントは、永続化可能な読み取りおよび書き込みアクセス許可の許可を持つ呼び出し元アプリケーションに返されます。 デバイスの再起動を通じてドキュメントへのアクセスを維持する場合は、 ContentResolver#takePersistableUriPermission(Uri, int)を使用して永続化可能なアクセス許可を明示的に取得する必要があります。
呼び出し元は、 #setType(String)を介して許容されるドキュメント MIME の種類を示す必要があります。 たとえば、写真を選択するには、 image/*を使用します。 複数の非結合 MIME タイプが許容される場合は、 #EXTRA_MIME_TYPES で定義し、*/* に #setType(String) します。
呼び出し元が複数の返された項目 (複数の選択を実行しているユーザー) を処理できる場合は、 #EXTRA_ALLOW_MULTIPLE を指定してこれを示すことができます。
呼び出し元は、#CATEGORY_OPENABLEで開くことができる URI を取得するために、意図にContentResolver#openFileDescriptor(Uri, String)を含める必要があります。
呼び出し元は、 DocumentsContract#EXTRA_INITIAL_URI を介してドキュメント URI を設定して、ドキュメント ナビゲーターの最初の場所を示すことができます。 指定したドキュメントがフォルダーの場合はナビゲーターを起動し、そうでない場合は指定したドキュメントを含むフォルダーを起動するようにシステムが最善を尽くします。
出力: #getData()で返された、選択された項目の URI。 受信者がアクセスできるように、これは content:// URI である必要があります。 複数のドキュメントが選択されている場合は、 #getClipData()で返されます。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。