Intent.ActionGetContent フィールド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
アクティビティ アクション: ユーザーが特定の種類のデータを選択して返すことを許可します。
[Android.Runtime.Register("ACTION_GET_CONTENT")]
public const string ActionGetContent;[<Android.Runtime.Register("ACTION_GET_CONTENT")>]
val mutable ActionGetContent : stringフィールド値
実装
- 属性
注釈
アクティビティ アクション: ユーザーが特定の種類のデータを選択して返すことを許可します。 これは、ここでは、ユーザーが選択できる既存のデータの URI ではなく、必要なデータの種類を示すという点とは #ACTION_PICK 異なります。 ACTION_GET_CONTENTを使用すると、ユーザーは実行時にデータを作成し (写真を撮ったり、サウンドを録音したり)、Web を参照して目的のデータをダウンロードしたりすることができます。
このアクションを使用するには、主に 2 つの方法があります。個人の連絡先などの特定の種類のデータが必要な場合は、MIME の種類を目的のデータの種類に設定し、それを Context#startActivity(Intent)起動します。 その後、システムは最適なアプリケーションを起動して、その種類のデータを選択します。
また、ユーザーが選択できる一連のコンテンツにも関心がある場合があります。 たとえば、ユーザーが電子メール メッセージに添付ファイルを追加できるようにする電子メール アプリケーションでは、このアクションを使用して、ユーザーが添付できるすべての種類のコンテンツの一覧を表示できます。
この場合は、GET_CONTENT意図を chooser (through #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 である必要があります。
の Java ドキュメントandroid.content.Intent.ACTION_GET_CONTENT
このページの一部は、Android オープンソース プロジェクトによって作成および共有され、クリエイティブ コモンズ 2.5 属性ライセンスに記載されている条件に従って使用される作業に基づく変更です。