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
내에서 실행되는 특정 작업 또는 인터페이스를 나타냅니다. 조각은 현재 있는 활동에 밀접하게 연결되어 있으며, 조각과 별도로 사용할 수 없습니다. Fragment는 자체 수명 주기를 정의하지만 해당 수명 주기는 해당 활동에 따라 달라집니다. 작업이 중지되면 그 안에 있는 조각을 시작할 수 없습니다. 활동이 제거되면 모든 조각이 제거됩니다.
조각의 모든 하위 클래스에는 공용 인수 없음 생성자가 포함되어야 합니다. 프레임워크는 필요할 때, 특히 상태 복원 중에 조각 클래스를 다시 인스턴스화하며, 이를 인스턴스화하기 위해 이 생성자를 찾을 수 있어야 합니다. 인수 없는 생성자를 사용할 수 없는 경우 상태 복원 중에 런타임 예외가 발생합니다.
여기에서 다루는 항목: <ol><li>Old Platforms<li>Lifecycle<li>Layout<li>Back Stack</ol>
<div class="special reference"><h3>Developer Guides</h3>
조각 사용에 대한 자세한 내용은 조각 개발자 가이드 를 참조하세요.
</Div>
"OldPlatforms"><h3>이전 플랫폼</h3>
조각 API가 에 android.os.Build.VERSION_CODES#HONEYCOMB
도입되었지만 의 API 버전은 를 통해 androidx.fragment.app.FragmentActivity
이전 플랫폼에서도 사용할 수 있습니다. 자세한 내용은 블로그 게시물 조각 모두를 참조하세요.
"수명 주기"><h3>수명 주기</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
조각은 작업이 일시 중지되거나 조각 작업이 작업에서 수정 중이므로 사용자와 더 이상 상호 작용하지 않습니다. <li>#onStop
조각은 작업이 중지되거나 조각 작업이 작업에서 수정 중이므로 사용자에게 더 이상 표시되지 않습니다. <li>#onDestroyView
를 사용하면 조각이 뷰와 연결된 리소스를 클린 수 있습니다. <li>#onDestroy
는 조각의 상태를 최종 정리하기 위해 호출되었습니다. <li>#onDetach
는 조각이 더 이상 해당 활동과 연결되지 않는 즉시 호출됩니다. </Ol>
"레이아웃"><h3>레이아웃</h3>
조각을 애플리케이션 레이아웃의 일부로 사용할 수 있으므로 코드를 모듈화하고 실행 중인 화면으로 사용자 인터페이스를 보다 쉽게 조정할 수 있습니다. 예를 들어 항목 목록으로 구성된 간단한 프로그램과 각 항목의 세부 정보를 표시할 수 있습니다.
활동의 레이아웃 XML에는 레이아웃 내부에 조각 인스턴스를 포함하는 태그가 포함될 <fragment>
수 있습니다. 예를 들어 다음은 하나의 조각을 포함하는 간단한 레이아웃입니다.
{
이 멤버는 더 이상 사용되지 않습니다. 모든 디바이스에서 일관된 동작을 수행하고 수명 주기에 액세스하려면 Jetpack 조각 라이브러리androidx.fragment.app.Fragment
를 사용합니다.
에 대한 Java 설명서입니다 android.app.Fragment
.
이 페이지의 일부는 만들고 공유하며 에 설명된 조건에 따라 사용되는 작업을 기반으로 수정됩니다.
생성자
Fragment() |
기본 생성자입니다. |
Fragment(IntPtr, JniHandleOwnership) |
JNI 개체의 관리되는 표현을 만들 때 사용되는 생성자입니다. 런타임에서 호출합니다. |
속성
Activity |
이 조각이 현재 연결된 활동을 반환합니다. |
AllowEnterTransitionOverlap |
종료 전환과 전환 입력이 겹치는지 여부를 반환합니다. -또는- 종료 전환 및 전환 입력이 겹치는지 여부를 설정합니다. |
AllowReturnTransitionOverlap |
반환 전환과 재진입 전환이 겹치는지 여부를 반환합니다. -또는- 반환 전환 및 재진입 전환이 겹치는지 여부를 설정합니다. |
Arguments |
에 제공된 인수(있는 경우)를 |
ChildFragmentManager |
이 조각 내부에 조각을 배치하고 관리하기 위한 프라이빗 FragmentManager를 반환합니다. |
Class |
이 |
Context |
|
EnterTransition |
뷰를 초기 장면으로 이동하는 데 사용할 Transition를 반환합니다. -또는- 뷰를 초기 장면으로 이동하는 데 사용할 전환을 설정합니다. |
ExitTransition |
조각이 제거되거나 숨겨지거나 후면 스택이 표시되지 않을 때 뷰를 장면 밖으로 이동하는 데 사용할 Transition를 반환합니다. -또는- 조각이 제거되거나 숨겨지거나 후면 스택이 표시되지 않을 때 뷰를 장면 밖으로 이동하는 데 사용할 전환을 설정합니다. |
FragmentManager |
이 조각의 활동과 연결된 조각과 상호 작용하기 위한 FragmentManager를 반환합니다. |
Handle |
기본 Android instance 대한 핸들입니다. (다음에서 상속됨 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 |
뒤로 스택이 터져 반환될 때 뷰를 장면으로 이동하는 데 사용할 Transition를 반환합니다. -또는- 뒤로 스택이 터져 반환될 때 뷰를 장면으로 이동하는 데 사용할 전환을 설정합니다. |
Resources |
|
RetainInstance |
작업 다시 만들기(예: 구성 변경)에서 조각 instance 보존되는지 여부를 제어합니다. |
ReturnTransition |
조각이 백 스택을 터뜨리기 때문에 제거, 숨기거나 분리할 준비를 할 때 장면에서 보기를 이동하는 데 사용할 전환을 반환합니다. -또는- 조각이 백 스택을 터뜨리기 때문에 제거, 숨기거나 분리할 준비를 할 때 장면에서 보기를 이동하는 데 사용할 전환을 설정합니다. |
SharedElementEnterTransition |
콘텐츠 장면으로 전송되는 공유 요소에 사용할 Transition를 반환합니다. -또는- 콘텐츠 장면으로 전송되는 공유 요소에 사용할 전환을 설정합니다. |
SharedElementReturnTransition |
뒤로 스택의 팝 중에 다시 전송되는 공유 요소에 사용할 Transition를 반환합니다. -또는- 뒤로 스택의 팝 중에 다시 전송되는 공유 요소에 사용할 전환을 설정합니다. |
Tag |
지정된 경우 조각의 태그 이름을 가져옵니다. |
TargetFragment |
로 설정된 대상 조각을 반환합니다 |
TargetRequestCode |
로 설정된 |
ThresholdClass |
이 API는 Android용 Mono 인프라를 지원하며 코드에서 직접 사용할 수 없습니다. |
ThresholdType |
이 API는 Android용 Mono 인프라를 지원하며 코드에서 직접 사용할 수 없습니다. |
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) |
null 인수 번들을 사용하는 경우와 같습니다 |
Instantiate(Context, String, Bundle) |
지정된 클래스 이름을 사용하여 조각의 새 instance 만듭니다. |
JavaFinalize() |
가비지 수집에서 개체에 대한 참조가 더 이상 없다고 판단할 때 개체의 가비지 수집기에서 호출됩니다. (다음에서 상속됨 Object) |
Notify() |
이 개체의 모니터에서 대기 중인 단일 스레드를 해제합니다. (다음에서 상속됨 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) |
조각의 활동이 전체 화면 모드에서 다중 창 모드로 변경되고 visa-versa로 변경되면 호출됩니다. |
OnMultiWindowModeChanged(Boolean, Configuration) |
조각의 활동이 전체 화면 모드에서 다중 창 모드로 변경되고 visa-versa로 변경되면 호출됩니다. |
OnOptionsItemSelected(IMenuItem) |
이 후크는 옵션 메뉴의 항목이 선택될 때마다 호출됩니다. |
OnOptionsMenuClosed(IMenu) |
이 후크는 옵션 메뉴가 닫혀 있을 때마다 호출됩니다(사용자가 뒤로/메뉴 단추로 메뉴를 취소하거나 항목을 선택할 때). |
OnPause() |
조각이 더 이상 다시 시작되지 않을 때 호출됩니다. |
OnPictureInPictureModeChanged(Boolean) |
활동이 그림 모드로 변경되고 그림 모드에서 변경되면 시스템에서 호출됩니다. |
OnPictureInPictureModeChanged(Boolean, Configuration) |
활동이 그림 모드로 변경되고 그림 모드에서 변경되면 시스템에서 호출됩니다. |
OnPrepareOptionsMenu(IMenu) |
표시할 화면의 표준 옵션 메뉴를 준비합니다. |
OnRequestPermissionsResult(Int32, String[], Permission[]) |
사용 권한을 요청하여 발생한 결과에 대한 콜백입니다. |
OnResume() |
조각이 사용자에게 표시되고 적극적으로 실행 중일 때 호출됩니다. |
OnSaveInstanceState(Bundle) |
조각에 현재 동적 상태를 저장하도록 요청하기 위해 호출되므로 나중에 프로세스의 새 instance 다시 구성할 수 있습니다. |
OnStart() |
조각이 사용자에게 표시되면 호출됩니다. |
OnStop() |
조각이 더 이상 시작되지 않을 때 호출됩니다. |
OnTrimMemory(TrimMemory) |
운영 체제가 프로세스에서 불필요한 메모리를 자르는 것이 좋은 시기라고 판단했을 때 호출됩니다. |
OnViewCreated(View, Bundle) |
가 반환된 직후 |
OnViewStateRestored(Bundle) |
저장된 모든 상태가 조각의 뷰 계층 구조로 복원될 때 호출됩니다. |
PostponeEnterTransition() |
또는 |
RegisterForContextMenu(View) |
지정된 보기에 대해 표시할 상황에 맞는 메뉴를 등록합니다(여러 보기가 상황에 맞는 메뉴를 표시할 수 있습니다). |
RequestPermissions(String[], Int32) |
이 애플리케이션에 부여할 권한을 요청합니다. |
SetEnterSharedElementCallback(SharedElementCallback) |
조각과 함께 사용자 지정 전환을 사용하는 경우 이 조각이 연결되거나 분리된 경우 백 스택이 터지지 않을 때 전환 콜백 입력이 호출됩니다. |
SetExitSharedElementCallback(SharedElementCallback) |
사용자 지정 전환이 조각과 함께 사용되는 경우 이 조각이 연결되거나 분리되면 백 스택이 터지는 경우 종료 전환 콜백이 호출됩니다. |
SetHandle(IntPtr, JniHandleOwnership) |
Handle 속성을 설정합니다. (다음에서 상속됨 Object) |
SetHasOptionsMenu(Boolean) |
이 조각이 및 관련 메서드에 대한 호출을 수신하여 옵션 메뉴 채우기에 참여하려고 한다는 것을 |
SetInitialSavedState(Fragment+SavedState) |
에서 반환 |
SetMenuVisibility(Boolean) |
이 조각의 메뉴를 표시할지 여부에 대한 힌트를 설정합니다. |
SetTargetFragment(Fragment, Int32) |
이 조각의 선택적 대상입니다. |
ShouldShowRequestPermissionRationale(String) |
사용 권한을 요청하기 전에 근거를 사용하여 UI를 표시해야 하는지 여부를 가져옵니다. |
StartActivity(Intent) |
조각의 포함된 작업에서 를 호출 |
StartActivity(Intent, Bundle) |
조각의 포함된 작업에서 를 호출 |
StartActivityForResult(Intent, Int32) |
조각의 포함된 작업에서 를 호출 |
StartActivityForResult(Intent, Int32, Bundle) |
조각의 포함된 작업에서 를 호출 |
StartIntentSenderForResult(IntentSender, Int32, Intent, ActivityFlags, ActivityFlags, Int32, Bundle) |
조각의 포함된 작업에서 를 호출 |
StartPostponedEnterTransition() |
가 호출된 후 |
ToArray<T>() |
조각은 에 배치할 수 있는 애플리케이션의 사용자 인터페이스 또는 동작의 조각입니다 |
ToString() |
개체의 문자열 표현을 반환합니다. (다음에서 상속됨 Object) |
UnregisterForContextMenu(View) |
지정된 보기에 대한 상황에 맞는 메뉴가 표시되지 않도록 합니다. |
UnregisterFromRuntime() |
조각은 에 배치할 수 있는 애플리케이션의 사용자 인터페이스 또는 동작의 조각입니다 |
Wait() |
현재 스레드가 깨어날 때까지 대기하게 합니다( 일반적으로 <알림을 받><거나 <>중단/>em>)합니다<. (다음에서 상속됨 Object) |
Wait(Int64) |
현재 스레드가 깨어날 때까지 대기하게 합니다. 일반적으로 <>알림을 받<거나 <중단</>내보내>>거나 일정량의 실시간이 경과할 때까지 대기합니다. (다음에서 상속됨 Object) |
Wait(Int64, Int32) |
현재 스레드가 깨어날 때까지 대기하게 합니다. 일반적으로 <>알림을 받<거나 <중단</>내보내>>거나 일정량의 실시간이 경과할 때까지 대기합니다. (다음에서 상속됨 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) |
조각은 에 배치할 수 있는 애플리케이션의 사용자 인터페이스 또는 동작의 조각입니다 |