समर्थन लाइब्रेरी के साथ Android 2.1+ पर ActionBar। भाग 3 - उपयोगी सुविधाएँ

सभी को शुभ दिन!

हम्म, बहुत समय तक मैंने हैबर पर लेख नहीं लिखा। खैर, मैं इस मामले को सही करूंगा।
सामान्य तौर पर, Android में ActionBar एक बहुत जटिल चीज़ है। पहले और दूसरे भाग में, मैंने केवल इसके मुख्य कार्यों - मेनू और नेविगेशन की जांच की। लेकिन कई अतिरिक्त हैं: स्प्लिट एक्शनबार, मेनू आइटम के लिए कस्टम दृश्य और एक्शनप्रॉइडर। उनके बारे में और चर्चा की जाएगी। इसके अलावा, एक बोनस: बहुत से लोग जानते हैं कि अप बटन पिछली गतिविधि पर जाने के लिए कार्य करता है। लेकिन अगर आप केवल एक अन्य गतिविधि के साथ स्क्रीन पर पहुंच सकते हैं, तो आप संक्रमण को कोड नहीं कर सकते। क्या आप साज़िश कर रहे हैं? मैं बिल्ली माँगता हूँ।

विभाजन क्रिया

स्प्लिट एक्शनबार मेनू आइटम के साथ स्क्रीन के नीचे एक बार है। इसका उपयोग तब किया जा सकता है जब ActionBar ज्यादातर अंतरिक्ष के बाहर (बीच में) या लापता (दाईं ओर) हो। इसे जोड़ना आसान है: गतिविधि या संपूर्ण एप्लिकेशन के लिए निम्नलिखित पंक्तियों को प्रकट फ़ाइल में जोड़ें:

<manifest ...> <activity … uiOptions="splitActionBarWhenNarrow" ... > // API 14+ <meta-data android:name="android.support.UI_OPTIONS" //  Support Library API 7+ android:value="splitActionBarWhenNarrow" /> </activity> </manifest> 

शीर्ष ActionBar (दाईं ओर की आकृति के रूप में) को निकालने के लिए आपको ActionBar विधियों को कॉल करने की आवश्यकता है setDisplayShowHomeEnabled (गलत) और setDisplayShowTitleEnabled (गलत) ।

ActionView

डिफ़ॉल्ट रूप से, मेनू आइटम चित्र (आइकन) जैसा दिखता है। इसे बदलने के दो तरीके हैं:
-एडलैटआउट विशेषता को टैग में जोड़ें। यह इनपुट के रूप में लेआउट फ़ाइल का लिंक स्वीकार करता है।
एक्शन व्यू क्लैड को उस टैग पर विशेषता दें जहां मानक दृश्य के बजाय कक्षा का नाम, व्यू के उत्तराधिकारी का उपयोग करना है

 <menu xmlns:android="http://schemas.android.com/apk/res/android" xmlns:yourapp="http://schemas.android.com/apk/res-auto" > <item android:id="@+id/custom_action " android:title="@string/custom_action " android:icon="@drawable/ic_custom_action " yourapp:actionViewClass="com.you.app.CustomView" /> </menu> 

Android नामस्थान के पुराने संस्करणों में ये विशेषताएँ नहीं हैं, इसलिए आपको समर्थन लाइब्रेरी नामस्थान का उपयोग करने की आवश्यकता है - ऐसा करने के लिए, लाइन को जोड़ें xmlns: yourapp = " schemas.android.com/apk/res-auto " और yourapp का उपयोग करें : actionViewClass विशेषता । आप MenuItemCompat setActionView (MenuItem आइटम, int resId) और setActionView (MenuItem आइटम, दृश्य देखें) विधियों का उपयोग करके MenuItem के लेआउट को प्रोग्रामेटिक रूप से बदल सकते हैं, वर्तमान दृश्य - GetActionView (MenuItem आइटम) प्राप्त कर सकते हैं ।

ActionView का एक उदाहरण SearchView है, जिसका वर्णन यहाँ और अधिक विस्तार से किया गया है ।

क्रिया प्रदाता

ActionProvider में ActionView के साथ बहुत कुछ है। यह बटन को अपने स्वयं के लेआउट के साथ भी बदलता है, लेकिन ड्रॉप-डाउन सूची दिखा सकता है और मेनू आइटम के व्यवहार को नियंत्रित कर सकता है। मेनू आइटम के लिए इसे सेट करने के लिए, टैग को विशेषता एक्शनप्रोवइडरक्लास जोड़ने के लिए पर्याप्त है, जहां आपकी कक्षा का पता लिखना है। इसे ActionProvider से इनहेरिट करना चाहिए और निम्न विधियों को ओवरराइड करना चाहिए:
- एक्शनप्रॉइडर (संदर्भ संदर्भ) -कंस्ट्रक्टर , इनपुट संदर्भ लेता है, जिसे अन्य तरीकों में उपयोग के लिए वर्ग फ़ील्ड में संग्रहीत किया जाना चाहिए;
- onCreateActionView (MenuItem) - यहां हम LayoutInflater का उपयोग करके मेनू आइटम के लिए एक दृश्य बनाते हैं, जिसे संदर्भ से प्राप्त किया गया है, और इसे वापस लौटाएं;
- onPerformDefaultAction () - जब उपयोगकर्ता ActionBar में किसी आइटम पर क्लिक करता है।

यदि आप एक ActionProvider का उपयोग करते हैं, तो आपको इसे onOptionsItemSelected () , अच्छी तरह से पर क्लिक करने से रोकना चाहिए, या वहां से वापस लौटना चाहिए, क्योंकि अन्यथा onPerformDefaultAction () नहीं कहा जाएगा।

यदि आपका ActionProvider एक सबमेनू दिखाता है, तो आपको इसकी hasSubMenu () विधि को ओवरराइड करना चाहिए और सही लौटना चाहिए। फिर onPerformDefaultAction () के बजाय , onPrepareSubMenu (सबमेन्यू सबमेनू) कहा जाएगा। वहां आप एक सबमेनू बनाते या बदलते हैं।

ShareActionProvider

Android के पास सामग्री भेजने के लिए अपना खुद का ActionProvider है - ShareActionProvider । इसके साथ एक मेनू बनाते समय, आपको इसका उदाहरण onCreateOptionsMenu पद्धति में MenuItemCompat.getActionProvider (MenuItem) और कॉल setShareIntent () का उपयोग करके प्राप्त करना होगा, जहां ACTION_SEND और संलग्न सामग्री के साथ आशय को पास करना है:

 private ShareActionProvider mShareActionProvider; @Override public boolean onCreateOptionsMenu(Menu menu) { getMenuInflater().inflate(R.menu.main_activity_actions, menu); Intent share_intent = new Intent(Intent.ACTION_SEND); intent.setType("image/*"); mShareActionProvider = (ShareActionProvider) getActionProvider(menu.findItem(R.id.action_share)); mShareActionProvider.setShareIntent(share_intent); return super.onCreateOptionsMenu(menu); } 

चूंकि स्क्रीन पर सामग्री बदल सकती है (उदाहरण के लिए, चित्रों को बदलना), तो आपको हर बार सामग्री बदलने के लिए सेटशेयरइंटेंट () कॉल करने की आवश्यकता होती है।

अभिभावक गतिविधि

यदि एप्लिकेशन में स्क्रीन को केवल एक अन्य गतिविधि के साथ एक्सेस किया जा सकता है, तो एक्शनबार में अप बटन दबाकर इसे स्वचालित संक्रमण को कॉन्फ़िगर करने के लिए समझ में आता है। ऐसा करना बहुत सरल है: वांछित गतिविधि के लिए मैनिफ़ेस्ट फ़ाइल में लाइनें जोड़ें:

 <application ... > <activity android:name="com.you. app.MainActivity" ...> //  Activity ... </activity> ... <activity android:name="com.you. app.DetailsActivity" android:label="@string/title_activity_display_message" android:parentActivityName="com.example.myfirstapp.MainActivity" > // API 16+ <meta-data android:name="android.support.PARENT_ACTIVITY" //  Support Library API 7+ android:value="com.you. app.MainActivity" /> </activity> </application> 

आपको याद दिला दूं कि होम बटन अप की तरह काम करता है, SupportActionBar setHomeButtonEnabled (true) और setDisplayHomeAsUpEnabled (ट्रू) विधियों को कॉल करें।



सारी जानकारी यहाँ से ली गई है (आधिकारिक गाइड अंग्रेजी में)।

भाग 1 - एक परियोजना के लिए एक समर्थन पुस्तकालय जोड़ना, सरल उदाहरण, खोज
भाग 2 - टैब और ड्रॉप-डाउन सूची के साथ नेविगेट करना