Fragment クラス

定義

フラグメントは、 に配置できるアプリケーションのユーザー インターフェイスまたは動作の一部です Activity

[Android.Runtime.Register("android/app/Fragment", DoNotGenerateAcw=true)]
public class Fragment : Java.Lang.Object, Android.Content.IComponentCallbacks2, Android.Views.View.IOnCreateContextMenuListener, IDisposable, Java.Interop.IJavaPeerable
[<Android.Runtime.Register("android/app/Fragment", DoNotGenerateAcw=true)>]
type Fragment = class
    inherit Object
    interface IComponentCallbacks2
    interface IComponentCallbacks
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface View.IOnCreateContextMenuListener
継承
Fragment
派生
属性
実装

注釈

フラグメントは、 に配置できるアプリケーションのユーザー インターフェイスまたは動作の一部です Activity。 フラグメントとの相互作用は、 と Fragment#getFragmentManager() Fragment.getFragmentManager()を介して取得できる を介してFragmentManagerActivity#getFragmentManager() Activity.getFragmentManager()行われます。

Fragment クラスは、さまざまな方法でさまざまな結果を得ることができます。 コアでは、より大きな Activity内で実行されている特定の操作またはインターフェイスを表します。 フラグメントは、存在するアクティビティに密接に関連付けられており、1 つを除いて使用することはできません。 Fragment は独自のライフサイクルを定義しますが、そのライフサイクルはそのアクティビティに依存します。アクティビティが停止した場合、その中のフラグメントを開始することはできません。アクティビティが破棄されると、すべてのフラグメントが破棄されます。

Fragment のすべてのサブクラスには、引数なしのパブリック コンストラクターを含める必要があります。 フレームワークでは、特に状態の復元中に、必要に応じてフラグメント クラスを再インスタンス化することが多く、インスタンス化するにはこのコンストラクターを見つけることができる必要があります。 引数なしのコンストラクターを使用できない場合、状態の復元中にランタイム例外が発生することがあります。

ここで取り上げるトピック: <ol<>li>Older Platforms<li>Lifecycle<li>Layout<li>Back Stack</ol>

<div class="special reference"><h3>Developer Guides</h3>

フラグメントの使用の詳細については、「 Fragments 開発者ガイド」を参照してください。

</部>

"OlderPlatforms"><h3>Older Platforms</h3>

Fragment API は で android.os.Build.VERSION_CODES#HONEYCOMB導入されましたが、 の API のバージョンは を介して androidx.fragment.app.FragmentActivity古いプラットフォームでも使用できます。 詳細については、ブログ投稿 「Fragments For All」 を参照してください。

"Lifecycle"><h3>Lifecycle</h3>

フラグメントのライフサイクルは自身のアクティビティに関連付けられていますが、標準アクティビティのライフサイクルには独自のしわがあります。 これには、 などの #onResume基本的なアクティビティ ライフサイクル メソッドが含まれますが、アクティビティと UI の生成との相互作用に関連するメソッドも重要です。

フラグメントを再開状態 (ユーザーと対話) するために呼び出されるライフサイクル メソッドのコア シリーズは次のとおりです。

<フラグメントがそのアクティビティに関連付けられると、ol><li>#onAttach が呼び出されます。 <li>#onCreate は、フラグメントの初期作成を行うために 呼び出されます。 <li>#onCreateView はフラグメントに関連付けられたビュー階層を作成して返します。 <li>#onActivityCreated は、そのアクティビティが独自 Activity#onCreate Activity.onCreate()に完了したことをフラグメントに伝えます。 <li>#onViewStateRestored は、そのビュー階層の保存された状態がすべて復元されたことをフラグメントに通知します。 <li>#onStart は、フラグメントをユーザーに表示します (開始中のアクティビティを含むアクティビティに基づく)。 <li>#onResume は、フラグメントがユーザーとの対話を開始します (再開中のアクティビティを含むアクティビティに基づく)。 </Ol>

フラグメントは使用されなくなったため、逆の一連のコールバックを通過します。

<ol><li>#onPause fragment は、アクティビティが一時停止されているか、フラグメント操作によってアクティビティ内で変更されているため、ユーザーと対話しなくなりました。 <li>#onStop フラグメントは、アクティビティが停止されているか、フラグメント操作によってアクティビティ内で変更されているため、ユーザーに表示されなくなります。 <li>#onDestroyView を使用すると、フラグメントは、そのビューに関連付けられているリソースをクリーンできます。 <li>#onDestroy は、フラグメントの状態の最終的なクリーンアップを行うために 呼び出されます。 <li>#onDetach は、フラグメントがそのアクティビティに関連付けられていない直前に呼び出されます。 </Ol>

"Layout"><h3>Layout</h3>

フラグメントは、アプリケーションのレイアウトの一部として使用できるため、コードをより適切にモジュール化し、実行中の画面にユーザー インターフェイスをより簡単に調整できます。 たとえば、項目の一覧で構成される単純なプログラムを見て、各項目の詳細を表示できます。

アクティビティのレイアウト XML には、レイアウト内にフラグメント インスタンスを埋め込むためのタグを含 &lt;fragment&gt; めることができます。 たとえば、1 つのフラグメントを埋め込む単純なレイアウトを次に示します。

{

このメンバーは非推奨とされます。 Jetpack フラグメント ライブラリandroidx.fragment.app.Fragmentを使用して、すべてのデバイスで一貫した動作を行い、ライフサイクルにアクセスします

android.app.FragmentJava ドキュメント。

このページの一部は、によって作成および共有された作業に基づく変更であり、に記載されている条件に従って使用されます。

コンストラクター

Fragment()

既定のコンストラクターです。

Fragment(IntPtr, JniHandleOwnership)

JNI オブジェクトのマネージド表現を作成するときに使用されるコンストラクター。ランタイムによって呼び出されます。

プロパティ

Activity

このフラグメントが現在関連付けられているアクティビティを返します。

AllowEnterTransitionOverlap

終了遷移と遷移の入力が重複するかどうかを返します。 または、終了遷移と入力遷移が重複するかどうかを設定します。

AllowReturnTransitionOverlap

戻り遷移と再入力遷移が重複するかどうかを返します。 または、戻り遷移と再入力遷移が重複するかどうかを設定します。

Arguments

に指定された引数 (存在する場合) を #setArguments返します。 または、このフラグメントの構築引数を指定します。

ChildFragmentManager

このフラグメント内にフラグメントを配置および管理するためのプライベート FragmentManager を返します。

Class

この Objectのランタイム クラスを返します。

(継承元 Object)
Context

Context現在関連付けられているこのフラグメントを返します。

EnterTransition

ビューを最初のシーンに移動するために使用する遷移を返します。 または、ビューを最初のシーンに移動するために使用する画面切り替えを設定します。

ExitTransition

スタックをポップしないときにフラグメントが削除、非表示、またはデタッチされたときに、ビューをシーン外に移動するために使用される切り替えを返します。 または、スタックをポップしないときにフラグメントが削除、非表示、またはデタッチされたときに、ビューをシーン外に移動するために使用される切り替えを設定します。

FragmentManager

このフラグメントのアクティビティに関連付けられているフラグメントと対話するための FragmentManager を返します。

Handle

基になる Android インスタンスへのハンドル。

(継承元 Object)
Host

このフラグメントのホスト オブジェクトを返します。

Id

このフラグメントが認識する識別子を返します。

IsAdded

フラグメントが現在アクティビティに追加されている場合は true を返します。

IsDetached

フラグメントが UI から明示的にデタッチされている場合は true を返します。

IsHidden

フラグメントが非表示になっている場合は true を返します。

IsInLayout

レイアウトが < を介してアクティビティ ビュー階層の一部として含まれている場合は true を返します。フラグメント>タグ。

IsRemoving

このフラグメントが現在アクティビティから削除されている場合は true を返します。

IsResumed

フラグメントが再開された状態の場合は true を返します。

IsStateSaved

このフラグメントが追加され、その状態がホストによって既に保存されている場合は true を返します。

IsVisible

フラグメントが現在ユーザーに表示されている場合は true を返します。

JniIdentityHashCode

フラグメントは、 に配置できるアプリケーションのユーザー インターフェイスまたは動作の一部です Activity

(継承元 Object)
JniPeerMembers

フラグメントは、 に配置できるアプリケーションのユーザー インターフェイスまたは動作の一部です Activity

LayoutInflater

このフラグメントのビューのインフレに使用されるキャッシュされた LayoutInflater を返します。

LoaderManager

このフラグメントの LoaderManager を返し、必要に応じて作成します。

ParentFragment

このフラグメントを含む親フラグメントを返します。

PeerReference

フラグメントは、 に配置できるアプリケーションのユーザー インターフェイスまたは動作の一部です Activity

(継承元 Object)
ReenterTransition

戻るスタックがポップされるために、ビューをシーンに移動するために使用される遷移を返します。 または、戻るスタックがポップされるために、ビューをシーンに移動するために使用される切り替えを設定します。

Resources

getActivity().getResources() を返します。

RetainInstance

フラグメント インスタンスをアクティビティの再作成 (構成変更など) で保持するかどうかを制御します。

ReturnTransition

フラグメントがバック スタックをポップするために削除、非表示、またはデタッチされる準備をしているときに、シーンからビューを移動するために使用される切り替えを返します。 または、フラグメントがバック スタックをポップするために削除、非表示、またはデタッチされる準備をしているときに、ビューをシーン外に移動するために使用される切り替えを設定します。

SharedElementEnterTransition

コンテンツ シーンに転送される共有要素に使用される遷移を返します。 または、コンテンツ シーンに転送される共有要素に使用される切り替えを設定します。

SharedElementReturnTransition

戻るスタックのポップ中に転送された共有要素に使用される遷移を返します。 または、バック スタックのポップ中に転送された共有要素に使用される遷移を設定します。

Tag

フラグメントのタグ名を取得します (指定されている場合)。

TargetFragment

によって設定されたターゲット フラグメントを #setTargetFragment返します。

TargetRequestCode

によって設定されたターゲット要求コードを #setTargetFragment返します。

ThresholdClass

この API は Mono for Android インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。

ThresholdType

この API は Mono for Android インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。

UserVisibleHint

このフラグメントの UI がユーザーに現在表示されているかどうかについてのヒントをシステムに設定します。

View

フラグメントのレイアウト (によって返されるレイアウト) のルート ビューを取得します (指定されている #onCreateView場合)。

メソッド

Clone()

このオブジェクトのコピーを作成して返します。

(継承元 Object)
Dispose()

フラグメントは、 に配置できるアプリケーションのユーザー インターフェイスまたは動作の一部です Activity

(継承元 Object)
Dispose(Boolean)

フラグメントは、 に配置できるアプリケーションのユーザー インターフェイスまたは動作の一部です Activity

(継承元 Object)
Dump(String, FileDescriptor, PrintWriter, String[])

フラグメントの状態を指定されたストリームに出力します。

Equals(Object)
古い.

サブクラスは equals() をオーバーライドできません。

GetHashCode()
古い.

サブクラスは hashCode() をオーバーライドできません。

GetString(Int32)

アプリケーションのパッケージの既定の文字列テーブルからローカライズされた文字列を返します。

GetString(Int32, Object[])

アプリケーションのパッケージの既定の文字列テーブルからローカライズされた文字列を返します。

GetText(Int32)

アプリケーションのパッケージの既定の文字列テーブルから、ローカライズされたスタイルの CharSequence を返します。

GetTextFormatted(Int32)

アプリケーションのパッケージの既定の文字列テーブルから、ローカライズされたスタイルの CharSequence を返します。

Instantiate(Context, String)

と同じです #instantiate(Context, String, Bundle) が、null 引数 Bundle を指定します。

Instantiate(Context, String, Bundle)

指定したクラス名を持つ Fragment の新しいインスタンスを作成します。

JavaFinalize()

オブジェクトへの参照がなくなったとガベージ コレクションが判断したときに、オブジェクトのガベージ コレクターによって呼び出されます。

(継承元 Object)
Notify()

このオブジェクトのモニターで待機している 1 つのスレッドを起動します。

(継承元 Object)
NotifyAll()

このオブジェクトのモニターで待機しているすべてのスレッドを起動します。

(継承元 Object)
OnActivityCreated(Bundle)

フラグメントのアクティビティが作成され、このフラグメントのビュー階層がインスタンス化されたときに呼び出されます。

OnActivityResult(Int32, Result, Intent)

の前の呼び出しから結果を #startActivityForResult(Intent, int)受け取ります。

OnAttach(Activity)

このメンバーは非推奨とされます。

OnAttach(Context)

フラグメントがそのコンテキストに最初にアタッチされるときに呼び出されます。

OnAttachFragment(Fragment)

フラグメントがこのフラグメントの子としてアタッチされるときに呼び出されます。

OnConfigurationChanged(Configuration)

コンポーネントの実行中にデバイス構成が変更されたときにシステムによって呼び出されます。

OnContextItemSelected(IMenuItem)

このフックは、コンテキスト メニューの項目が選択されるたびに呼び出されます。

OnCreate(Bundle)

フラグメントの初期作成を行うために呼び出されます。

OnCreateAnimator(FragmentTransit, Boolean, Int32)

フラグメントがアニメーションを読み込むときに呼び出されます。

OnCreateContextMenu(IContextMenu, View, IContextMenuContextMenuInfo)

view コンテキスト メニューが表示されるときに呼び出されます。

OnCreateOptionsMenu(IMenu, MenuInflater)

アクティビティの標準オプション メニューの内容を初期化します。

OnCreateView(LayoutInflater, ViewGroup, Bundle)

フラグメントがユーザー インターフェイス ビューをインスタンス化するために呼び出されます。

OnDestroy()

フラグメントが使用されなくなったときに呼び出されます。

OnDestroyOptionsMenu()

このフラグメントのオプション メニュー項目がオプション メニュー全体に含まれなくなったときに呼び出されます。

OnDestroyView()

によって以前に作成 #onCreateView されたビューがフラグメントからデタッチされたときに呼び出されます。

OnDetach()

フラグメントがアクティビティにアタッチされなくなったときに呼び出されます。

OnGetLayoutInflater(Bundle)

このフラグメントのビューをインフレに使用する LayoutInflater を返します。

OnHiddenChanged(Boolean)

(フラグメントの によって #isHidden() 返される) 非表示状態が変更されたときに呼び出されます。

OnInflate(Activity, IAttributeSet, Bundle)

このメンバーは非推奨とされます。

OnInflate(Context, IAttributeSet, Bundle)

フラグメントがビュー レイアウトのインフレーションの一部として作成されるときに呼び出されます。通常はアクティビティのコンテンツ ビューの設定から呼び出されます。

OnInflate(IAttributeSet, Bundle)
古い.

このメンバーは非推奨とされます。

OnLowMemory()

これは、システム全体がメモリ不足で実行されていて、アクティブに実行されているプロセスがメモリ使用量をトリミングする必要がある場合に呼び出されます。

OnMultiWindowModeChanged(Boolean)

フラグメントのアクティビティが全画面表示モードからマルチウィンドウ モードに変更され、その逆の場合に呼び出されます。

OnMultiWindowModeChanged(Boolean, Configuration)

フラグメントのアクティビティが全画面表示モードからマルチウィンドウ モードに変更され、その逆の場合に呼び出されます。

OnOptionsItemSelected(IMenuItem)

このフックは、オプション メニューの項目が選択されるたびに呼び出されます。

OnOptionsMenuClosed(IMenu)

このフックは、オプション メニューが閉じられるたびに呼び出されます (ユーザーが [戻る]/[メニュー] ボタンでメニューを取り消すか、項目が選択されている場合)。

OnPause()

フラグメントが再開されなくなったときに呼び出されます。

OnPictureInPictureModeChanged(Boolean)

アクティビティがピクチャインピクチャ モードとの間で切り替わるときにシステムによって呼び出されます。

OnPictureInPictureModeChanged(Boolean, Configuration)

アクティビティがピクチャインピクチャ モードとの間で切り替わるときにシステムによって呼び出されます。

OnPrepareOptionsMenu(IMenu)

画面の標準オプション メニューを表示する準備をします。

OnRequestPermissionsResult(Int32, String[], Permission[])

アクセス許可を要求した結果のコールバック。

OnResume()

フラグメントがユーザーに表示され、アクティブに実行されている場合に呼び出されます。

OnSaveInstanceState(Bundle)

現在の動的状態を保存するようにフラグメントに要求するために呼び出され、後でプロセスの新しいインスタンスで再構築が再開されるようにします。

OnStart()

フラグメントがユーザーに表示されるときに呼び出されます。

OnStop()

フラグメントが開始されなくなったときに呼び出されます。

OnTrimMemory(TrimMemory)

不要なメモリをプロセスからトリミングする適切なタイミングであるとオペレーティング システムが判断したときに呼び出されます。

OnViewCreated(View, Bundle)

が返された直後 #onCreateView(LayoutInflater, ViewGroup, Bundle) に呼び出されますが、保存された状態がビューに復元される前に呼び出されます。

OnViewStateRestored(Bundle)

保存されたすべての状態がフラグメントのビュー階層に復元されたときに呼び出されます。

PostponeEnterTransition()

または が呼び出されるまで#startPostponedEnterTransition()FragmentManager#executePendingTransactions()、入っているフラグメント遷移を延期します。

RegisterForContextMenu(View)

特定のビューに対して表示するコンテキスト メニューを登録します (複数のビューでコンテキスト メニューを表示できます)。

RequestPermissions(String[], Int32)

このアプリケーションに付与するアクセス許可を要求します。

SetEnterSharedElementCallback(SharedElementCallback)

カスタム遷移がフラグメントと共に使用される場合、戻るスタックをポップしないときにこのフラグメントがアタッチまたはデタッチされると、enter 遷移コールバックが呼び出されます。

SetExitSharedElementCallback(SharedElementCallback)

フラグメントでカスタム遷移を使用する場合、スタックをポップするときにこのフラグメントがアタッチまたはデタッチされると、終了遷移コールバックが呼び出されます。

SetHandle(IntPtr, JniHandleOwnership)

Handle プロパティを設定します。

(継承元 Object)
SetHasOptionsMenu(Boolean)

このフラグメントは、 および 関連するメソッドの呼び出しを受け取ってオプション メニューの設定に #onCreateOptionsMenu 参加したいと報告します。

SetInitialSavedState(Fragment+SavedState)

によって返 FragmentManager#saveFragmentInstanceState(Fragment) FragmentManager.saveFragmentInstanceStateされるように、最初の構築時にこのフラグメントがそれ自体を復元する必要がある初期保存状態を設定します。

SetMenuVisibility(Boolean)

このフラグメントのメニューを表示するかどうかを示すヒントを設定します。

SetTargetFragment(Fragment, Int32)

このフラグメントのオプションのターゲット。

ShouldShowRequestPermissionRationale(String)

アクセス許可を要求する前に、根拠のある UI を表示する必要があるかどうかを取得します。

StartActivity(Intent)

フラグメントに含まれる Activity から を呼び出します Activity#startActivity(Intent)

StartActivity(Intent, Bundle)

フラグメントに含まれる Activity から を呼び出します Activity#startActivity(Intent, Bundle)

StartActivityForResult(Intent, Int32)

フラグメントに含まれる Activity から を呼び出します Activity#startActivityForResult(Intent, int)

StartActivityForResult(Intent, Int32, Bundle)

フラグメントに含まれる Activity から を呼び出します Activity#startActivityForResult(Intent, int, Bundle)

StartIntentSenderForResult(IntentSender, Int32, Intent, ActivityFlags, ActivityFlags, Int32, Bundle)

フラグメントに含まれる Activity から を呼び出します Activity#startIntentSenderForResult(IntentSender, int, Intent, int, int, int, Bundle)

StartPostponedEnterTransition()

が呼び出された後 #postponeEnterTransition() に、延期された遷移を開始します。

ToArray<T>()

フラグメントは、 に配置できるアプリケーションのユーザー インターフェイスまたは動作の一部です Activity

(継承元 Object)
ToString()

オブジェクトの文字列形式を返します。

(継承元 Object)
UnregisterForContextMenu(View)

指定したビューに対してコンテキスト メニューが表示されないようにします。

UnregisterFromRuntime()

フラグメントは、 に配置できるアプリケーションのユーザー インターフェイスまたは動作の一部です Activity

(継承元 Object)
Wait()

現在のスレッドが起動するまで待機します。通常<は、通知</em> または>< em 中断</em によって待機します>。>

(継承元 Object)
Wait(Int64)

現在のスレッドが起動するまで待機します。通常<は、通知></em> または <>em 中断</em>、または特定のリアルタイムが経過するまで待機します。

(継承元 Object)
Wait(Int64, Int32)

現在のスレッドが起動するまで待機します。通常<は、通知></em> または <>em 中断</em>、または特定のリアルタイムが経過するまで待機します。

(継承元 Object)

明示的なインターフェイスの実装

IJavaPeerable.Disposed()

フラグメントは、 に配置できるアプリケーションのユーザー インターフェイスまたは動作の一部です Activity

(継承元 Object)
IJavaPeerable.DisposeUnlessReferenced()

フラグメントは、 に配置できるアプリケーションのユーザー インターフェイスまたは動作の一部です Activity

(継承元 Object)
IJavaPeerable.Finalized()

フラグメントは、 に配置できるアプリケーションのユーザー インターフェイスまたは動作の一部です Activity

(継承元 Object)
IJavaPeerable.JniManagedPeerState

フラグメントは、 に配置できるアプリケーションのユーザー インターフェイスまたは動作の一部です Activity

(継承元 Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)

フラグメントは、 に配置できるアプリケーションのユーザー インターフェイスまたは動作の一部です Activity

(継承元 Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

フラグメントは、 に配置できるアプリケーションのユーザー インターフェイスまたは動作の一部です Activity

(継承元 Object)
IJavaPeerable.SetPeerReference(JniObjectReference)

フラグメントは、 に配置できるアプリケーションのユーザー インターフェイスまたは動作の一部です Activity

(継承元 Object)

拡張メソッド

JavaCast<TResult>(IJavaObject)

Android ランタイムチェック型変換を実行します。

JavaCast<TResult>(IJavaObject)

フラグメントは、 に配置できるアプリケーションのユーザー インターフェイスまたは動作の一部です Activity

GetJniTypeName(IJavaPeerable)

フラグメントは、 に配置できるアプリケーションのユーザー インターフェイスまたは動作の一部です Activity

適用対象