प्राथमिकता वाले कॉम्पोनेंट और एट्रिब्यूट 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"