Renk durumu listesi kaynağı

ColorStateList, XML'de tanımlayabileceğiniz ve uygulandığı View nesnesinin durumuna göre renkleri değiştiren bir renk olarak uygulayabileceğiniz bir nesnedir. Örneğin, bir Button widget'ı şu durumlardan birinde olabilir: basılı, odaklanmış veya hiçbiri. Renk durumu listesi kullanarak her durum için farklı bir renk sağlayabilirsiniz.

Durum listesini bir XML dosyasında tanımlarsınız. Her renk, tek bir <selector> öğesinin içindeki <item> öğesinde tanımlanır. Her <item>, kullanıldığı durumu açıklamak için çeşitli özellikler kullanır.

Her durum değişikliği sırasında durum listesi yukarıdan aşağıya doğru taranır ve mevcut durumla eşleşen ilk öğe kullanılır. Seçim, "en iyi" eşleşmeye göre değil, eyaletin minimum ölçütlerini karşılayan ilk öğeye göre yapılır.

Not: Statik bir renk kaynağı sağlamak istiyorsanız basit bir color değeri kullanın.

dosya konumu:
res/color/filename.xml
Dosya adı, kaynak kimliği olarak kullanılır.
derlenmiş kaynak veri türü:
ColorStateList için kaynak işaretçisi
kaynak referansı:
Java'da: R.color.filename
XML'de: @[package:]color/filename
söz dizimi:
<?xml version="1.0" encoding="utf-8"?>
<selector xmlns:android="http://schemas.android.com/apk/res/android" >
    <item
        android:color="hex_color"
        android:lStar="floating_point_value"
        android:state_pressed=["true" | "false"]
        android:state_focused=["true" | "false"]
        android:state_selected=["true" | "false"]
        android:state_checkable=["true" | "false"]
        android:state_checked=["true" | "false"]
        android:state_enabled=["true" | "false"]
        android:state_window_focused=["true" | "false"] />
</selector>
öğeler:
<selector>
Zorunlu. Bu, kök öğedir. Bir veya daha fazla <item> öğesi içerir.

Özellikler:

xmlns:android
Dize. Zorunlu. XML ad alanını tanımlar. Bu alan "http://schemas.android.com/apk/res/android" şeklindedir.
<item>
Özellikleri tarafından açıklandığı şekilde, belirli durumlarda kullanılacak bir renk tanımlar. <selector> öğesinin alt öğesidir.

Özellikler:

android:color
Onaltılık renk. Zorunludur. Renk, RGB değeri ve isteğe bağlı alfa kanalıyla belirtilir.

Değer her zaman bir diyez (#) karakteriyle başlar ve ardından aşağıdaki biçimlerden birinde Alfa-Kırmızı-Yeşil-Mavi bilgisi gelir:

  • #RGB
  • #ARGB
  • #RRGGBB
  • #AARRGGBB
android:lStar
Kayan nokta. İsteğe bağlı. Bu özellik, temel rengin algılanan parlaklığını değiştirir. 0 ile 100 arasında bir kayan nokta değeri veya bu şekilde çözümlenen bir tema özelliği alır. Öğenin genel rengi, temel rengi erişilebilirlik dostu bir renk alanına dönüştürerek ve L* değerini lStar özelliğinde belirtilen değere ayarlayarak hesaplanır.

Örnek: android:lStar="50"

android:state_pressed
Boole. "true": Bu öğe, nesneye dokunulduğunda (ör. bir düğmeye dokunulduğunda veya tıklandığında) kullanılır. Bu öğe varsayılan, dokunulmamış durumda kullanılıyorsa "false".
android:state_focused
Boole. "true": Bu öğe, nesneye odaklanıldığında (ör. bir düğme, izleme topu veya D-pad kullanılarak vurgulandığında) kullanılır. Bu öğe varsayılan, odaklanılmamış durumda kullanılıyorsa "false" değerini alır.
android:state_selected
Boole. "true": Bu öğe, nesne seçildiğinde (ör. bir sekme açıldığında) kullanılıyorsa. Nesne seçili değilken bu öğe kullanıldığında "false" olur.
android:state_checkable
Boole. "true": Bu öğe, nesne işaretlenebilir olduğunda kullanılır. Nesne işaretlenebilir olmadığında bu öğe kullanılırsa "false" olur. Yalnızca nesne, işaretlenebilir ve işaretlenemez bir widget arasında geçiş yapabiliyorsa kullanışlıdır.
android:state_checked
Boole. Nesne işaretlendiğinde bu öğe kullanılıyorsa "true". Nesnenin seçimi kaldırıldığında kullanılıyorsa "false" olur.
android:state_enabled
Boole. "true" Bu öğe, nesne etkinleştirildiğinde kullanılıyorsa dokunma veya tıklama etkinliklerini alabilir. Nesne devre dışı bırakıldığında kullanılırsa "false" olur.
android:state_window_focused
Boole. "true" Bu öğe, uygulama penceresi odaktayken (yani uygulama ön plandayken) kullanılıyorsa Bu öğe, uygulama penceresi odakta değilken (ör. bildirim gölgesi aşağı çekildiğinde veya bir iletişim kutusu göründüğünde) kullanılıyorsa "false" olur.

Not: Durum listesinde nesnenin mevcut durumuyla eşleşen ilk öğe uygulanır. Dolayısıyla, listedeki ilk öğe önceki durum özelliklerinden hiçbirini içermiyorsa her zaman uygulanır. Bu nedenle, varsayılan değerinizi aşağıdaki örnekte gösterildiği gibi en sona yerleştirin.

örnek:
XML dosyası res/color/button_text.xml konumuna kaydedildi:
<?xml version="1.0" encoding="utf-8"?>
<selector xmlns:android="http://schemas.android.com/apk/res/android">
    <item android:state_pressed="true"
          android:color="#ffff0000"/> <!-- pressed -->
    <item android:state_focused="true"
          android:color="#ff0000ff"/> <!-- focused -->
    <item android:color="#ff000000"/> <!-- default -->
</selector>

Aşağıdaki düzen XML'i, renk listesini bir View öğesine uygular:

<Button
    android:layout_width="fill_parent"
    android:layout_height="wrap_content"
    android:text="@string/button_text"
    android:textColor="@color/button_text" />
Ayrıca bkz: