Fragment クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
フラグメントは、 に配置できるアプリケーションのユーザー インターフェイスまたは動作の一部です 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
- 継承
- 派生
- 属性
- 実装
注釈
フラグメントは、 に配置できるアプリケーションのユーザー インターフェイスまたは動作の一部です Activity
。 フラグメントとの相互作用は、 と Fragment#getFragmentManager() Fragment.getFragmentManager()
を介して取得できる を介してFragmentManager
Activity#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 には、レイアウト内にフラグメント インスタンスを埋め込むためのタグを含 <fragment>
めることができます。 たとえば、1 つのフラグメントを埋め込む単純なレイアウトを次に示します。
{
このメンバーは非推奨とされます。 Jetpack フラグメント ライブラリandroidx.fragment.app.Fragment
を使用して、すべてのデバイスで一貫した動作を行い、ライフサイクルにアクセスします。
の android.app.Fragment
Java ドキュメント。
このページの一部は、によって作成および共有された作業に基づく変更であり、に記載されている条件に従って使用されます。
コンストラクター
Fragment() |
既定のコンストラクターです。 |
Fragment(IntPtr, JniHandleOwnership) |
JNI オブジェクトのマネージド表現を作成するときに使用されるコンストラクター。ランタイムによって呼び出されます。 |
プロパティ
Activity |
このフラグメントが現在関連付けられているアクティビティを返します。 |
AllowEnterTransitionOverlap |
終了遷移と遷移の入力が重複するかどうかを返します。 または、終了遷移と入力遷移が重複するかどうかを設定します。 |
AllowReturnTransitionOverlap |
戻り遷移と再入力遷移が重複するかどうかを返します。 または、戻り遷移と再入力遷移が重複するかどうかを設定します。 |
Arguments |
に指定された引数 (存在する場合) を |
ChildFragmentManager |
このフラグメント内にフラグメントを配置および管理するためのプライベート FragmentManager を返します。 |
Class |
この |
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 |
フラグメントは、 に配置できるアプリケーションのユーザー インターフェイスまたは動作の一部です |
JniPeerMembers |
フラグメントは、 に配置できるアプリケーションのユーザー インターフェイスまたは動作の一部です |
LayoutInflater |
このフラグメントのビューのインフレに使用されるキャッシュされた LayoutInflater を返します。 |
LoaderManager |
このフラグメントの LoaderManager を返し、必要に応じて作成します。 |
ParentFragment |
このフラグメントを含む親フラグメントを返します。 |
PeerReference |
フラグメントは、 に配置できるアプリケーションのユーザー インターフェイスまたは動作の一部です |
ReenterTransition |
戻るスタックがポップされるために、ビューをシーンに移動するために使用される遷移を返します。 または、戻るスタックがポップされるために、ビューをシーンに移動するために使用される切り替えを設定します。 |
Resources |
|
RetainInstance |
フラグメント インスタンスをアクティビティの再作成 (構成変更など) で保持するかどうかを制御します。 |
ReturnTransition |
フラグメントがバック スタックをポップするために削除、非表示、またはデタッチされる準備をしているときに、シーンからビューを移動するために使用される切り替えを返します。 または、フラグメントがバック スタックをポップするために削除、非表示、またはデタッチされる準備をしているときに、ビューをシーン外に移動するために使用される切り替えを設定します。 |
SharedElementEnterTransition |
コンテンツ シーンに転送される共有要素に使用される遷移を返します。 または、コンテンツ シーンに転送される共有要素に使用される切り替えを設定します。 |
SharedElementReturnTransition |
戻るスタックのポップ中に転送された共有要素に使用される遷移を返します。 または、バック スタックのポップ中に転送された共有要素に使用される遷移を設定します。 |
Tag |
フラグメントのタグ名を取得します (指定されている場合)。 |
TargetFragment |
によって設定されたターゲット フラグメントを |
TargetRequestCode |
によって設定されたターゲット要求コードを |
ThresholdClass |
この API は Mono for Android インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。 |
ThresholdType |
この API は Mono for Android インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。 |
UserVisibleHint |
このフラグメントの UI がユーザーに現在表示されているかどうかについてのヒントをシステムに設定します。 |
View |
フラグメントのレイアウト (によって返されるレイアウト) のルート ビューを取得します (指定されている |
メソッド
Clone() |
このオブジェクトのコピーを作成して返します。 (継承元 Object) |
Dispose() |
フラグメントは、 に配置できるアプリケーションのユーザー インターフェイスまたは動作の一部です |
Dispose(Boolean) |
フラグメントは、 に配置できるアプリケーションのユーザー インターフェイスまたは動作の一部です |
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) |
指定したクラス名を持つ Fragment の新しいインスタンスを作成します。 |
JavaFinalize() |
オブジェクトへの参照がなくなったとガベージ コレクションが判断したときに、オブジェクトのガベージ コレクターによって呼び出されます。 (継承元 Object) |
Notify() |
このオブジェクトのモニターで待機している 1 つのスレッドを起動します。 (継承元 Object) |
NotifyAll() |
このオブジェクトのモニターで待機しているすべてのスレッドを起動します。 (継承元 Object) |
OnActivityCreated(Bundle) |
フラグメントのアクティビティが作成され、このフラグメントのビュー階層がインスタンス化されたときに呼び出されます。 |
OnActivityResult(Int32, Result, Intent) |
の前の呼び出しから結果を |
OnAttach(Activity) |
このメンバーは非推奨とされます。 |
OnAttach(Context) |
フラグメントがそのコンテキストに最初にアタッチされるときに呼び出されます。 |
OnAttachFragment(Fragment) |
フラグメントがこのフラグメントの子としてアタッチされるときに呼び出されます。 |
OnConfigurationChanged(Configuration) |
コンポーネントの実行中にデバイス構成が変更されたときにシステムによって呼び出されます。 |
OnContextItemSelected(IMenuItem) |
このフックは、コンテキスト メニューの項目が選択されるたびに呼び出されます。 |
OnCreate(Bundle) |
フラグメントの初期作成を行うために呼び出されます。 |
OnCreateAnimator(FragmentTransit, Boolean, Int32) |
フラグメントがアニメーションを読み込むときに呼び出されます。 |
OnCreateContextMenu(IContextMenu, View, IContextMenuContextMenuInfo) |
の |
OnCreateOptionsMenu(IMenu, MenuInflater) |
アクティビティの標準オプション メニューの内容を初期化します。 |
OnCreateView(LayoutInflater, ViewGroup, Bundle) |
フラグメントがユーザー インターフェイス ビューをインスタンス化するために呼び出されます。 |
OnDestroy() |
フラグメントが使用されなくなったときに呼び出されます。 |
OnDestroyOptionsMenu() |
このフラグメントのオプション メニュー項目がオプション メニュー全体に含まれなくなったときに呼び出されます。 |
OnDestroyView() |
によって以前に作成 |
OnDetach() |
フラグメントがアクティビティにアタッチされなくなったときに呼び出されます。 |
OnGetLayoutInflater(Bundle) |
このフラグメントのビューをインフレに使用する LayoutInflater を返します。 |
OnHiddenChanged(Boolean) |
(フラグメントの によって |
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) |
が返された直後 |
OnViewStateRestored(Bundle) |
保存されたすべての状態がフラグメントのビュー階層に復元されたときに呼び出されます。 |
PostponeEnterTransition() |
または が呼び出されるまで |
RegisterForContextMenu(View) |
特定のビューに対して表示するコンテキスト メニューを登録します (複数のビューでコンテキスト メニューを表示できます)。 |
RequestPermissions(String[], Int32) |
このアプリケーションに付与するアクセス許可を要求します。 |
SetEnterSharedElementCallback(SharedElementCallback) |
カスタム遷移がフラグメントと共に使用される場合、戻るスタックをポップしないときにこのフラグメントがアタッチまたはデタッチされると、enter 遷移コールバックが呼び出されます。 |
SetExitSharedElementCallback(SharedElementCallback) |
フラグメントでカスタム遷移を使用する場合、スタックをポップするときにこのフラグメントがアタッチまたはデタッチされると、終了遷移コールバックが呼び出されます。 |
SetHandle(IntPtr, JniHandleOwnership) |
Handle プロパティを設定します。 (継承元 Object) |
SetHasOptionsMenu(Boolean) |
このフラグメントは、 および 関連するメソッドの呼び出しを受け取ってオプション メニューの設定に |
SetInitialSavedState(Fragment+SavedState) |
によって返 |
SetMenuVisibility(Boolean) |
このフラグメントのメニューを表示するかどうかを示すヒントを設定します。 |
SetTargetFragment(Fragment, Int32) |
このフラグメントのオプションのターゲット。 |
ShouldShowRequestPermissionRationale(String) |
アクセス許可を要求する前に、根拠のある UI を表示する必要があるかどうかを取得します。 |
StartActivity(Intent) |
フラグメントに含まれる Activity から を呼び出します |
StartActivity(Intent, Bundle) |
フラグメントに含まれる Activity から を呼び出します |
StartActivityForResult(Intent, Int32) |
フラグメントに含まれる Activity から を呼び出します |
StartActivityForResult(Intent, Int32, Bundle) |
フラグメントに含まれる Activity から を呼び出します |
StartIntentSenderForResult(IntentSender, Int32, Intent, ActivityFlags, ActivityFlags, Int32, Bundle) |
フラグメントに含まれる Activity から を呼び出します |
StartPostponedEnterTransition() |
が呼び出された後 |
ToArray<T>() |
フラグメントは、 に配置できるアプリケーションのユーザー インターフェイスまたは動作の一部です |
ToString() |
オブジェクトの文字列形式を返します。 (継承元 Object) |
UnregisterForContextMenu(View) |
指定したビューに対してコンテキスト メニューが表示されないようにします。 |
UnregisterFromRuntime() |
フラグメントは、 に配置できるアプリケーションのユーザー インターフェイスまたは動作の一部です |
Wait() |
現在のスレッドが起動するまで待機します。通常<は、通知</em> または>< em 中断</em によって待機します>。> (継承元 Object) |
Wait(Int64) |
現在のスレッドが起動するまで待機します。通常<は、通知></em> または <>em 中断</em>、または特定のリアルタイムが経過するまで待機します。 (継承元 Object) |
Wait(Int64, Int32) |
現在のスレッドが起動するまで待機します。通常<は、通知></em> または <>em 中断</em>、または特定のリアルタイムが経過するまで待機します。 (継承元 Object) |
明示的なインターフェイスの実装
IJavaPeerable.Disposed() |
フラグメントは、 に配置できるアプリケーションのユーザー インターフェイスまたは動作の一部です |
IJavaPeerable.DisposeUnlessReferenced() |
フラグメントは、 に配置できるアプリケーションのユーザー インターフェイスまたは動作の一部です |
IJavaPeerable.Finalized() |
フラグメントは、 に配置できるアプリケーションのユーザー インターフェイスまたは動作の一部です |
IJavaPeerable.JniManagedPeerState |
フラグメントは、 に配置できるアプリケーションのユーザー インターフェイスまたは動作の一部です |
IJavaPeerable.SetJniIdentityHashCode(Int32) |
フラグメントは、 に配置できるアプリケーションのユーザー インターフェイスまたは動作の一部です |
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
フラグメントは、 に配置できるアプリケーションのユーザー インターフェイスまたは動作の一部です |
IJavaPeerable.SetPeerReference(JniObjectReference) |
フラグメントは、 に配置できるアプリケーションのユーザー インターフェイスまたは動作の一部です |
拡張メソッド
JavaCast<TResult>(IJavaObject) |
Android ランタイムチェック型変換を実行します。 |
JavaCast<TResult>(IJavaObject) |
フラグメントは、 に配置できるアプリケーションのユーザー インターフェイスまたは動作の一部です |
GetJniTypeName(IJavaPeerable) |
フラグメントは、 に配置できるアプリケーションのユーザー インターフェイスまたは動作の一部です |