CardScrollView

Se agregó en el nivel de API XE12.

Un View que muestra vistas secundarias con desplazamiento horizontal se denominan tarjetas.

Las tarjetas provienen del CardScrollAdapter que está asociado con la CardScrollView Cada tarjeta representa visualmente un elemento Object determinado.

Consulta Tarjetas de desplazamiento en actividades para obtener más información

Uso general

  1. Compila un conjunto de tarjetas usando una jerarquía de vistas estándar o la clase CardBuilder.
  2. Implementa un CardScrollAdapter para proporcionar el conjunto de tarjetas al CardScrollView Cada tarjeta tiene un identificador Object único y representa un elemento Object determinado.
  3. Establece la vista de contenido de tu actividad como CardScrollView o usa la CardScrollView en un diseño.

Cómo controlar el desplazamiento y la interacción

CardScrollView te notifica con las siguientes interfaces de objeto de escucha que son heredado de AdapterView:

Categorías anidadas
enum CardScrollView.Animation Define el tipo de animación que se usa para navegar, insertar o borrar una tarjeta.
Constantes heredadas
Campos heredados
Constructores públicos
CardScrollView(contexto Context)
CardScrollView(contexto Context, atributos AttributeSet)
CardScrollView(contexto Context, atributos AttributeSet, int defStyle)
Métodos públicos
void
activate()
boolean
animate(posición de int, CardScrollView.Animation superior)
void
deactivate()
CardScrollAdapter
getAdapter()
long
getSelectedItemId()
int
getSelectedItemPosition()
Ver
getSelectedView()
boolean
isActivated()
boolean
isHorizontalScrollBarEnabled()
boolean
onKeyDown(int keyCode, evento KeyEvent)
void
onWindowFocusChanged(boolean hasWindowFocus)
void
setAdapter(adaptador CardScrollAdapter)
void
setEmptyView(View emptyView)
void
setHorizontalScrollBarEnabled(habilitación booleana)
void
setSelection(posición int)
Métodos protegidos
boolean
awakenScrollBars()
boolean
dispatchGenericFocusedEvent(evento de MotionEvent)
void
initializeScrollbars(TypedArray a)
void
onLayout(valor booleano modificado, int izquierda, int superior, int derecha, int inferior)
void
onVisibilityChanged(View changedView, visibilidad int)
Métodos heredados

Constructores públicos

Se agregó en el nivel de API XE12.

público CardScrollView (contexto Contexto)

Se agregó en el nivel de API XE12.

público CardScrollView (contexto del contexto, AttributeSet del conjunto de atributos)

Se agregó en el nivel de API XE12.

público CardScrollView (Contexto el contexto, AttributeSet attrs, int defStyle)

Métodos públicos

Se agregó en el nivel de API XE12.

público anular activar ()

Le indica al CardScrollView que se active y que esté listo para mostrarse. TODO(ajcbik): Investigue si podemos reemplazar [de]activate con eventos de enfoque.

Se agregó en el nivel de API XE21.

público booleano animar (posición de int, CardScrollView.Animation animaciónType)

Anima la tarjeta en una posición determinada, en la que animationType debe ser una de las siguientes opciones:

  • NAVIGATION: se mueve a una tarjeta determinada desde cualquier posición, la navegación normal
  • INSERTION: se mueve a una tarjeta determinada, que aparece a la vista, después de insertarla,
  • DELETION: La tarjeta desaparecerá de la vista, si la seleccionas, después de borrarla.
La animación se omite si la barra de desplazamiento está desactivada y se borra una animación autónoma anterior. sigue en curso o si la posición no es válida. Una animación de eliminación solo ocurre si el está seleccionada actualmente la tarjeta.

Se debe usar la animación de inserción y eliminación después de realizar la mutación correspondiente en CardScrollAdapter. La animación llamará a notifyDataSetChanged() en el adaptador en el momento adecuado de la animación, incluso cuando se omite o se finaliza antes de tiempo.

Ejemplo de uso: 

 .... insert card at p-th position in adapter ....
 animate(p, INSERTION);    // calls notifyDataSetChanged() on adapter

Parámetros
position de la tarjeta que se incluye en la animación
animationType controla el tipo de animación que se usará
Muestra
  • si se inició la animación
Se agregó en el nivel de API XE12.

público anular desactivar ()

Le indica al CardScrollView que se desactive. no se mostrará hasta después de Se vuelve a llamar a activate().

Se agregó en el nivel de API XE12.

público CardScrollAdapter . getAdapter ()

público largo getSelectedItemId ()

Se agregó en el nivel de API XE12.

público número entero getSelectedItemPosition ()

Se agregó en el nivel de API XE12.

público Ver . getSelectedView ()

Se agregó en el nivel de API XE12.

público booleano isActivated ()

público booleano isHorizontalScrollBarEnabled ()

público booleano onKeyDown (keyCode int, evento KeyEvent)

público anular onWindowFocusChanged (boolean hasWindowFocus)

Se agregó en el nivel de API XE12.

público anular setAdapter (adaptador CardScrollAdapter)

público anular setEmptyView (Ver emptyView)

setEmptyView(View) no es compatible con CardScrollView

Para lograr una animación y un comportamiento ajustables, usa un adaptador con una sola en lugar de una vista vacía para conjuntos de datos vacíos.

público anular setHorizontalScrollBarEnabled (habilitación booleana)

Se agregó en el nivel de API XE12.

público anular setSelection (posición int)

Métodos protegidos

protegido booleano awakenScrollBars ()

Activa la barra de desplazamiento horizontal, si la hay.

Consulta también

protegido booleano dispatchGenericFocusedEvent (evento MotionEvent)

protegido anular initializeScrollbars (TypedArray a)

Se agregó en el nivel de API XE12.

protegido anular onLayout (booleano modificado, int izquierdo, int superior, int derecha, int inferior)

protegido anular onVisibilityChanged (Ver changedView, int visibility)