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