Ressource für Liste der Farbstatus

Ein ColorStateList ist ein Objekt, das Sie in XML definieren und als Farbe anwenden können. Die Farbe ändert sich je nach Status des View-Objekts, auf das es angewendet wird. Ein Button-Widget kann beispielsweise einen von mehreren Status haben: gedrückt, fokussiert oder keines von beiden. Mit einer Farbstatusliste können Sie für jeden Status eine andere Farbe angeben.

Sie beschreiben die Statusliste in einer XML-Datei. Jede Farbe wird in einem <item>-Element innerhalb eines einzelnen <selector>-Elements definiert. Jeder <item> verwendet verschiedene Attribute, um den Status zu beschreiben, in dem er verwendet wird.

Bei jeder Statusänderung wird die Statusliste von oben nach unten durchlaufen und das erste Element, das dem aktuellen Status entspricht, wird verwendet. Die Auswahl basiert nicht auf der „besten“ Übereinstimmung, sondern auf dem ersten Element, das die Mindestkriterien des Status erfüllt.

Hinweis: Wenn Sie eine statische Farbressource bereitstellen möchten, verwenden Sie einen einfachen Farbwert.

Dateispeicherort:
res/color/filename.xml
Der Dateiname wird als Ressourcen-ID verwendet.
Kompilierter Ressourcendatentyp:
Ressourcenzeiger auf eine ColorStateList
Ressourcenreferenz:
In Java: R.color.filename
In XML: @[package:]color/filename
Syntax:
<?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>
Elemente:
<selector>
Erforderlich. Dies ist das Stammelement. Enthält ein oder mehrere <item>-Elemente.

Attribute:

xmlns:android
String. Erforderlich. Definiert den XML-Namespace, der "http://schemas.android.com/apk/res/android" lautet.
<item>
Definiert eine Farbe, die in bestimmten Zuständen verwendet werden soll, wie in den Attributen beschrieben. Es ist ein untergeordnetes Element eines <selector>-Elements.

Attribute:

android:color
Hexadezimaler Farbcode. Erforderlich. Die Farbe wird mit einem RGB-Wert und einem optionalen Alphakanal angegeben.

Der Wert beginnt immer mit einem Rautezeichen (#), gefolgt von den Alpha-Rot-Grün-Blau-Informationen in einem der folgenden Formate:

  • #RGB
  • #ARGB
  • #RRGGBB
  • #AARRGGBB
android:lStar
Gleitkommazahl. Optional: Dieses Attribut ändert die wahrgenommene Luminanz der Grundfarbe. Es wird entweder ein Gleitkommawert zwischen 0 und 100 oder ein Designattribut verwendet, das als solcher aufgelöst wird. Die Gesamtfarbe des Elements wird berechnet, indem die Grundfarbe in einen barrierefreien Farbraum konvertiert und der L*-Wert auf den im Attribut lStar angegebenen Wert gesetzt wird.

Beispiel: android:lStar="50"

android:state_pressed
Boolesch. "true", wenn dieses Element verwendet wird, wenn das Objekt angetippt wird, z. B. wenn eine Schaltfläche berührt oder angeklickt wird. Der Wert ist "false", wenn dieses Element im standardmäßigen, nicht angetippten Zustand verwendet wird.
android:state_focused
Boolesch. "true", wenn dieses Element verwendet wird, wenn das Objekt fokussiert ist, z. B. wenn eine Schaltfläche mit dem Trackball oder Steuerkreuz hervorgehoben wird. Der Wert ist "false", wenn dieses Element im standardmäßigen, nicht fokussierten Zustand verwendet wird.
android:state_selected
Boolesch. "true", wenn dieses Element verwendet wird, wenn das Objekt ausgewählt wird, z. B. wenn ein Tab geöffnet wird. Der Wert ist "false", wenn dieses Element verwendet wird, wenn das Objekt nicht ausgewählt ist.
android:state_checkable
Boolesch. "true", wenn dieses Element verwendet wird, wenn das Objekt auswählbar ist. Der Wert ist "false", wenn dieses Element verwendet wird, wenn das Objekt nicht auswählbar ist. Nur nützlich, wenn das Objekt zwischen einem auswählbaren und einem nicht auswählbaren Widget wechseln kann.
android:state_checked
Boolesch. "true", wenn dieses Element verwendet wird, wenn das Objekt geprüft wird. Der Wert ist "false", wenn er verwendet wird, wenn die Auswahl des Objekts aufgehoben wird.
android:state_enabled
Boolesch. "true", wenn dieses Element verwendet wird, wenn das Objekt aktiviert ist und Berührungs- oder Klickereignisse empfangen kann. Der Wert ist "false", wenn das Objekt deaktiviert ist.
android:state_window_focused
Boolesch. "true", wenn dieses Element verwendet wird, wenn das Anwendungsfenster im Fokus ist, d. h. die Anwendung im Vordergrund ist. Der Wert ist "false", wenn dieses Element verwendet wird, während das Anwendungsfenster nicht im Fokus ist, z. B. wenn die Benachrichtigungsleiste heruntergezogen wird oder ein Dialogfeld angezeigt wird.

Hinweis: Es wird das erste Element in der Statusliste angewendet, das mit dem aktuellen Status des Objekts übereinstimmt. Wenn das erste Element in der Liste also keines der vorherigen Statusattribute enthält, wird es immer angewendet. Platzieren Sie den Standardwert daher an letzter Stelle, wie im folgenden Beispiel gezeigt.

Beispiel:
XML-Datei gespeichert unter res/color/button_text.xml:
<?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>

In der folgenden Layout-XML wird die Farbliste auf ein View angewendet:

<Button
    android:layout_width="fill_parent"
    android:layout_height="wrap_content"
    android:text="@string/button_text"
    android:textColor="@color/button_text" />
Siehe auch: