CardScrollView

Ajouté au niveau d'API XE12

View qui affiche des vues enfants à défilement horizontal appelées cartes.

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

Voir <ph type="x-smartling-placeholder"></ph> Faire défiler les fiches dans les activités pour en savoir plus.

Utilisation générale

  1. Créez un ensemble de fiches à l'aide d'une hiérarchie de vues standard ou de 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 donné.
  3. Définissez la vue du contenu de votre activité sur CardScrollView ou utilisez la CardScrollView dans une mise en page.

Gérer le défilement et l'interaction

CardScrollView vous indique les interfaces d'écouteur suivantes qui sont hérité de AdapterView:

  • AdapterView.OnItemSelectedListener : un élément est sélectionné une fois que l'utilisateur a fini de faire défiler la liste et a trouvé un élément.
  • AdapterView.OnItemClickListener : un clic est effectué sur un élément lorsque l'utilisateur appuie sur un élément qui est sélectionné et le relâche.
  • AdapterView.OnItemLongClickListener) : un élément est clique de manière prolongée lorsque l'utilisateur appuie, applique une obligation de conservation et lève le doigt sur un élément sélectionné.

Classes imbriquées
énum CardScrollView.Animation Définit le type d'animation utilisé pour accéder à une fiche, l'insérer ou la supprimer.
Constantes héritées
Champs hérités
Constructeurs publics
CardScrollView(contexte Context, AttributeSet d'attributs)
CardScrollView(contexte Contexte, AttributeSet attributs, int defStyle)
Méthodes publiques
vide
booléen
animate(position entière, CardScrollView.Animation animationType)
vide
CardScrollAdapter
long
int
Afficher
booléen
booléen
booléen
onKeyDown(int keyCode, événement KeyEvent)
vide
onWindowFocusChanged(booléen hasWindowFocus)
vide
vide
setEmptyView(View emptyView)
vide
setHorizontalScrollBarEnabled(activation booléenne)
vide
setSelection(position entière)
Méthodes protégées
booléen
booléen
vide
vide
onLayout(valeur booléenne modifiée, int left, int top, int right, int bottom)
vide
onVisibilityChanged(View changedView, int visibility)
Méthodes héritées

Constructeurs publics

Ajouté au niveau d'API XE12

<ph type="x-smartling-placeholder"></ph> public CardScrollView (contexte Contexte)

Ajouté au niveau d'API XE12

<ph type="x-smartling-placeholder"></ph> public CardScrollView (contextes Context, AttributeSet)

Ajouté au niveau d'API XE12

<ph type="x-smartling-placeholder"></ph> public CardScrollView (contextes Context, AttributeSet d'attr, int defStyle)

Méthodes publiques

Ajouté au niveau d'API XE12

<ph type="x-smartling-placeholder"></ph> public vide activer ()

Demande à l'appareil CardScrollView de s'activer et d'être prêt à être affiché. TODO(ajcbik): vérifier s'il est possible de remplacer [de]activate par des événements de focus.

Ajouté au niveau d'API XE21

<ph type="x-smartling-placeholder"></ph> public Booléen animer (int position, CardScrollView.Animation animationType)

S'anime pour la carte à la position donnée, où animationType doit être l'un des éléments suivants:

  • NAVIGATION: se déplace vers une carte donnée depuis n'importe quelle position, navigation normale,
  • INSERTION: passe à la fiche donnée, qui apparaît dans la vue après l'insertion,
  • DELETION: la carte donnée disparaît de la vue, si elle est sélectionnée, après sa suppression.
L'animation est ignorée si le conteneur de défilement est désactivé, si une animation autonome précédente est toujours en cours ou si la position n'est pas valide. Une animation de suppression ne se produit que si l'élément supprimé la carte est actuellement sélectionnée.

L'animation d'insertion et de suppression doit être utilisée après la mutation correspondante dans CardScrollAdapter. L'animation appellera notifyDataSetChanged() sur l'adaptateur au moment approprié de l'animation, même s'il est ignoré ou arrêté avant la fin.

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.
animationType contrôle le type d'animation à utiliser
Renvoie
  • si l'animation a été lancée
Ajouté au niveau d'API XE12

<ph type="x-smartling-placeholder"></ph> public vide désactiver ()

demande à CardScrollView de désactiver l'élément ; elle ne s'affichera qu'après activate() est rappelé.

Ajouté au niveau d'API XE12

<ph type="x-smartling-placeholder"></ph> public CardScrollAdapter getAdapter ()

<ph type="x-smartling-placeholder"></ph> public long getSelectedItemId ()

Ajouté au niveau d'API XE12

<ph type="x-smartling-placeholder"></ph> public entier getSelectedItemPosition ()

Ajouté au niveau d'API XE12

<ph type="x-smartling-placeholder"></ph> public Afficher getSelectedView ()

Ajouté au niveau d'API XE12

<ph type="x-smartling-placeholder"></ph> public Booléen isActivated ()

<ph type="x-smartling-placeholder"></ph> public Booléen isHorizontalScrollBarEnabled ()

<ph type="x-smartling-placeholder"></ph> public Booléen onKeyDown (int keyCode, événement KeyEvent)

<ph type="x-smartling-placeholder"></ph> public vide onWindowFocusChanged (booléen hasWindowFocus)

Ajouté au niveau d'API XE12

<ph type="x-smartling-placeholder"></ph> public vide setAdapter (adaptateur CardScrollAdapter)

<ph type="x-smartling-placeholder"></ph> public vide setEmptyView (Afficher emptyView)

Le setEmptyView(View) n'est pas compatible avec le CardScrollView

Pour obtenir une animation et un comportement coulissants corrects, utilisez un adaptateur avec une seule des ensembles de données vides.

<ph type="x-smartling-placeholder"></ph> public vide setHorizontalScrollBarEnabled (activation booléenne)

Ajouté au niveau d'API XE12

<ph type="x-smartling-placeholder"></ph> public vide setSelection (position entière)

Méthodes protégées

<ph type="x-smartling-placeholder"></ph> protégé Booléen awakenScrollBars ()

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

<ph type="x-smartling-placeholder"></ph> protégé Booléen dispatchGenericFocusedEvent (événement MotionEvent)

<ph type="x-smartling-placeholder"></ph> protégé vide initializeScrollbars (TypedArray a)

Ajouté au niveau d'API XE12

<ph type="x-smartling-placeholder"></ph> protégé vide onLayout (valeur booléenne modifiée, int gauche, int haut, int droite, int bas)

<ph type="x-smartling-placeholder"></ph> protégé vide onVisibilityChanged (Vue : changedView, int visibility)