कार्ड स्क्रोल व्यू

एपीआई लेवल XE12 में जोड़ा गया

View, जो बच्चों के व्यू के लिए हॉरिज़ॉन्टल स्क्रोलिंग दिखाता है, जिन्हें कार्ड कहा जाता है.

कार्ड उस CardScrollAdapter से आते हैं जो CardScrollView. हर कार्ड एक खास Object आइटम को विज़ुअल तौर पर दिखाता है.

देखें ज़्यादा जानकारी के लिए, गतिविधियों में कार्ड स्क्रोल करना.

सामान्य इस्तेमाल

  1. स्टैंडर्ड व्यू हैरारकी या CardBuilder क्लास का इस्तेमाल करके, कार्ड का सेट बनाएं.
  2. CardScrollAdapter लागू करें, ताकि CardScrollView. हर कार्ड का एक यूनीक Object आइडेंटिफ़ायर होता है और किसी खास Object आइटम को दिखाता है.
  3. अपनी गतिविधि के कॉन्टेंट व्यू को CardScrollView पर सेट करें या लेआउट में CardScrollView.

स्क्रोलिंग और इंटरैक्शन मैनेज करना

CardScrollView आपको इन लिसनर इंटरफ़ेस से सूचना देता है AdapterView से इनहेरिट किया गया:

  • AdapterView.OnItemSelectedListener - एक आइटम चुना गया है जब उपयोगकर्ता सूची को स्क्रोल करना पूरा कर लेता है और किसी आइटम पर सेट हो जाता है.
  • AdapterView.OnItemClickListener - किसी आइटम पर तब क्लिक किया गया, जब जब उपयोगकर्ता चुने गए आइटम पर टैप करता है और उसे छोड़ देता है.
  • AdapterView.OnItemLongClickListener) - एक आइटम है देर तक क्लिक करने की सुविधा, जब उपयोगकर्ता किसी आइटम पर टैप करता है, उसे दबाकर रखता है, और उसे छोड़ देता है चुना गया.

नेस्ट की गई क्लास
enum CardScrollView.Animation इस नीति से यह तय होता है कि कार्ड पर नेविगेट करने, उसे शामिल करने या मिटाने के लिए, किस ऐनिमेशन का इस्तेमाल किया जाता है.
इनहेरिट किए गए कॉन्सटेंट
इनहेरिट किए गए फ़ील्ड
पब्लिक कंस्ट्रक्टर
CardScrollView(कॉन्टेक्स्ट कॉन्टेक्स्ट)
CardScrollView(कॉन्टेक्स्ट कॉन्टेक्स्ट, AttributeSet एट्रिब्यूट)
CardScrollView(कॉन्टेक्स्ट कॉन्टेक्स्ट, AttributeSet एट्रिब्यूट, int defStyle)
सार्वजनिक तरीके
अमान्य
बूलियन
ऐनिमेशन(इंटीशन की स्थिति, CardScrollView.Animation ऐनिमेशन टाइप)
अमान्य
CardScrollAdapter
लंबा
int
देखें
बूलियन
बूलियन
बूलियन
onKeyDown(int keyCode, KeyEvent इवेंट)
अमान्य
onWindowFocusChanged(बूलियन hasWindowFocus)
अमान्य
setAdapter(CardScrollAdapter अडैप्टर)
अमान्य
setEmptyView(View emptyView)
अमान्य
setHorizontalScrollBarEnabled(बूलियन चालू करें)
अमान्य
setSelection(इंटीपोज़िशन की जगह)
सुरक्षित तरीके
बूलियन
बूलियन
अमान्य
अमान्य
onLayout(बूलियन बदला गया, int बाईं ओर, पूर्णांक में, int दाएं, int नीचे)
अमान्य
onVisibilityChanged(व्यू बदला गया व्यू, int किसको दिखे)
इनहेरिट किए गए तरीके

पब्लिक कंस्ट्रक्टर

एपीआई लेवल XE12 में जोड़ा गया

सार्वजनिक CardScrollView (कॉन्टेक्स्ट संदर्भ)

एपीआई लेवल XE12 में जोड़ा गया

सार्वजनिक CardScrollView (कॉन्टेक्स्ट कॉन्टेक्स्ट, AttributeSet एट्रिब्यूट)

एपीआई लेवल XE12 में जोड़ा गया

सार्वजनिक CardScrollView (कॉन्टेक्स्ट कॉन्टेक्स्ट, AttributeSet attrs, int defStyle)

सार्वजनिक तरीके

एपीआई लेवल XE12 में जोड़ा गया

सार्वजनिक अमान्य चालू करें ()

यह सूचना, CardScrollView को चालू करने और डिसप्ले के लिए तैयार रहने के लिए कहती है. TODO(ajcbik): जांच करें कि क्या हम [de]activate को फ़ोकस इवेंट से बदल सकते हैं.

एपीआई लेवल XE21 में जोड़ा गया

सार्वजनिक बूलियन ऐनिमेशन (इंटिग्रिटी पोज़िशन, CardScrollView.Animation ऐनिमेशन टाइप)

दी गई जगह पर कार्ड का ऐनिमेशन करता है, जहां animationType इनमें से एक होना चाहिए:

  • NAVIGATION: किसी भी जगह से दिए गए कार्ड पर ले जाता है,
  • INSERTION: दिए गए कार्ड में चला जाता है, जो नज़र आता है, डालने के बाद,
  • DELETION: अगर इसे चुना जाता है, तो कार्ड मिटाए जाने के बाद दिखना बंद हो जाता है.
अगर स्क्रोलर बंद हो जाता है, तो ऐनिमेशन को स्किप कर दिया जाता है. ऐसा तब होता है, जब कोई पुराना ऑटोनॉमस ऐनिमेशन अब भी चल रहा है या स्थिति अमान्य है. मिटाने से जुड़ा ऐनिमेशन सिर्फ़ तब दिखता है, जब कार्ड अभी चुना गया है.

संबंधित म्यूटेशन के बाद ही इंसर्शन और मिटाने के ऐनिमेशन का इस्तेमाल किया जाना चाहिए CardScrollAdapter में. ऐनिमेशन, notifyDataSetChanged() को इस डिवाइस पर कॉल करेगा अडैप्टर को एनिमेशन में सही समय पर अपलोड करना चाहिए, भले ही उसे समय से पहले स्किप कर दिया गया हो या खत्म कर दिया गया हो.

इस्तेमाल के उदाहरण:

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

पैरामीटर
जगह ऐनिमेशन में शामिल कार्ड का
animationType इस्तेमाल करने के लिए ऐनिमेशन के टाइप को कंट्रोल करता है
रिटर्न
  • ऐनिमेशन शुरू हुआ या नहीं
एपीआई लेवल XE12 में जोड़ा गया

सार्वजनिक अमान्य बंद करें ()

CardScrollView को बंद करने के लिए कहता है; यह के बाद तक नहीं दिखेगा activate() को फिर से कॉल किया गया.

एपीआई लेवल XE12 में जोड़ा गया

सार्वजनिक CardScrollAdapter getAdapter ()

सार्वजनिक लंबा getSelectedItemId ()

एपीआई लेवल XE12 में जोड़ा गया

सार्वजनिक आईएनटी getSelectedItemPosition ()

एपीआई लेवल XE12 में जोड़ा गया

सार्वजनिक देखें getSelectedView ()

एपीआई लेवल XE12 में जोड़ा गया

सार्वजनिक बूलियन isActivated ()

सार्वजनिक बूलियन isHorizontalScrollBarEnabled ()

सार्वजनिक बूलियन onKeyDown (int keyCode, KeyEvent इवेंट)

सार्वजनिक अमान्य onWindowFocusChanged (बूलियन hasWindowFocus)

एपीआई लेवल XE12 में जोड़ा गया

सार्वजनिक अमान्य setAdapter (CardScrollAdapter अडैप्टर)

सार्वजनिक अमान्य setEmptyView (देखें खाली व्यू)

setEmptyView(View), CardScrollView.

सही ऐनिमेशन और आसानी से समझने के लिए, अडैप्टर का इस्तेमाल खाली डेटा सेट के लिए खाली व्यू का इस्तेमाल करें.

सार्वजनिक अमान्य setHorizontalScrollBarEnabled (बूलियन चालू करें)

एपीआई लेवल XE12 में जोड़ा गया

सार्वजनिक अमान्य setSelection (अंतराल स्थान)

सुरक्षित तरीके

सुरक्षित बूलियन awakenScrollBars ()

अगर हॉरिज़ॉन्टल स्क्रोलबार है, तो उसे जागता है.

सुरक्षित बूलियन dispatchGenericFocusedEvent (MotionEvent इवेंट)

सुरक्षित अमान्य initializeScrollbars (TypedArray a)

एपीआई लेवल XE12 में जोड़ा गया

सुरक्षित अमान्य onLayout (बूलियन बदला गया, बाईं ओर बाईं ओर, पूर्णांक में, दाईं ओर सबसे ऊपर, पूर्णांक में)

सुरक्षित अमान्य onVisibilityChanged (व्यू बदला गया व्यू, पूर्णांक विज़िबिलिटी)