RenkYapılandırması

ColorConfiguration, kullanıcıya kadran öğelerinin rengini kadran düzenleyicisini kullanarak değiştirme seçeneği sunar.

Bir ColorConfiguration tanımlandığında tintColor gibi başka bir öğenin renge dayalı herhangi bir özelliği, ColorConfiguration ve ColorOption kimlik değerlerini kullanan bir ifade kullanarak yapılandırmadaki bir renge başvurabilir. Tam bir tanıtım için örneğe bakın.

Wear OS 4'te kullanıma sunuldu.

Sözdizimi

<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>

Örnek

Aşağıdaki renk yapılandırmasının themeColor kimlik değerine sahip olduğunu varsayalım:

<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>

Bu yapılandırma, her biri üç renk içeren dört palet seçeneğini temsil eder.

colors özelliği yalnızca tek bir değer içeriyorsa temaya aşağıdaki gibi başvurun (örneğin, tintColor ayarlamak için):

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

colors özelliği birden fazla değer içeren bir palet içeriyorsa dizine aşağıdaki örnekte gösterildiği gibi referans verin. Ayrıntılı olarak bu örnekte, seçilen ColorOption içindeki ikinci rengin seçilmesi gösterilmektedir:

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

Özellikler

ColorConfiguration öğesi aşağıdaki özelliklere sahiptir:

Gerekli özellikler

Aşağıdaki özellikler gereklidir:

id

Yapılandırma değeri için benzersiz bir tanımlayıcı.

displayName

Kadran düzenleyicide gösterilen metne karşılık gelen bir kaynak kimliği.

defaultValue

Kullanıcı, kadran düzenleyicideki yapılandırmayı açıkça değiştirmezse varsayılan yapılandırma değeri kullanılır. Bu, iç ColorOption öğelerinden birinin id değerine ayarlanmalıdır.

İsteğe bağlı özellikler

Aşağıdaki özellikler isteğe bağlıdır:

icon

Kadran düzenleyicide gösterilen çekilebilir kaynağa karşılık gelen kaynak kimliği. Maksimum 400x400 piksel boyutunda olmalıdır.

screenReaderText

Kullanıcı TalkBack'i etkinleştirmişse kullanılan metne karşılık gelen bir kaynak kimliği.

İç öğeler

ColorConfiguration öğesi, 1 ile 100 arasında iç ColorOption öğe içerebilir.

ColorOption Özellikleri

ColorOption öğesi aşağıdaki özellikleri içermelidir:

id

Seçenek değeri için benzersiz bir tanımlayıcı.

displayName

Kadran düzenleyicide gösterilen metne karşılık gelen bir kaynak kimliği.

ColorOption öğesi aşağıdaki özelliklerden birini içermelidir:

colors

ARGB renk değerlerinin boşlukla ayrılmış listesi.

ColorOption öğesi isteğe bağlı olarak aşağıdaki özellikleri içerebilir:

icon

Kadran düzenleyicide gösterilen çekilebilir kaynağa karşılık gelen bir kaynak kimliği.

screenReaderText

Kullanıcı TalkBack'i etkinleştirmişse kullanılan metne karşılık gelen bir kaynak kimliği.