Ressource für Liste der Farbstatus
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Ein ColorStateList
ist ein Objekt, das Sie in XML definieren und als Farbe anwenden können, die je nach
Status des View
-Objekts, in dem es sich befindet
auf die sie angewendet wird. Beispiel: Button
Widget kann einen von mehreren Status haben: "gedrückt", "fokussiert" oder keiner von beiden. Mithilfe einer Farbstatusliste
können Sie für jeden Bundesstaat
eine andere Farbe festlegen.
Sie beschreiben die Liste der Bundesstaaten in einer XML-Datei. Jede Farbe wird in einem <item>
-Element innerhalb eines einzelnen <selector>
-Elements definiert. Jeweils <item>
verwendet verschiedene Attribute, um den Zustand, in dem sie verwendet wird, zu beschreiben.
Bei jeder Statusänderung wird die Statusliste von oben nach unten durchlaufen. Das erste Element, das
mit dem aktuellen Status übereinstimmt. Die Auswahl basiert nicht auf der „besten“ Variante.
sondern das erste Element, das die Mindestkriterien für den Bundesstaat erfüllt.
Hinweis:Wenn Sie eine statische Farbressource bereitstellen möchten, verwenden Sie ein Objekt
einfachen Wert für color.
- Dateispeicherort:
res/color/filename.xml
Der Dateiname wird als Ressourcen-ID verwendet.
- Datentyp der kompilierten Ressource:
- Ressourcenzeiger auf ein
ColorStateList
- Ressourcenreferenz:
-
In Java:
R.color.filename
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"
<item>
- Definiert eine Farbe, die bei bestimmten Zuständen verwendet werden soll, wie durch ihre Attribute beschrieben. Es ist ein
einem
<selector>
-Element untergeordnet ist.
Attribute:
android:color
- Hexadeximale Farbe. Erforderlich. Die Farbe wird mit einem
RGB-Wert und optionaler Alphakanal.
Der Wert beginnt immer mit einem Rautezeichen (#
), gefolgt vom
Alpha-Rot-Grün-Blau-Informationen in einem der folgenden Formate:
- RGB
- ARGB
- RRGGBB
- #AARRGGBB
android:lStar
- Gleitkomma. Optional. Mit diesem Attribut wird die Wahrnehmung der Leuchtdichte der Grundfarbe geändert. Dazu ist entweder eine
ein Gleitkommawert zwischen 0 und 100 oder ein Themenattribut, das als solches aufgelöst wird. Das Element
Die Gesamtfarbe wird berechnet, indem die Grundfarbe in einen barrierefreien Farbraum konvertiert wird.
und sein L* auf den im Attribut
lStar
angegebenen Wert setzen.
Beispiel: android:lStar="50"
android:state_pressed
- Boolescher Wert.
"true"
, wenn dieses Element verwendet wird, wenn auf das Objekt getippt wird, beispielsweise wenn eine Schaltfläche
die berührt oder angeklickt werden. Es ist "false"
, wenn dieses Element im Standardstatus verwendet wird, also nicht angetippt wird.
android:state_focused
- Boolescher Wert.
"true"
, wenn dieses Element verwendet wird, wenn das Objekt fokussiert ist, beispielsweise wenn eine Schaltfläche
mit dem Trackball oder dem Steuerkreuz hervorgehoben. Es ist "false"
, wenn dieses Element im Standard verwendet wird,
nicht fokussiert sein.
android:state_selected
- Boolescher Wert.
"true"
, wenn dieses Element bei der Auswahl des Objekts verwendet wird, beispielsweise wenn ein
Tab geöffnet. Es ist "false"
, wenn dieses Element verwendet wird, obwohl das Objekt nicht ausgewählt ist.
android:state_checkable
- Boolescher Wert.
"true"
, wenn dieses Element verwendet wird, wenn das Objekt überprüfbar ist. Es ist "false"
, wenn
item wird verwendet, wenn das Objekt nicht überprüfbar ist. Nur nützlich, wenn das Objekt
zwischen einem prüfbaren und einem nicht prüfbaren Widget.
android:state_checked
- Boolescher Wert.
"true"
, wenn dieses Element verwendet wird, wenn das Objekt geprüft wird. Es ist "false"
, wenn
wird verwendet, wenn die Auswahl des Objekts aufgehoben wird.
android:state_enabled
- Boolescher Wert.
"true"
, wenn dieses Element verwendet wird, wenn das Objekt aktiviert ist, das Folgendes kann:
Touch- oder Click-Events empfangen. Der Wert "false"
, wenn er verwendet wird, wenn das Objekt deaktiviert ist.
android:state_window_focused
- Boolescher Wert.
"true"
, wenn dieses Element verwendet wird, wenn das Anwendungsfenster im Fokus ist,
Das bedeutet:
im Vordergrund ausgeführt wird. Es ist "false"
, wenn dieses Element während der Anwendung verwendet wird
nicht im Fokus, z. B. wenn die Benachrichtigungsleiste heruntergezogen oder ein Dialogfeld angezeigt wird.
Hinweis:Der erste Punkt in der Liste der Bundesstaaten,
mit dem aktuellen Status des Objekts übereinstimmt. Wenn also das erste Element in der Liste
keines der vorangehenden Statusattribute, wird es jedes Mal angewendet. Aus diesem Grund sollten Sie
haben, 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>
Die folgende Layout-XML wendet die Farbliste auf ein View
an:
<Button
android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:text="@string/button_text"
android:textColor="@color/button_text" />
- Siehe auch:
-
Alle Inhalte und Codebeispiele auf dieser Seite unterliegen den Lizenzen wie im Abschnitt Inhaltslizenz beschrieben. Java und OpenJDK sind Marken oder eingetragene Marken von Oracle und/oder seinen Tochtergesellschaften.
Zuletzt aktualisiert: 2024-09-20 (UTC).
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"Benötigte Informationen nicht gefunden"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"Zu umständlich/zu viele Schritte"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"Nicht mehr aktuell"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"Problem mit der Übersetzung"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"Problem mit Beispielen/Code"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Sonstiges"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Leicht verständlich"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"Mein Problem wurde gelöst"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Sonstiges"
}]
{"lastModified": "Zuletzt aktualisiert: 2024-09-20\u00a0(UTC)."}
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2024-09-20 (UTC)."]]