Fragment Clase

Referencia

Definición

Espacio de nombres:: Android.App

Ensamblado:: Mono.Android.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Un fragmento es una parte de la interfaz de usuario o el comportamiento de una aplicación que se puede colocar en .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

Herencia: Object

Object
Fragment

Derivado: Android.App.DialogFragment

Android.App.ListFragment

Android.Preferences.PreferenceFragment

Android.Webkit.WebViewFragment

Atributos: RegisterAttribute

Implementaciones: IComponentCallbacks IComponentCallbacks2 IJavaObject View.IOnCreateContextMenuListener IJavaPeerable IDisposable

Comentarios

Un fragmento es una parte de la interfaz de usuario o el comportamiento de una aplicación que se puede colocar en .Activity La interacción con fragmentos se realiza a través FragmentManagerde , que se puede obtener a través Activity#getFragmentManager() Activity.getFragmentManager() de y Fragment#getFragmentManager() Fragment.getFragmentManager().

La clase Fragment se puede usar de muchas maneras para lograr una amplia variedad de resultados. En su núcleo, representa una operación o interfaz determinada que se ejecuta dentro de un valor mayor Activity. Un fragmento está estrechamente vinculado a la actividad en la que se encuentra y no se puede usar aparte de uno. Aunque Fragment define su propio ciclo de vida, ese ciclo de vida depende de su actividad: si la actividad se detiene, no se pueden iniciar fragmentos dentro de él; cuando se destruye la actividad, se destruirán todos los fragmentos.

Todas las subclases de Fragment deben incluir un constructor público sin argumentos. A menudo, el marco volverá a crear una instancia de una clase de fragmento cuando sea necesario, en particular durante la restauración de estado, y debe poder encontrar este constructor para crear una instancia de ella. Si el constructor no-argument no está disponible, se producirá una excepción en tiempo de ejecución en algunos casos durante la restauración del estado.

Temas que se tratan aquí: <ol<>li>Older Platforms<li>Lifecycle<li>Layout<li>Back Stack</ol>

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

Para obtener más información sobre el uso de fragmentos, lea la guía para desarrolladores fragmentos .

</Div>

"OlderPlatforms"><h3>Plataformas< anteriores/h3>

Aunque la API fragment se introdujo en android.os.Build.VERSION_CODES#HONEYCOMB, también hay disponible una versión de la API en para su uso en plataformas anteriores mediante androidx.fragment.app.FragmentActivity. Consulte la entrada de blog Fragmentos para todos para obtener más detalles.

"Ciclo de vida"><h3>Lifecycle</h3>

Aunque el ciclo de vida de un fragmento está vinculado a su propia actividad, tiene su propia arruga en el ciclo de vida de la actividad estándar. Incluye métodos básicos del ciclo de vida de la actividad, como #onResume, pero también importantes son métodos relacionados con las interacciones con la actividad y la generación de la interfaz de usuario.

La serie principal de métodos de ciclo de vida a los que se llama para poner un fragmento en estado reanudado (interactuar con el usuario) son:

<ol><li>#onAttach llamó una vez que el fragmento está asociado a su actividad. <li>#onCreate llamó para realizar la creación inicial del fragmento. <li>#onCreateView crea y devuelve la jerarquía de vistas asociada al fragmento. <li>#onActivityCreated indica al fragmento que su actividad ha completado su propia Activity#onCreate Activity.onCreate()actividad. <li>#onViewStateRestored indica al fragmento que se ha restaurado todo el estado guardado de su jerarquía de vistas. <li>#onStart hace que el fragmento sea visible para el usuario (en función de su actividad contenedora que se está iniciando). <li>#onResume hace que el fragmento comience a interactuar con el usuario (en función de su actividad contenedora que se reanuda). </Ol>

Como ya no se usa un fragmento, pasa por una serie inversa de devoluciones de llamada:

<Ol><li>#onPause fragment ya no interactúa con el usuario porque su actividad se está pausando o una operación de fragmento la está modificando en la actividad. <el fragmento li>#onStop ya no es visible para el usuario porque su actividad se detiene o una operación de fragmento la está modificando en la actividad. <li>#onDestroyView permite que el fragmento limpie los recursos asociados a su vista. <li>#onDestroy llamó para realizar la limpieza final del estado del fragmento. <li>#onDetach llamó inmediatamente antes de que el fragmento ya no esté asociado a su actividad. </Ol>

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

Los fragmentos se pueden usar como parte del diseño de la aplicación, lo que le permite modular mejor el código y ajustar más fácilmente la interfaz de usuario a la pantalla en la que se ejecuta. Por ejemplo, podemos ver un programa simple que consta de una lista de elementos y mostrar los detalles de cada elemento.

El XML de diseño de una actividad puede incluir <fragment> etiquetas para insertar instancias de fragmentos dentro del diseño. Por ejemplo, este es un diseño sencillo que inserta un fragmento:

{

Este miembro está en desuso. Use la biblioteca androidx.fragment.app.Fragment de fragmentos de Jetpack para un comportamiento coherente en todos los dispositivos y el acceso al ciclo de vida.

Documentación de Java para android.app.Fragment.

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código y se usan según los términos descritos en la creative Commons 2.5.

Constructores

Fragment()	Constructor predeterminado.
Fragment(IntPtr, JniHandleOwnership)	Constructor utilizado al crear representaciones administradas de objetos JNI; llamado por el entorno de ejecución.

Propiedades

Activity	Devuelve la actividad a la que está asociado actualmente este fragmento.
AllowEnterTransitionOverlap	Devuelve si la transición de salida y la transición de entrada se superponen o no. -o bien- Establece si la transición de salida y entrar en la transición se superponen o no.
AllowReturnTransitionOverlap	Devuelve si la transición de retorno y la transición de reentrenamiento se superponen o no. -o bien- Establece si la transición de retorno y la transición de reentrenamiento se superponen o no.
Arguments	Devuelve los argumentos proporcionados a `#setArguments`, si los hay. -o bien- Proporcione los argumentos de construcción para este fragmento.
ChildFragmentManager	Devuelve un FragmentManager privado para colocar y administrar fragmentos dentro de este fragmento.
Class	Devuelve la clase en tiempo de ejecución de este `Object`objeto . (Heredado de Object)
Context	Devolver el `Context` fragmento está asociado actualmente.
EnterTransition	Devuelve la transición que se usará para mover vistas a la escena inicial. -o bien- Establece la transición que se usará para mover vistas a la escena inicial.
ExitTransition	Devuelve la transición que se usará para mover las vistas fuera de la escena cuando se quita, oculta o desasocia el fragmento cuando no se extrae la pila trasera. -o bien- Establece la transición que se usará para mover las vistas fuera de la escena cuando se quita, oculta o desasocia el fragmento cuando no se extrae la pila posterior.
FragmentManager	Devuelve el FragmentManager para interactuar con fragmentos asociados a la actividad de este fragmento.
Handle	Identificador de la instancia de Android subyacente. (Heredado de Object)
Host	Devuelve el objeto host de este fragmento.
Id	Devuelve el identificador por el que conoce este fragmento.
IsAdded	Devuelve true si el fragmento se agrega actualmente a su actividad.
IsDetached	Devuelve true si el fragmento se ha desasociado explícitamente de la interfaz de usuario.
IsHidden	Devuelve true si el fragmento se ha ocultado.
IsInLayout	Devuelve true si el diseño se incluye como parte de una jerarquía de vistas de actividad a través de la < fragment> etiqueta.
IsRemoving	Devuelve true si este fragmento se está quitando actualmente de su actividad.
IsResumed	Devuelve true si el fragmento está en estado reanudado.
IsStateSaved	Devuelve true si se agrega este fragmento y su estado ya se ha guardado por su host.
IsVisible	Devuelve true si el fragmento está visible actualmente para el usuario.
JniIdentityHashCode	Un fragmento es una parte de la interfaz de usuario o el comportamiento de una aplicación que se puede colocar en .`Activity` (Heredado de Object)
JniPeerMembers	Un fragmento es una parte de la interfaz de usuario o el comportamiento de una aplicación que se puede colocar en .`Activity`
LayoutInflater	Devuelve el layoutInflater almacenado en caché que se usa para inflar las vistas de este fragmento.
LoaderManager	Devuelve loaderManager para este fragmento y lo crea si es necesario.
ParentFragment	Devuelve el fragmento primario que contiene este fragmento.
PeerReference	Un fragmento es una parte de la interfaz de usuario o el comportamiento de una aplicación que se puede colocar en .`Activity` (Heredado de Object)
ReenterTransition	Devuelve la transición que se usará para mover vistas a la escena cuando se devuelva debido a que se extrae una pila posterior. -o bien- Establece la transición que se usará para mover las vistas a la escena cuando se devuelva debido a que se extrae una pila trasera.
Resources	Devuelva `getActivity().getResources()`.
RetainInstance	Controlar si una instancia de fragmento se conserva en la nueva creación de actividad (por ejemplo, a partir de un cambio de configuración).
ReturnTransition	Devuelve la transición que se usará para mover las vistas fuera de la escena cuando el fragmento se prepara para quitarse, ocultarse o desasociar debido a la retirada de la pila. -o bien- Establece la transición que se usará para mover las vistas fuera de la escena cuando el fragmento se prepara para quitarse, ocultarse o desasociar debido a la retirada de la pila.
SharedElementEnterTransition	Devuelve la transición que se usará para los elementos compartidos transferidos a la escena de contenido. -o bien- Establece la transición que se usará para los elementos compartidos transferidos a la escena de contenido.
SharedElementReturnTransition	Devuelve la transición que se usará para los elementos compartidos transferidos durante un elemento emergente de la pila posterior. -o bien- Establece la transición que se usará para los elementos compartidos transferidos durante un elemento emergente de la pila posterior.
Tag	Obtiene el nombre de etiqueta del fragmento, si se especifica.
TargetFragment	Devuelve el fragmento de destino establecido por `#setTargetFragment`.
TargetRequestCode	Devuelve el código de solicitud de destino establecido por `#setTargetFragment`.
ThresholdClass	Esta API admite la infraestructura mono para Android y no está pensada para usarse directamente desde el código.
ThresholdType	Esta API admite la infraestructura mono para Android y no está pensada para usarse directamente desde el código.
UserVisibleHint	Establezca una sugerencia en el sistema sobre si la interfaz de usuario de este fragmento está visible actualmente para el usuario.
View	Obtenga la vista raíz para el diseño del fragmento (el devuelto por `#onCreateView`), si se proporciona.

Métodos

Clone()	Crea y devuelve una copia de este objeto. (Heredado de Object)
Dispose()	Un fragmento es una parte de la interfaz de usuario o el comportamiento de una aplicación que se puede colocar en .`Activity` (Heredado de Object)
Dispose(Boolean)	Un fragmento es una parte de la interfaz de usuario o el comportamiento de una aplicación que se puede colocar en .`Activity` (Heredado de Object)
Dump(String, FileDescriptor, PrintWriter, String[])	Imprima el estado de los fragmentos en la secuencia especificada.
Equals(Object)	Obsoletos. Las subclases no pueden invalidar equals().
GetHashCode()	Obsoletos. Las subclases no pueden invalidar hashCode().
GetString(Int32)	Devuelve una cadena localizada de la tabla de cadenas predeterminadas del paquete de la aplicación.
GetString(Int32, Object[])	Devuelve una cadena localizada de la tabla de cadenas predeterminadas del paquete de la aplicación.
GetText(Int32)	Devuelve un charSequence localizado y con estilo de la tabla de cadenas predeterminadas del paquete de la aplicación.
GetTextFormatted(Int32)	Devuelve un charSequence localizado y con estilo de la tabla de cadenas predeterminadas del paquete de la aplicación.
Instantiate(Context, String)	Al igual `#instantiate(Context, String, Bundle)` que con un argumento NULL Bundle.
Instantiate(Context, String, Bundle)	Cree una nueva instancia de un fragmento con el nombre de clase especificado.
JavaFinalize()	Llamado por el recolector de elementos no utilizados en un objeto cuando la recolección de elementos no utilizados determina que no hay más referencias al objeto. (Heredado de Object)
Notify()	Activa un único subproceso que está esperando en el monitor de este objeto. (Heredado de Object)
NotifyAll()	Activa todos los subprocesos que están esperando en el monitor de este objeto. (Heredado de Object)
OnActivityCreated(Bundle)	Se llama cuando se ha creado la actividad del fragmento y se ha creado la jerarquía de vistas de este fragmento.
OnActivityResult(Int32, Result, Intent)	Reciba el resultado de una llamada anterior a `#startActivityForResult(Intent, int)`.
OnAttach(Activity)	Este miembro está en desuso.
OnAttach(Context)	Se llama cuando un fragmento se adjunta por primera vez a su contexto.
OnAttachFragment(Fragment)	Se llama cuando se adjunta un fragmento como elemento secundario de este fragmento.
OnConfigurationChanged(Configuration)	Lo llama el sistema cuando cambia la configuración del dispositivo mientras se ejecuta el componente.
OnContextItemSelected(IMenuItem)	Se llama a este enlace cada vez que se selecciona un elemento de un menú contextual.
OnCreate(Bundle)	Se llama para realizar la creación inicial de un fragmento.
OnCreateAnimator(FragmentTransit, Boolean, Int32)	Se llama cuando un fragmento carga una animación.
OnCreateContextMenu(IContextMenu, View, IContextMenuContextMenuInfo)	Se llama cuando se va a mostrar un menú contextual para .`view`
OnCreateOptionsMenu(IMenu, MenuInflater)	Inicialice el contenido del menú de opciones estándar de la actividad.
OnCreateView(LayoutInflater, ViewGroup, Bundle)	Se llama para que el fragmento cree una instancia de su vista de interfaz de usuario.
OnDestroy()	Se llama cuando el fragmento ya no está en uso.
OnDestroyOptionsMenu()	Se llama cuando los elementos de menú de opciones de este fragmento ya no se incluyen en el menú de opciones generales.
OnDestroyView()	Se llama cuando la vista creada por `#onCreateView` se ha desasociado del fragmento.
OnDetach()	Se llama cuando el fragmento ya no está asociado a su actividad.
OnGetLayoutInflater(Bundle)	Devuelve el layoutInflater usado para inflar las vistas de este fragmento.
OnHiddenChanged(Boolean)	Se llama cuando el estado oculto (tal y como lo devuelve `#isHidden()` el fragmento ha cambiado).
OnInflate(Activity, IAttributeSet, Bundle)	Este miembro está en desuso.
OnInflate(Context, IAttributeSet, Bundle)	Se llama cuando se crea un fragmento como parte de una inflación de diseño de vista, normalmente desde la configuración de la vista de contenido de una actividad.
OnInflate(IAttributeSet, Bundle)	Obsoletos. Este miembro está en desuso.
OnLowMemory()	Esto se llama cuando el sistema general se está ejecutando poco en memoria y los procesos que se ejecutan activamente deben recortar su uso de memoria.
OnMultiWindowModeChanged(Boolean)	Se llama cuando la actividad del fragmento cambia del modo de pantalla completa al modo de varias ventanas y visa-versa.
OnMultiWindowModeChanged(Boolean, Configuration)	Se llama cuando la actividad del fragmento cambia del modo de pantalla completa al modo de varias ventanas y visa-versa.
OnOptionsItemSelected(IMenuItem)	Se llama a este enlace cada vez que se selecciona un elemento en el menú de opciones.
OnOptionsMenuClosed(IMenu)	Se llama a este enlace cada vez que se cierra el menú de opciones (ya sea por el usuario que cancela el menú con el botón Atrás/menú, o cuando se selecciona un elemento).
OnPause()	Se llama cuando el fragmento ya no se reanuda.
OnPictureInPictureModeChanged(Boolean)	Lo llama el sistema cuando la actividad cambia a y desde el modo de imagen en imagen.
OnPictureInPictureModeChanged(Boolean, Configuration)	Lo llama el sistema cuando la actividad cambia a y desde el modo de imagen en imagen.
OnPrepareOptionsMenu(IMenu)	Prepare el menú de opciones estándar de la pantalla que se va a mostrar.
OnRequestPermissionsResult(Int32, String[], Permission[])	Devolución de llamada para el resultado de solicitar permisos.
OnResume()	Se llama cuando el fragmento es visible para el usuario y se ejecuta activamente.
OnSaveInstanceState(Bundle)	Se llama para pedir al fragmento que guarde su estado dinámico actual, por lo que posteriormente se puede reconstruir en una nueva instancia de su proceso se reinicia.
OnStart()	Se llama cuando el fragmento es visible para el usuario.
OnStop()	Se llama cuando el fragmento ya no se inicia.
OnTrimMemory(TrimMemory)	Se llama cuando el sistema operativo ha determinado que es un buen momento para que un proceso recorte la memoria innecesaria de su proceso.
OnViewCreated(View, Bundle)	Se llama inmediatamente después `#onCreateView(LayoutInflater, ViewGroup, Bundle)` de que se haya devuelto, pero antes de restaurar cualquier estado guardado en la vista.
OnViewStateRestored(Bundle)	Se llama cuando se ha restaurado todo el estado guardado en la jerarquía de vistas del fragmento.
PostponeEnterTransition()	Posponer la transición de fragmento de entrada hasta `#startPostponedEnterTransition()` que se haya llamado a o `FragmentManager#executePendingTransactions()` .
RegisterForContextMenu(View)	Registra un menú contextual que se va a mostrar para la vista determinada (varias vistas pueden mostrar el menú contextual).
RequestPermissions(String[], Int32)	Solicita permisos para conceder a esta aplicación.
SetEnterSharedElementCallback(SharedElementCallback)	Cuando se usan transiciones personalizadas con fragmentos, se llama a la devolución de llamada enter transition cuando este fragmento se adjunta o desasocia cuando no se extrae la pila de retroceso.
SetExitSharedElementCallback(SharedElementCallback)	Cuando se usan transiciones personalizadas con fragmentos, se llama a la devolución de llamada de transición de salida cuando este fragmento se adjunta o desasocia al extraer la pila de reserva.
SetHandle(IntPtr, JniHandleOwnership)	Establece la propiedad Handle. (Heredado de Object)
SetHasOptionsMenu(Boolean)	Informe de que este fragmento desea participar en rellenar el menú de opciones mediante la recepción de una llamada a `#onCreateOptionsMenu` y métodos relacionados.
SetInitialSavedState(Fragment+SavedState)	Establezca el estado guardado inicial que este fragmento debe restaurarse a partir de la primera vez que se construye, tal y como devuelve `FragmentManager#saveFragmentInstanceState(Fragment) FragmentManager.saveFragmentInstanceState`.
SetMenuVisibility(Boolean)	Establezca una sugerencia para saber si el menú de este fragmento debe estar visible.
SetTargetFragment(Fragment, Int32)	Destino opcional para este fragmento.
ShouldShowRequestPermissionRationale(String)	Obtiene si debe mostrar la interfaz de usuario con justificación antes de solicitar un permiso.
StartActivity(Intent)	Llame `Activity#startActivity(Intent)` a desde la actividad contenedora del fragmento.
StartActivity(Intent, Bundle)	Llame `Activity#startActivity(Intent, Bundle)` a desde la actividad contenedora del fragmento.
StartActivityForResult(Intent, Int32)	Llame `Activity#startActivityForResult(Intent, int)` a desde la actividad contenedora del fragmento.
StartActivityForResult(Intent, Int32, Bundle)	Llame `Activity#startActivityForResult(Intent, int, Bundle)` a desde la actividad contenedora del fragmento.
StartIntentSenderForResult(IntentSender, Int32, Intent, ActivityFlags, ActivityFlags, Int32, Bundle)	Llame `Activity#startIntentSenderForResult(IntentSender, int, Intent, int, int, int, Bundle)` a desde la actividad contenedora del fragmento.
StartPostponedEnterTransition()	Comience las transiciones pospuestas después `#postponeEnterTransition()` de llamar a .
ToArray<T>()	Un fragmento es una parte de la interfaz de usuario o el comportamiento de una aplicación que se puede colocar en .`Activity` (Heredado de Object)
ToString()	Devuelve una representación de cadena del objeto. (Heredado de Object)
UnregisterForContextMenu(View)	Impide que se muestre un menú contextual para la vista especificada.
UnregisterFromRuntime()	Un fragmento es una parte de la interfaz de usuario o el comportamiento de una aplicación que se puede colocar en .`Activity` (Heredado de Object)
Wait()	Hace que el subproceso actual espere hasta que se despierte, normalmente por ser em notificado/em> o <em>interrumpido</em>.<>< (Heredado de Object)
Wait(Int64)	Hace que el subproceso actual espere hasta que se despierte, normalmente por ser <notificado<>/em> o <em>interrumpido</em>, o hasta que haya transcurrido una cierta cantidad de tiempo real. (Heredado de Object)
Wait(Int64, Int32)	Hace que el subproceso actual espere hasta que se despierte, normalmente por ser <notificado<>/em> o <em>interrumpido</em>, o hasta que haya transcurrido una cierta cantidad de tiempo real. (Heredado de Object)

Implementaciones de interfaz explícitas

IJavaPeerable.Disposed()	Un fragmento es una parte de la interfaz de usuario o el comportamiento de una aplicación que se puede colocar en .`Activity` (Heredado de Object)
IJavaPeerable.DisposeUnlessReferenced()	Un fragmento es una parte de la interfaz de usuario o el comportamiento de una aplicación que se puede colocar en .`Activity` (Heredado de Object)
IJavaPeerable.Finalized()	Un fragmento es una parte de la interfaz de usuario o el comportamiento de una aplicación que se puede colocar en .`Activity` (Heredado de Object)
IJavaPeerable.JniManagedPeerState	Un fragmento es una parte de la interfaz de usuario o el comportamiento de una aplicación que se puede colocar en .`Activity` (Heredado de Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Un fragmento es una parte de la interfaz de usuario o el comportamiento de una aplicación que se puede colocar en .`Activity` (Heredado de Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Un fragmento es una parte de la interfaz de usuario o el comportamiento de una aplicación que se puede colocar en .`Activity` (Heredado de Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	Un fragmento es una parte de la interfaz de usuario o el comportamiento de una aplicación que se puede colocar en .`Activity` (Heredado de Object)

Métodos de extensión

JavaCast<TResult>(IJavaObject)	Realiza una conversión de tipos comprobados en tiempo de ejecución de Android.
JavaCast<TResult>(IJavaObject)	Un fragmento es una parte de la interfaz de usuario o el comportamiento de una aplicación que se puede colocar en .`Activity`
GetJniTypeName(IJavaPeerable)	Un fragmento es una parte de la interfaz de usuario o el comportamiento de una aplicación que se puede colocar en .`Activity`

Se aplica a