ColorStateList Klasse

Referenz

Definition

Namespace:: Android.Content.Res

Assembly:: Mono.Android.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ermöglicht das Zuordnen von android.view.View Zustandssätzen zu Farben.

[Android.Runtime.Register("android/content/res/ColorStateList", DoNotGenerateAcw=true)]
public class ColorStateList : Java.Lang.Object, Android.OS.IParcelable, IDisposable, Java.Interop.IJavaPeerable

[<Android.Runtime.Register("android/content/res/ColorStateList", DoNotGenerateAcw=true)>]
type ColorStateList = class
    inherit Object
    interface IParcelable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

Vererbung: Object

Object
ColorStateList

Attribute: RegisterAttribute

Implementiert: IParcelable IJavaObject IJavaPeerable IDisposable

Hinweise

Ermöglicht das Zuordnen von android.view.View Zustandssätzen zu Farben.

android.content.res.ColorStateLists werden aus XML-Ressourcendateien erstellt, die im Unterverzeichnis "color" des Ressourcenverzeichnisses einer Anwendung definiert sind. Die XML-Datei enthält ein einzelnes "Selektor"-Element mit einer Reihe von Elementelementen. Beispiel:

&lt;selector xmlns:android="http://schemas.android.com/apk/res/android"&gt;
              &lt;item android:state_focused="true"
                      android:color="@color/sample_focused" /&gt;
              &lt;item android:state_pressed="true"
                      android:state_enabled="false"
                      android:color="@color/sample_disabled_pressed" /&gt;
              &lt;item android:state_enabled="false"
                      android:color="@color/sample_disabled_not_pressed" /&gt;
              &lt;item android:color="@color/sample_default" /&gt;
            &lt;/selector&gt;

Dadurch wird eine Reihe von Zustandsspezifikations-/Farbpaaren definiert, bei denen jede Zustandsspezifikation einen Satz von Zuständen angibt, in denen sich eine Ansicht befinden muss oder nicht, und die Farbe gibt die Farbe an, die dieser Spezifikation zugeordnet ist.

"StateSpec"><h3>State specs</h3>

Jedes Element definiert einen Satz von Zustandsspezifikations- und Farbpaaren, wobei die Zustandsspezifikation eine Reihe von Attributen ist, die entweder true oder als Ein- oder false Ausschluss festgelegt sind. Wenn ein Attribut für ein Element nicht angegeben wird, kann es sich um einen beliebigen Wert handelt.

Beispielsweise wird das folgende Element bei jedem Festlegen des fokussierten Zustands abgeglichen: alle anderen Zustände können festgelegt oder deaktiviert werden:

&lt;item android:state_focused="true"
                    android:color="@color/sample_focused" /&gt;

In der Regel verweist eine Farbstatusliste auf vom Framework definierte Zustandsattribute wie android.R.attr#state_focused android:state_focused oder android.R.attr#state_enabled android:state_enabled. Es können jedoch auch app-definierte Attribute verwendet werden.

<strong>Hinweis:</strong> Die Liste der Statusspezifikationen wird in der Reihenfolge abgeglichen, die in der XML-Datei angezeigt wird. Aus diesem Grund sollten spezifischere Elemente früher in der Datei platziert werden. Ein Element ohne Zustandsspezifikation wird als Übereinstimmung mit einem beliebigen Satz von Zuständen betrachtet und ist im Allgemeinen als endgültiges Element nützlich, das als Standard verwendet werden kann.

Wenn ein Element ohne Zustandsspezifikation vor anderen Elementen platziert wird, werden diese Elemente ignoriert.

"ItemAttributes"><h3>Elementattribute</h3>

Jedes Element muss ein android.R.attr#color android:color Attribut definieren, bei dem es sich um eine HEX-Farbe im HTML-Stil, einen Verweis auf eine Farbressource oder - in API 23 und höher - um ein Designattribut handelt, das in eine Farbe aufgelöst wird.

Ab API 23 können Elemente optional ein android.R.attr#alpha android:alpha Attribut definieren, um die Deckkraft der Basisfarbe zu ändern. Dieses Attribut akzeptiert entweder einen Gleitkommawert zwischen 0 und 1 oder ein Designattribute, das als solches aufgelöst wird. Die Gesamtfarbe des Elements wird berechnet, indem mit dem Alphakanal der Basisfarbe mit dem alpha Wert multipliziert wird. Das folgende Element stellt beispielsweise die Akzentfarbe des Designs mit einer Deckkraft von 50 % dar:

&lt;item android:state_enabled="false"
                    android:color="?android:attr/colorAccent"
                    android:alpha="0.5" /&gt;

Ab API 31 können Elemente optional ein android.R.attr#lStar android:lStar Attribut definieren, um die Wahrnehmungsstärke der Basisfarbe zu ändern. Dieses Attribut akzeptiert entweder einen Gleitkommawert zwischen 0 und 100 oder ein Designattribute, das als solches aufgelöst wird. Die Gesamtfarbe des Elements wird berechnet, indem die Basisfarbe in einen barrierefreien Farbraum konvertiert und L* auf den im lStar Attribut angegebenen Wert festgelegt wird. Das folgende Element stellt beispielsweise die Akzentfarbe des Designs mit einer Wahrnehmungshelligkeit von 50 % dar:

&lt;item android:state_enabled="false"
                    android:color="?android:attr/colorAccent"
                    android:lStar="50" /&gt;

"DeveloperGuide"><h3>Entwicklerhandbuch</h3>

Weitere Informationen finden Sie im Leitfaden zur Ressourcenliste für Farbzustandslisten.

Java-Dokumentation für android.content.res.ColorStateList.

Teile dieser Seite sind Änderungen, die auf Arbeiten basieren, die vom Android Open Source Project erstellt und freigegeben wurden und gemäß den In der Attribution License beschriebenen Begriffen verwendet werden.

Konstruktoren

ColorStateList(Int32[][], Int32[])	Erstellt eine ColorStateList, die die angegebene Zuordnung von Zuständen zu Farben zurückgibt.
ColorStateList(IntPtr, JniHandleOwnership)	Ein Konstruktor, der beim Erstellen verwalteter Darstellungen von JNI-Objekten verwendet wird; wird von der Runtime aufgerufen.

Eigenschaften

ChangingConfigurations	Gibt eine Maske der Konfigurationsparameter zurück, für die sich diese Farbstatusliste ändern kann, sodass sie erneut erstellt werden muss.
Class	Gibt die Laufzeitklasse dieses `Object`zurück. (Geerbt von Object)
Creator
DefaultColor	Gibt die Standardfarbe in diesem `ColorStateList`zurück.
Handle	Das Handle zum zugrunde liegenden Android-instance. (Geerbt von Object)
IsOpaque	Gibt an, ob diese Farbstatusliste undurchsichtig ist, was bedeutet, dass jede von `#getColorForState(int[], int)` zurückgegebene Farbe den Alphawert 255 aufweist.
IsStateful	Gibt an, ob diese Farbstatusliste mindestens eine Zustandsspezifikation enthält und die erste Spezifikation nicht leer ist (z.
JniIdentityHashCode	Ermöglicht das Zuordnen von `android.view.View` Zustandssätzen zu Farben. (Geerbt von Object)
JniPeerMembers	Ermöglicht das Zuordnen von `android.view.View` Zustandssätzen zu Farben.
PeerReference	Ermöglicht das Zuordnen von `android.view.View` Zustandssätzen zu Farben. (Geerbt von Object)
ThresholdClass	Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen.
ThresholdType	Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen.

Methoden

Clone()	Erstellt und gibt eine Kopie dieses Objekts zurück. (Geerbt von Object)
CreateFromXml(Resources, XmlReader)	Erstellt eine ColorStateList aus einem XML-Dokument.
CreateFromXml(Resources, XmlReader, Resources+Theme)	Erstellt eine ColorStateList aus einem XML-Dokument.
DescribeContents()	Beschreiben Sie die Arten von speziellen Objekten, die in der Marshalldarstellung dieses Parcelable enthalten sind.
Dispose()	Ermöglicht das Zuordnen von `android.view.View` Zustandssätzen zu Farben. (Geerbt von Object)
Dispose(Boolean)	Ermöglicht das Zuordnen von `android.view.View` Zustandssätzen zu Farben. (Geerbt von Object)
Equals(Object)	Gibt an, ob ein anderes Objekt diesem "gleich" ist. (Geerbt von Object)
GetColorForState(Int32[], Color)	Gibt die Farbe zurück, die dem angegebenen Statussatz `android.view.View` zugeordnet ist.
GetHashCode()	Gibt einen Hashcodewert für das Objekt zurück. (Geerbt von Object)
JavaFinalize()	Wird vom Garbage Collector für ein Objekt aufgerufen, wenn die Garbage Collection feststellt, dass keine Verweise mehr auf das Objekt vorhanden sind. (Geerbt von Object)
Notify()	Aktiviert einen einzelnen Thread, der auf dem Monitor dieses Objekts wartet. (Geerbt von Object)
NotifyAll()	Aktiviert alle Threads, die auf dem Monitor dieses Objekts warten. (Geerbt von Object)
SetHandle(IntPtr, JniHandleOwnership)	Legt die Handle-Eigenschaft fest. (Geerbt von Object)
ToArray<T>()	Ermöglicht das Zuordnen von `android.view.View` Zustandssätzen zu Farben. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolgendarstellung des Objekts zurück. (Geerbt von Object)
UnregisterFromRuntime()	Ermöglicht das Zuordnen von `android.view.View` Zustandssätzen zu Farben. (Geerbt von Object)
ValueOf(Color)
Wait()	Bewirkt, dass der aktuelle Thread wartet, bis er aktiviert wird, in der Regel durch em benachrichtigen/em> oder <em>interrupted</em>.<>< (Geerbt von Object)
Wait(Int64)	Bewirkt, dass der aktuelle Thread wartet, bis er aktiviert wird, in der Regel, indem <er>benachrichtigt</em> oder <em>interrupted</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object)
Wait(Int64, Int32)	Bewirkt, dass der aktuelle Thread wartet, bis er aktiviert wird, in der Regel, indem <er>benachrichtigt</em> oder <em>interrupted</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object)
WithAlpha(Int32)	Erstellt eine neue ColorStateList mit den gleichen Zuständen und Farben wie diese, wobei jede Farbe jedoch den angegebenen Alphawert (0-255) aufweist.
WithLStar(Single)	Erstellt eine neue ColorStateList mit den gleichen Zuständen und Farben wie diese, wobei jede Farbe jedoch den angegebenen Wert für die wahrgenommene Leuchtkraft (0-100) aufweist.
WriteToParcel(Parcel, ParcelableWriteFlags)	Flachen Sie dieses Objekt in ein Paket ein.

Explizite Schnittstellenimplementierungen

IJavaPeerable.Disposed()	Ermöglicht das Zuordnen von `android.view.View` Zustandssätzen zu Farben. (Geerbt von Object)
IJavaPeerable.DisposeUnlessReferenced()	Ermöglicht das Zuordnen von `android.view.View` Zustandssätzen zu Farben. (Geerbt von Object)
IJavaPeerable.Finalized()	Ermöglicht das Zuordnen von `android.view.View` Zustandssätzen zu Farben. (Geerbt von Object)
IJavaPeerable.JniManagedPeerState	Ermöglicht das Zuordnen von `android.view.View` Zustandssätzen zu Farben. (Geerbt von Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Ermöglicht das Zuordnen von `android.view.View` Zustandssätzen zu Farben. (Geerbt von Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Ermöglicht das Zuordnen von `android.view.View` Zustandssätzen zu Farben. (Geerbt von Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	Ermöglicht das Zuordnen von `android.view.View` Zustandssätzen zu Farben. (Geerbt von Object)

Erweiterungsmethoden

JavaCast<TResult>(IJavaObject)	Führt eine Für Android-Runtime überprüfte Typkonvertierung aus.
JavaCast<TResult>(IJavaObject)	Ermöglicht das Zuordnen von `android.view.View` Zustandssätzen zu Farben.
GetJniTypeName(IJavaPeerable)	Ermöglicht das Zuordnen von `android.view.View` Zustandssätzen zu Farben.

Gilt für: