Scorrimento schede

Aggiunto nel livello API XE12

Un View che mostra visualizzazioni a scorrimento per bambini , denominati schede.

Le schede provengono da CardScrollAdapter associato al CardScrollView. Ogni scheda rappresenta visivamente un determinato elemento Object.

Per ulteriori informazioni, consulta la sezione Scorrere le schede nelle attività.

Uso generale

  1. Crea un insieme di schede utilizzando una gerarchia di visualizzazione standard o la classe CardBuilder.
  2. Implementa una CardScrollAdapter per fornire il set di carte a CardScrollView. Ogni scheda ha un identificatore Object univoco e rappresenta un determinato elemento Object.
  3. Imposta la visualizzazione dei contenuti della tua attività come CardScrollView o utilizza la CardScrollView in un layout.

Gestire lo scorrimento e l'interazione

CardScrollView ti invia una notifica con le seguenti interfacce degli ascoltatori ereditate da AdapterView:

Lezioni nidificate
enum CardscrollView.Animation Definisce il tipo di animazione utilizzato per accedere a una scheda, inserirla o eliminarla. 
Costanti ereditate
Campi ereditati
Costruttori pubblici
CardscrollView(contesto contesto, attributi AttributeSet)
CardscrollView(contesto contesto, attributi AttributeSet, int defStyle)
Metodi pubblici
nullo
boolean
animate (posizione int, CardscrollView.AnimationanimazioneType)
nullo
Adattatore di scorrimento scheda
lunghi
int
Visualizza
boolean
boolean
boolean
onKeyDown(int keyCode, evento KeyEvent)
nullo
onWindowFocusChanged(booleano hasWindowFocus)
nullo
nullo
setEmptyView(View emptyView)
nullo
setHorizontalscrollBarEnabled(attivazione booleana)
nullo
setSelection(posizione int)
Metodi protetti
boolean
boolean
nullo
nullo
onLayout(booleano, int a sinistra, int in alto, int a destra, int in basso)
nullo
onVisibilitàChanged(Visualizza modificataView, int visibilità)
Metodi ereditati

Costruttori pubblici

Aggiunto nel livello API XE12

pubblico CardscrollView (contesto)

Aggiunto nel livello API XE12

pubblico CardscrollView (contesto contesto, AttributeSet attributi)

Aggiunto nel livello API XE12

pubblico CardscrollView (contesto contesto, AttributeSet attributi, int defStyle)

Metodi pubblici

Aggiunto nel livello API XE12

pubblico void attiva ()

Comunica a CardScrollView di attivarsi ed essere pronto per la visualizzazione. TODO(ajcbik): verifica se possiamo sostituire [de]attivare con eventi di messa a fuoco, vedi b/17574566 richiesta.

Aggiunto nel livello API XE21

pubblico booleano animate (posizione int, CardscrollView.AnimationanimazioneType)

Anima la scheda in una determinata posizione, dove animationType deve essere una delle seguenti:

  • NAVIGATION: passa alla scheda specificata da qualsiasi posizione, navigazione standard,
  • INSERTION: passa alla scheda, che viene visualizzata, dopo l'inserimento.
  • DELETION: la scheda specificata scompare dalla visualizzazione, se selezionata, dopo l'eliminazione.
L'animazione viene ignorata se lo scorrimento è disattivato, se è ancora in corso un'animazione autonoma precedente o se la posizione non è valida. Un'animazione di eliminazione si verifica solo se al momento è selezionata la scheda eliminata.

L'animazione di inserimento ed eliminazione deve essere utilizzata dopo aver eseguito la mutazione corrispondente in CardScrollAdapter. L'animazione chiamerà notifyDataSetChanged() sull'adattatore al momento opportuno nell'animazione, anche se saltata o terminata in anticipo.

Esempio di utilizzo:

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

Parametri
position della scheda coinvolta nell'animazione
Tipo di animazione controlla il tipo di animazione da utilizzare.
Valori restituiti
  • Se l'animazione è stata avviata.
Aggiunto nel livello API XE12

pubblico void disattiva ()

Indica al CardScrollView di disattivarlo; non verrà visualizzato finché activate() non verrà richiamato.

Aggiunto nel livello API XE12

pubblico CardscrollAdapter getAdapter ()

pubblico lungo getSelectedItemId ()

Aggiunto nel livello API XE12

pubblico int getSelectedItemPosition ()

Aggiunto nel livello API XE12

pubblico Visualizza getSelectedView ()

Aggiunto nel livello API XE12

pubblico booleano isActivated ()

pubblico booleano isHorizontalscrollBarEnabled ()

pubblico booleano onKeyDown (int keyCode, evento KeyEvent)

pubblico void onWindowFocusChanged (booleano hasWindowFocus)

Aggiunto nel livello API XE12

pubblico void setAdapter (adattatore CardscrollAdapter)

pubblico void setEmptyView (Visualizza emptyView)

setEmptyView(View) non è supportato da CardScrollView.

Per ottenere un'animazione e un comportamento corretti, utilizza un adattatore con una singola vista vuota per i set di dati vuoti.

pubblico void setHorizontalscrollBarEnabled (attivazione booleana)

Aggiunto nel livello API XE12

pubblico void setSelection (posizioneint)

Metodi protetti

protetto booleano awakenscrollBars ()

Risveglia la barra di scorrimento orizzontale, se presente.

protetto booleano dispatchGenericFocusedEvent (evento MotionEvent)

protetto void inizializzazione inizializzascrollbars (TypedArray a)

Aggiunto nel livello API XE12

protetto void onLayout (booleano modificato, int sinistro, int superiore, int destra, int inferiore)

protetto void onVisibilitàChanged (Visualizza modificato, visibilità interna)