CardScrollView

Se agregó en el nivel de API XE12.

Un objeto View que muestra vistas secundarias con desplazamiento horizontal, denominados tarjetas.

Las tarjetas provienen de CardScrollAdapter, que está asociada con CardScrollView. Cada tarjeta representa de manera visual un elemento Object específico.

Para obtener más información, consulta Cómo desplazarse las tarjetas en las actividades.

Uso general

  1. Compila un conjunto de tarjetas con una jerarquía de vistas estándar o la clase CardBuilder.
  2. Implementa un CardScrollAdapter para proporcionar el conjunto de tarjetas a CardScrollView. Cada tarjeta tiene un identificador Object único y representa un elemento Object determinado.
  3. Configura la vista de contenido de tu actividad como CardScrollView o usa 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 se heredan 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 de contexto)
CardScrollView(contexto Context, atributos AttributeSet)
CardScrollView(contexto de contexto, atributos AttributeSet, int defStyle)
Métodos públicos
void
Activar()
boolean
animar(int posición, CardScrollView.Animation)
void
desactivar()
CardScrollAdapter;
getAdapter().
long
getSelectedItemId().
int
getSelectedItemPosition()
Ver
getSelectedView()
boolean
está activada().
boolean
isHorizontalScrollBarEnabled()
boolean
onKeyDown(int keyCode, evento KeyEvent)
void
onWindowFocusChanged(boolean hasWindowFocus)
void
setAdapter(adaptador CardScrollAdapter)
void
setEmptyView(View emptyView)
void
setHorizontalScrollBarEnabled(booleano habilitado)
void
setSelection(posición de la posición)
Métodos protegidos
boolean
awakenScrollBars()
boolean
dispatchGenericFocusedEvent(evento MotionEvent)
void
initializeScrollbars(TypedArray a)
void
onLayout(valor booleano modificado, int izquierdo, int top, int right, intbottom)
void
onVisibilityChanged(View changedView, visibilidad de int)
Métodos heredados

Constructores públicos

Se agregó en el nivel de API XE12.

public CardScrollView (contexto de contexto)

Se agregó en el nivel de API XE12.

público CardScrollView (Contexto el contexto AtributoSet Atracciones)

Se agregó en el nivel de API XE12.

public CardScrollView (Contexto el contexto AtributoSet attrs, int defStyle)

Métodos públicos

Se agregó en el nivel de API XE12.

public void activate ()

Le indica a CardScrollView que se active y esté listo para mostrarse. TODO(ajcbik): investiga si podemos reemplazar [de]activar con eventos de enfoque; consulta b/17574566 solicitud.

Se agregó en el nivel de API XE21.

público booleano animar (posición de la posición, CardScrollView.Animation de AnimationType)

Animaciones para tarjetas en una posición determinada, donde animationType debe ser uno de los siguientes:

  • NAVIGATION: Se desplaza a una tarjeta determinada desde cualquier posición, navegación normal,
  • INSERTION: Se desplaza a una tarjeta determinada, que aparece después de la inserción.
  • DELETION: La tarjeta determinada desaparece de la vista, si se selecciona, después de la eliminación.
La animación se omite si el desplazador está desactivado, si una animación autónoma anterior aún está en curso o si la posición no es válida. Una animación de eliminación solo ocurre si la tarjeta borrada está seleccionada.

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

Ejemplo de uso: 

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

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

public void deactivate ()

Indica a CardScrollView que se desactive. No se mostrará hasta que se vuelva a llamar a activate().

Se agregó en el nivel de API XE12.

public CardScrollAdapter getAdapter ()

public long getSelectedItemId ()

Se agregó en el nivel de API XE12.

public intgetSelectedItemPosition()

Se agregó en el nivel de API XE12.

público Ver getSelectedView ()

Se agregó en el nivel de API XE12.

public boolean isActivated()

public boolean isHorizontalScrollBarEnabled ()

public boolean onKeyDown(int keyCode, KeyEvent event)

public void onWindowFocusChanged (boolean hasWindowFocus)

Se agregó en el nivel de API XE12.

public void setAdapter (CardScrollAdapter)

public void setEmptyView (View emptyView)

setEmptyView(View) no es compatible con el CardScrollView.

A fin de obtener una animación adecuada y un comportamiento configurable, usa un adaptador con una sola vista vacía para conjuntos de datos vacíos.

public void setHorizontalScrollBarEnabled (valor booleano)

Se agregó en el nivel de API XE12.

public void setSelection (int position)

Métodos protegidos

protegido boolean awakenScrollBars ()

Activa la barra de desplazamiento horizontal, si la hubiera.

Consulta también

protegido boolean dispatchGenericFocusedEvent (evento de MotionEvent)

protegido void initializeScrollbars (TypedArray a)

Se agregó en el nivel de API XE12.

protegido void onLayout (booleano modificado, int izquierdo, int top, int right, intbottom)

protegido void onVisibilityChanged (View changedView, intvisibility)