CardScrollView

Ajouté dans le niveau d'API XE12

View qui affiche les vues enfants à défilement horizontal, également appelé "fiches".

Les cartes proviennent du CardScrollAdapter associé au CardScrollView. Chaque fiche représente visuellement un certain élément Object.

Pour en savoir plus, consultez Faire défiler les fiches dans les activités.

Utilisation générale

  1. Créez un ensemble de fiches en utilisant une hiérarchie de vues standard ou la classe CardBuilder.
  2. Implémentez un CardScrollAdapter pour fournir l'ensemble de cartes au CardScrollView. Chaque carte possède un identifiant Object unique et représente un élément Object spécifique.
  3. Définissez la vue du contenu de votre activité sur CardScrollView ou utilisez CardScrollView dans une mise en page.

Gérer le défilement et les interactions

CardScrollView vous avertit avec les interfaces d'écouteur suivantes, qui sont héritées de AdapterView:

Cours imbriqués
enum CardScrollView.Animation Définit le type d'animation permettant d'accéder à une fiche, de l'insérer ou de la supprimer. 
Constantes héritées
Champs hérités
Constructeurs publics
CardScrollView(Context)
CardScrollView(contexte Context, AttributeSet attrs)
CardScrollView(contexte Context, AttributeSet attrs, int defStyle)
Méthodes publiques
void
activate()
booléen
animate(int., CardScrollView.Animation animationType)
void
deactivate().
CardScrollAdapter
getAdapter()
long
getSelectedItemId()
int
getSelectedItemPosition()
Afficher
getSelectedView()
booléen
isActivated()
booléen
isHorizontalScrollBarEnabled()
booléen
onKeyDown(événement keyCode, événement KeyEvent)
void
onWindowFocusChanged(boolean hasWindowFocus)
void
setAdapter (adaptateur CardScrollAdapter)
void
setEmptyView(View emptyView)
void
setHorizontalScrollBarEnabled(valeur booléenne d'activation)
void
setSelection(position du entier)
Méthodes protégées
booléen
awakenScrollBars()
booléen
dispatchGenericFocusedEvent(événement MotionEvent)
void
initializeScrollbars(TypedArray a)
void
onLayout (valeur booléenne modifiée, valeur entière int gauche, valeur entière int, valeur droite, valeur entière)
void
onVisibilityChanged(Afficher changedView, int visibilité)
Méthodes héritées

Constructeurs publics

Ajouté dans le niveau d'API XE12

public CardScrollView (context)

Ajouté dans le niveau d'API XE12

public CardScrollView (Context, AttributeSet attributs)

Ajouté dans le niveau d'API XE12

public CardScrollView (Context, AttributeSet attrs, int defStyle)

Méthodes publiques

Ajouté dans le niveau d'API XE12

public void activate ()

Demande à CardScrollView d'être activée et prête à être affichée. TODO(ajcbik): déterminez si nous pouvons remplacer [de]activer par les événements de mise au point. Consultez la demande b/17574566.

Ajouté au niveau de l'API XE21

public booléen animate (position int, CardScrollView.Animation animationType)

Anime la fiche à la position donnée, où animationType doit être l'un des éléments suivants:

  • NAVIGATION : permet de passer à une carte donnée depuis n'importe quelle position, navigation standard,
  • INSERTION : permet d'accéder à une fiche donnée, qui s'affiche après l'insertion.
  • DELETION : la carte concernée disparaît de la vue, si elle est sélectionnée, après sa suppression.
L'animation est ignorée si le curseur de défilement est désactivé, si une ancienne animation autonome est toujours en cours ou si la position n'est pas valide. Une animation de suppression ne se produit que si la fiche supprimée est actuellement sélectionnée.

Vous devez utiliser l'animation d'insertion et de suppression après avoir effectué la mutation correspondante dans CardScrollAdapter. L'animation appelle le notifyDataSetChanged() sur l'adaptateur au moment approprié, même lorsqu'elle est ignorée ou prend fin de manière anticipée.

Exemple d'utilisation : 

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

Paramètres
position de la fiche impliquée dans l'animation
Type d'animation contrôle le type d'animation à utiliser
Renvoie
  • si l'animation a été lancée
Ajouté dans le niveau d'API XE12

public void désactiver ()

Demande à CardScrollView de désactiver ; il ne s'affichera qu'une fois le activate() appelé à nouveau.

Ajouté dans le niveau d'API XE12

public CardScrollAdapter getAdapter ()

public long getSelectedItemId ()

Ajouté dans le niveau d'API XE12

public int getSelectedItemPosition ()

Ajouté dans le niveau d'API XE12

public Afficher getSelectedView ()

Ajouté dans le niveau d'API XE12

public booléen isActivated ()

public booléen isHorizontalScrollBarEnabled ()

public booléen onKeyDown (int keyCode, KeyEvent)

public void onWindowFocusChanged (boolean hasWindowFocus)

Ajouté dans le niveau d'API XE12

public void setAdapter (adaptateur ScrollScrollAdapter)

public void setEmptyView (Afficher emptyView)

setEmptyView(View) n'est pas compatible avec CardScrollView.

Pour obtenir une animation et un comportement détournés corrects, utilisez plutôt un adaptateur avec une seule vue vide pour les ensembles de données vides.

public void setHorizontalScrollBarEnabled (booléen activé)

Ajouté dans le niveau d'API XE12

public void setSelection (int.)

Méthodes protégées

protection booléen awakenScrollBars ()

Réactive la barre de défilement horizontale, le cas échéant.

Voir également

protection booléen dispatchGenericFocusedEvent (MotionEvent événement)

protection void initializeScrollbars (TypedArray a)

Ajouté dans le niveau d'API XE12

protection void onLayout (booléen modifié, int gauche, int haut, int droite, int bas)

protection void onVisibilityChanged (Afficher changedView, int visibilité)