कलर कॉन्फ़िगरेशन

ColorConfiguration, उपयोगकर्ता को एलिमेंट का रंग बदलने का विकल्प देता है होम स्क्रीन पर दिखेगी.

जब ColorConfiguration तय किया जाता है, तो किसी दूसरे एट्रिब्यूट का रंग पर आधारित एट्रिब्यूट tintColor जैसे एलिमेंट, कॉन्फ़िगरेशन में दिए गए रंग की जानकारी दे सकते हैं ऐसे एक्सप्रेशन का इस्तेमाल करना जो ColorConfiguration और ColorOption. पूरी जानकारी पाने के लिए, उदाहरण देखें.

Wear OS 4 में पेश किया गया.

वाक्य-विन्यास

<ColorConfiguration id="string" displayName="string" icon="string"
                    screenReaderText="string" defaultValue="string">
  <ColorOption id="string" displayName="string" screenReaderText="string"
               icon="string" colors="argb-color-list" />
  ...
</ColorConfiguration>

उदाहरण

मान लीजिए कि नीचे दी गई रंग कॉन्फ़िगरेशन, जिसकी आईडी मान themeColor की परिभाषा:

<ColorConfiguration id="themeColor" defaultValue="0"
                    displayName="color_selector_display_name">
    <ColorOption id="0" displayName="color_theme_0" colors="#ff000000 #ff888888 #ffffffff"/>
    <ColorOption id="1" displayName="color_theme_1" colors="#ffff0000 #ffff8800 #ffffff00"/>
    <ColorOption id="2" displayName="color_theme_2" colors="#ff00ff00 #ff00ff88 #ff00ffff"/>
    <ColorOption id="3" displayName="color_theme_3" colors="#ff0000ff #ff8800ff #ffff00ff"/>
</ColorConfiguration>

यह कॉन्फ़िगरेशन चार पैलेट में से कोई भी विकल्प दिखाता है, जिनमें से हर एक में शामिल है तीन रंग.

अगर colors एट्रिब्यूट में सिर्फ़ एक वैल्यू है, तो थीम का रेफ़रंस दें उदाहरण के लिए, tintColor सेट करने के लिए नीचे दिया गया तरीका अपनाएं:

<PartText ... tintColor="[CONFIGURATION.themeColor]">

अगर colors एट्रिब्यूट में एक से ज़्यादा वैल्यू के पैलेट शामिल है, तो का संदर्भ लें, जैसा कि नीचे दिए गए उदाहरण में दिखाया गया है. खास तौर पर यह उदाहरण में, चुने गए ColorOption में दूसरा रंग चुनने का तरीका दिखाया गया है:

<PartText ... tintColor="[CONFIGURATION.themeColor.1]">

विशेषताएं

ColorConfiguration एलिमेंट में ये एट्रिब्यूट मौजूद हैं:

ज़रूरी एट्रिब्यूट

यहां दिए गए एट्रिब्यूट ज़रूरी हैं:

id
कॉन्फ़िगरेशन वैल्यू के लिए यूनीक आइडेंटिफ़ायर.
displayName
स्मार्टवॉच में दिखाए गए टेक्स्ट से जुड़ा रिसॉर्स आईडी फ़ेस एडिटर का इस्तेमाल करें.
defaultValue
अगर उपयोगकर्ता साफ़ तौर पर कोई बदलाव नहीं करता है, तो इस्तेमाल के लिए डिफ़ॉल्ट कॉन्फ़िगरेशन मान कॉन्फ़िगरेशन को कस्टमाइज़ किया जा सकता है. इसे इसकी id पर सेट किया जाना चाहिए ColorOption एलिमेंट में से किसी एक एलिमेंट का इस्तेमाल करें.

ऐसे एट्रिब्यूट जो ज़रूरी नहीं हैं

ये एट्रिब्यूट ज़रूरी नहीं हैं:

icon
ड्रॉ किए जा सकने वाले संसाधन का संसाधन आईडी, जो आज़माएं. इसका साइज़ ज़्यादा से ज़्यादा 400x400 पिक्सल होना चाहिए.
screenReaderText
टेक्स्ट से जुड़ा संसाधन आईडी. इसका इस्तेमाल तब किया जाता है, जब उपयोगकर्ता के पास TalkBack की सुविधा चालू है.

इनर एलिमेंट

ColorConfiguration एलिमेंट में 1 से 100 के बीच का अंदरूनी हिस्सा हो सकता है ColorOption एलिमेंट.

ColorOption एट्रिब्यूट

ColorOption एलिमेंट में ये एट्रिब्यूट होने चाहिए:

id
विकल्प की वैल्यू के लिए यूनीक आइडेंटिफ़ायर.
displayName
स्मार्टवॉच में दिखाए गए टेक्स्ट से जुड़ा रिसॉर्स आईडी फ़ेस एडिटर.

ColorOption एलिमेंट में, इनमें से कोई एक एट्रिब्यूट होना ज़रूरी है:

colors
ARGB रंग मानों की स्पेस से अलग की गई सूची.

ColorOption एलिमेंट में ये विकल्प हो सकते हैं विशेषताएं:

icon
ड्रॉ किए जा सकने वाले संसाधन का संसाधन आईडी, जो तो आपको होम स्क्रीन एडिटर का इस्तेमाल करना होगा.
screenReaderText
टेक्स्ट से जुड़ा संसाधन आईडी. इसका इस्तेमाल तब किया जाता है, जब उपयोगकर्ता के पास TalkBack की सुविधा चालू है.