Scorrimento schede

Aggiunta nel livello API XE12

Un elemento View che mostra le visualizzazioni secondarie con scorrimento orizzontale, o carte.

Le schede provengono dall'elemento CardScrollAdapter associato all'attributo CardScrollView. Ogni scheda rappresenta visivamente un determinato elemento di Object.

Vedi Scorrere le schede nelle attività per avere ulteriori informazioni.

Uso generale

  1. Crea un insieme di schede utilizzando una gerarchia di visualizzazione standard o la classe CardBuilder.
  2. Implementa un CardScrollAdapter per fornire l'insieme di carte alla CardScrollView. Ogni carta ha un identificatore Object univoco e rappresenta un determinato elemento Object.
  3. Imposta la visualizzazione dei contenuti della tua attività su CardScrollView o usa CardScrollView in un layout.

Gestione dello scorrimento e dell'interazione

CardScrollView ti invia una notifica con le seguenti interfacce listener che sono ereditato da AdapterView:

Classi nidificate
enum CardScrollView.Animation Definisce il tipo di animazione utilizzato per accedere, inserire o eliminare una scheda.
Costanti ereditate
Campi ereditati
Costruttori pubblici
CardScrollView(contesto Context, attributi AttributeSet)
CardScrollView(Context contesto, AttributeSet attributi, int defStyle)
Metodi pubblici
null
booleano
animate(int position, CardScrollView.Animation animationType)
null
CardScrollAdapter
Lungo
int
Visualizza
booleano
booleano
booleano
onKeyDown(int keyCode, evento KeyEvent)
null
onWindowFocusChanged(boolean hasWindowFocus)
null
null
null
setHorizontalScrollBarEnabled(abilitazione booleana)
null
setSelection(int position)
Metodi protetti
booleano
booleano
null
null
onLayout(booleano modificato, int left, int top, int Right, int bottom)
null
onVisibilityChanged(View changedView, visibilità int)
Metodi ereditati

Costruttori pubblici

Aggiunta nel livello API XE12

pubblica . CardScrollView (ContestoContesto)

Aggiunta nel livello API XE12

pubblica . CardScrollView (Contesto contesto, attributi AttributeSet)

Aggiunta nel livello API XE12

pubblica . CardScrollView (Context context, AttributeSet attrs, int defStyle)

Metodi pubblici

Aggiunta nel livello API XE12

pubblica null . attiva ()

Comunica al CardScrollView di attivarsi ed essere pronto per la visualizzazione. TODO(ajcbik): verifica se possiamo sostituire [de]activate con eventi focus.

Aggiunta nel livello API XE21

pubblica booleano . anima (int position, CardScrollView.Animation animatoType)

Viene visualizzata l'animazione di una scheda in una determinata posizione, dove animationType deve essere uno dei seguenti:

  • NAVIGATION: passa a una determinata scheda da qualsiasi posizione, navigazione regolare
  • INSERTION: passa a una determinata scheda, che appare dopo l'inserimento,
  • DELETION: la scheda specificata scompare dalla visualizzazione, se selezionata, dopo l'eliminazione.
di Gemini Advanced. Se lo scorrimento è disattivato, l'animazione viene ignorata se viene utilizzata un'animazione precedente è ancora in corso o se la posizione non è valida. Un'animazione di eliminazione si verifica solo se carta attualmente selezionata.

L'animazione di inserimento ed eliminazione deve essere utilizzata dopo aver eseguito la mutazione corrispondente a CardScrollAdapter. L'animazione chiamerà notifyDataSetChanged() su l'adattatore al momento giusto dell'animazione, anche quando l'adattatore viene ignorato o terminato 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.
animationType controlla il tipo di animazione da utilizzare
Resi
  • se l'animazione è stata avviata
Aggiunta nel livello API XE12

pubblica null . disattiva ()

Comunica a CardScrollView di disattivarsi; non verrà visualizzato prima di activate() è stato richiamato.

Aggiunta nel livello API XE12

pubblica CardScrollAdapter getAdapter ()

pubblica lungo . getSelectedItemId ()

Aggiunta nel livello API XE12

pubblica int . getSelectedItemPosition ()

Aggiunta nel livello API XE12

pubblica Visualizza getSelectedView ()

Aggiunta nel livello API XE12

pubblica booleano . isActivated ()

pubblica booleano . isHorizontalScrollBarEnabled ()

pubblica booleano . onKeyDown (int keyCode, evento KeyEvent)

pubblica null . onWindowFocusChanged (boolean hasWindowFocus)

Aggiunta nel livello API XE12

pubblica null . setAdapter (adattatoreCardScrollAdapter)

pubblica null . setEmptyView (Visualizza emptyView)

setEmptyView(View) non è supportato dal CardScrollView.

Per ottenere animazioni e comportamenti scorrevoli corretti, utilizza un adattatore con un singolo vuota per i set di dati vuoti.

pubblica null . setHorizontalScrollBarEnabled (booleano abilitato)

Aggiunta nel livello API XE12

pubblica null . setSelection (int position)

Metodi protetti

protetto booleano . awakenScrollBars ()

Consente di riattivare la barra di scorrimento orizzontale, se presente.

protetto booleano . dispatchGenericFocusedEvent (evento MotionEvent)

protetto null . initializeScrollbars (TypedArray a)

Aggiunta nel livello API XE12

protetto null . onLayout (booleano modificato, int left, int top, int Right, int bottom)

protetto null . onVisibilityChanged (Visualizzazione modificata, visibilità int)