प्राथमिकता वाले कॉम्पोनेंट और एट्रिब्यूट Android Jetpack का हिस्सा है.

इस विषय में, सबसे ज़्यादा इस्तेमाल होने वाले Preference कॉम्पोनेंट के बारे में बताया गया है. एट्रिब्यूट इस्तेमाल करती हैं.

प्राथमिकता के कॉम्पोनेंट

इस सेक्शन में, सामान्य Preference कॉम्पोनेंट के बारे में बताया गया है. ज़्यादा जानकारी के लिए, यह देखें हर कॉम्पोनेंट से जुड़े रेफ़रंस पेज.

प्राथमिकता इन्फ़्रास्ट्रक्चर

PreferenceFragmentCompat से Fragment, जो Preference ऑब्जेक्ट का इंटरैक्टिव पदानुक्रम दिखा रहा है.

प्राथमिकता कंटेनर

PreferenceScreen से टॉप-लेवल कंटेनर, जो सेटिंग स्क्रीन दिखाता है. यह रूट है ये कॉम्पोनेंट आपके Preference की हैरारकी का कॉम्पोनेंट इस्तेमाल करते हैं.

PreferenceCategory से एक कंटेनर, जिसका इस्तेमाल मिलते-जुलते Preferences का ग्रुप बनाने के लिए किया जाता है. PreferenceCategory कैटगरी का टाइटल दिखाता है और Preferences के ग्रुप को विज़ुअल तौर पर अलग करता है.

व्यक्तिगत प्राथमिकताएं

Preference - बुनियादी जानकारी बिल्डिंग ब्लॉक शामिल है, जो किसी सेटिंग को दिखाता है. अगर Preference सेट है बनाए रखने के लिए, उसमें संबंधित की-वैल्यू पेयर होता है, जो उपयोगकर्ता की पसंद होता है जिसे ऐप्लिकेशन में कहीं से भी ऐक्सेस किया जा सकता है.

EditTextPreference से Preference, जिसकी वैल्यू String में बनी रहती है. उपयोगकर्ता Preference पर टैप कर सकते हैं एक डायलॉग लॉन्च करने के लिए, जिसमें टेक्स्ट फ़ील्ड शामिल हो, जो उपयोगकर्ता को स्थायी वैल्यू.

ListPreference - Preference जिसमें स्ट्रिंग वैल्यू बनी रहती है. उपयोगकर्ता इस वैल्यू को यहां जाकर बदल सकते हैं: यह डायलॉग बॉक्स, जिसमें उनसे जुड़े लेबल के साथ रेडियो बटन की सूची होती है.

MultiSelectListPreference से एक Preference जो स्ट्रिंग का सेट बना रहता है. लोग यहां जाकर इन वैल्यू को बदल सकते हैं ऐसा डायलॉग जिसमें चेकबॉक्स की सूची होती है. इस सूची में उनसे जुड़े लेबल होते हैं.

SeekBarPreference से Preference, जिसकी वैल्यू हमेशा पूर्णांक में बनी रहती है. इस वैल्यू को इनके ज़रिए बदला जा सकता है: Preference लेआउट में दिखने वाले सीकबार को खींचकर छोड़ना.

SwitchPreferenceCompat से Preference जिसकी बूलियन वैल्यू बनी रहती है. इस वैल्यू को इनके ज़रिए बदला जा सकता है: संबंधित स्विच विजेट के साथ इंटरैक्ट करके या Preference लेआउट.

CheckBoxPreference से Preference जिसकी बूलियन वैल्यू बनी रहती है. इस वैल्यू को इनके ज़रिए बदला जा सकता है: संबंधित चेकबॉक्स से इंटरैक्ट करके या Preference पर टैप करके लेआउट.

प्राथमिकता विशेषताएं

सबसे ज़्यादा इस्तेमाल होने वाले एट्रिब्यूट की सूची नीचे दी गई है. ये एट्रिब्यूट, उन एट्रिब्यूट को कॉन्फ़िगर करते हैं Preference रंग और व्यवहार.

सामान्य एट्रिब्यूट

title

String वैल्यू, जो Preference.

उदाहरण: app:title="Title"

summary

String की वैल्यू, जो Preference को दिखाती है सारांश.

उदाहरण: app:summary="Summary"

icon

Preference को दिखाने वाला Drawable आइकन.

उदाहरण: app:icon="@drawable/ic_camera"

key

String वैल्यू, जो उस कुंजी के बारे में बताती है जिसका इस्तेमाल इन कामों के लिए किया जाता है इससे जुड़ी Preference के लिए वैल्यू बनी रहेगी. कुंजी की मदद से रनटाइम के दौरान, Preference को पसंद के मुताबिक बनाया जा सकता है. आपको अपने यहां हर Preference के लिए एक कुंजी सेट करनी चाहिए हैरारकी है.

उदाहरण: app:key="key"

enabled

यह एक बूलियन वैल्यू होती है. इससे पता चलता है कि उपयोगकर्ता Preference. जब यह वैल्यू false होती है, तो Preference धूसर दिखता है और उपयोगकर्ता इससे इंटरैक्ट नहीं कर सकते इसे. डिफ़ॉल्ट वैल्यू true है.

उदाहरण: app:enabled="false"

selectable

यह एक बूलियन वैल्यू होती है. इससे पता चलता है कि उपयोगकर्ता Preference. डिफ़ॉल्ट वैल्यू true है.

उदाहरण: app:selectable="false"

isPreferenceVisible

एक बूलियन वैल्यू, जो यह बताती है कि क्या Preference या Preference कैटगरी दिख रही है. यह कॉल करने के बराबर है setVisible().

उदाहरण: app:isPreferenceVisible="false"

defaultValue

Preference के लिए डिफ़ॉल्ट वैल्यू दिखाता है. यह मान है सेट और तब बनी रहती है, जब इसके लिए कोई अन्य वैल्यू नहीं होती Preference मिला. वैल्यू का टाइप, संबंधित वैल्यू पर निर्भर करता है Preference.

उदाहरण: app:defaultValue="true"

dependency

SwitchPreferenceCompat की कुंजी दिखाता है, जो कंट्रोल करती है इस Preference की स्थिति के हिसाब से. जब संबंधित स्विच बंद है. यह Preference बंद है और इसे नहीं किया जा सकता संशोधित किया जा सकता है.

उदाहरण: app:dependency="parent"

PreferenceCategory की विशेषताएं

initialExpandedChildrenCount

एक पूर्णांक वैल्यू, जो Preference को बड़ा करने की सुविधा चालू करती है व्यवहार. यह वैल्यू दिखाती है कि ज़्यादा से ज़्यादा कितने बच्चों को दिखाया जा सकता है PreferenceGroup. कोई भी अतिरिक्त चाइल्ड बच्चा छोटा हो जाता है और 'बड़ा करें' बटन पर टैप करके देखा जा सकता है. डिफ़ॉल्ट रूप से, यह मान है Integer.MAX_VALUE और सभी बच्चे दिखाए गए हैं.

चेतावनी: पक्का करें कि आपने PreferenceCategory का इस्तेमाल करें, ताकि राज्य कॉन्फ़िगरेशन के बदलने (जैसे कि घुमाते समय इसका ध्यान रखें).

उदाहरण: app:initialExpandedChildrenCount="0"

ListPreference / MultiSelectListPreference एट्रिब्यूट

entries

स्ट्रिंग का कलेक्शन, जो दिखाई जाने वाली सूची में मौजूद एंट्री के हिसाब से होता है उपयोगकर्ता को कोई परेशानी नहीं है. इनमें से हर एक वैल्यू, इंडेक्स के आधार पर जो अंदरूनी रूप से बने रहते हैं. उदाहरण के लिए, जब कोई उपयोगकर्ता पहली सूची प्रविष्टि, मानों की संबंधित श्रेणी में पहला एलीमेंट बना रहता है.

उदाहरण: app:entries="@array/entries"

चेतावनी: पक्का करें कि दोनों सरणियों की लंबाई और हर अरे के इंडेक्स, सही एंट्री / वैल्यू से मैच करते हैं जोड़ी.

entryValues

सेव की जाने वाली एंट्री का कलेक्शन. इनमें से हर एक वैल्यू इससे जुड़ी है इंडेक्स करना मुमकिन है.

उदाहरण: app:entryValues="@array/values"