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

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

इस नीति से, View बच्चों को हॉरिज़ॉन्टल तौर पर स्क्रोल करते हुए दिखाने वाले कार्ड दिखते हैं.

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

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

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

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

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

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

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

नेस्टेड क्लास
enum CardscrollView.Animation इसमें, किसी कार्ड पर नेविगेट करने, उसे शामिल करने या मिटाने के लिए इस्तेमाल किए जाने वाले ऐनिमेशन के टाइप के बारे में बताया जाता है. 
इनहेरिट किए गए कॉन्सटेंट
इनहेरिट किए गए फ़ील्ड
पब्लिक कंस्ट्रक्टर
CardscrollView(संदर्भ का संदर्भ)
CardscrollView(संदर्भ कॉन्टेक्स्ट, AttributeSet attr)
CardscrollView(संदर्भ संदर्भ, AttributeSet attr, int defStyle)
सार्वजनिक मेथड
शून्य
बूलियन
ऐनिमेट(इंटर पोज़िशन, CardscrollView.Animation ऐनिमेशन टाइप)
शून्य
CardscrollAdapter
लंबा
int
देखें
getSelectedView पर जाएं
बूलियन
बूलियन
बूलियन
onKeyDown(int KeyCode, KeyEvent इवेंट)
शून्य
onwindowConfigChanged(बूलियन हैविंडोफ़ोकस)
शून्य
setAdapter(CardscrollAdapter अडैप्टर)
शून्य
setemptyView(व्यू खाली व्यू)
शून्य
setहॉरिज़ॉन्टलtalscrollBarEnabled(बूलियन चालू है)
शून्य
setSelection(इंटर पोज़िशन)
सुरक्षित तरीके
बूलियन
बूलियन
शून्य
शून्य
onLayout(बूलियन बदला गया, इंटट, इंट, टॉप, इंट राइट, इंटट बॉटम)
शून्य
'किसको दिखे' सेटिंग बदली गई(व्यू बदली गई व्यू, पूरी तरह से दिखने वाली सेटिंग)
इनहेरिट की गई विधियां

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

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

सार्वजनिक CardscrollView (संदर्भ संदर्भ)

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

सार्वजनिक CardscrollView (संदर्भ संदर्भ, AttributeSet attr)

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

सार्वजनिक CardscrollView (कॉन्टेक्स्ट संदर्भ, AttributeSet attr, int defStyle)

सार्वजनिक मेथड

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

Public फ़िल्टर चालू करें ()

CardScrollView को चालू करने और दिखाने के लिए तैयार होने के लिए कहता है. TODO(ajcbik): जांच करें कि क्या हम [de]activate फ़ोकस इवेंट के साथ बदलें, b/17574566 अनुरोध देखें.

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

सार्वजनिक बूलियन एनिमेट (इंटेजरिशन, CardscrollView.Animation ऐनिमेशनटाइप)

दिए गए स्थान पर कार्ड के लिए ऐनिमेट करें, जहां animationType इनमें से एक होना चाहिए:

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

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

इस्तेमाल का नमूना:

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

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

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

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

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

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

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

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

Public int getSelectedItemPosition ()

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

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

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

सार्वजनिक बूलियन isऐक्टिवेड ()

सार्वजनिक बूलियन isहॉरिज़ॉन्टलtalscrollBarEnabled ()

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

सार्वजनिक व्यर्थ onwindow बिडChanged (बूलियन hasविंडोफ़ोकस)

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

सार्वजनिक शून्य setAdapter (CardscrollAdapter अडैप्टर)

सार्वजनिक शून्य setemptyView (देखें खाली दृश्य)

CardScrollView के साथ setEmptyView(View) काम नहीं करता.

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

सार्वजनिक शून्य setहॉरिज़ॉन्टलtalscrollBarEnabled (बूलियन चालू है)

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

सार्वजनिक अमान्य setSelection (इंटर पोज़िशन)

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

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

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

लेख में बदलाव करें बूलियन dispatchGeneralFocusedEvent (MotionEvent इवेंट)

लेख में बदलाव करें अमान्य प्रोसेस करेंस्क्रोलबार शुरू करें (TypedArray a)

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

सुरक्षित शून्य onLayout (बूलियन बदला गया, int left, inttop, int राइट, पूर्णांक नीचे)

सुरक्षित शून्य चालू होने पर बदली गई (व्यू चेंज ऑफ़, व्यू इंटिग्रिटी)