ColorStateList Classe

Riferimento

Definizione

Spazio dei nomi:: Android.Content.Res

Assembly:: Mono.Android.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Consente di eseguire il mapping android.view.View dei set di stati ai colori.

[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

Ereditarietà: Object

Object
ColorStateList

Attributi: RegisterAttribute

Implementazioni: IParcelable IJavaObject IJavaPeerable IDisposable

Commenti

Consente di eseguire il mapping android.view.View dei set di stati ai colori.

android.content.res.ColorStateLists viene creato da file di risorse XML definiti nella directory di sottodirectory "color" della directory delle risorse di un'applicazione. Il file XML contiene un singolo elemento "selettore" con un numero di elementi "item". Ad esempio:

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

In questo modo viene definito un set di coppie di specifiche di stato/colore in cui ogni specifica di stato specifica un set di stati in cui una vista deve essere in o meno e il colore specifica il colore associato a tale specifica.

Specifiche "StateSpec"><h3 State</h3>>

Ogni elemento definisce un set di coppie di specifiche di stato e colore, in cui la specifica di stato è una serie di attributi impostati su true o false per rappresentare l'inclusione o l'esclusione. Se un attributo non viene specificato per un elemento, può essere qualsiasi valore.

Ad esempio, l'elemento seguente verrà corrispondente ogni volta che viene impostato lo stato attivo; qualsiasi altro stato può essere impostato o non impostato:

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

In genere, un elenco stato colore farà riferimento agli attributi di stato definiti dal framework, ad esempio android.R.attr#state_focused android:state_focused o android.R.attr#state_enabled android:state_enabled; tuttavia, gli attributi definiti dall'app possono essere usati anche.

<nota forte:</strong>> L'elenco delle specifiche di stato verrà confrontato con nell'ordine in cui vengono visualizzati nel file XML. Per questo motivo, gli elementi più specifici devono essere inseriti in precedenza nel file. Un elemento senza specifica di stato viene considerato corrispondente a qualsiasi set di stati ed è generalmente utile come elemento finale da usare come impostazione predefinita.

Se un elemento senza specifica di stato viene inserito prima di altri elementi, tali elementi verranno ignorati.

Attributi dell'elemento "ItemAttributes<"><h3/h3>>

Ogni elemento deve definire un android.R.attr#color android:color attributo, che può essere un colore esadecimale in stile HTML, un riferimento a una risorsa colore o , nell'API 23 e versioni successive, un attributo del tema che risolve un colore.

A partire dall'API 23, gli elementi possono definire facoltativamente un android.R.attr#alpha android:alpha attributo per modificare l'opacità del colore di base. Questo attributo accetta un valore a virgola mobile compreso tra 0 e 1 o un attributo del tema che risolve come tale. Il colore complessivo dell'elemento viene calcolato moltiplicando in base al canale alfa del colore di base per il alpha valore. Ad esempio, l'elemento seguente rappresenta il colore accentato del tema al 50% di opacità:

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

A partire dall'API 31, gli elementi possono definire facoltativamente un android.R.attr#lStar android:lStar attributo per modificare la luminanza percettiva del colore di base. Questo attributo accetta un valore a virgola mobile compreso tra 0 e 100 o un attributo del tema che risolve come tale. Il colore complessivo dell'elemento viene calcolato convertendo il colore di base in uno spazio di colore descrittivo per l'accessibilità e impostandone L* sul valore specificato nell'attributo lStar . Ad esempio, l'elemento seguente rappresenta il colore accentato del tema al 50% per la luminanza percettiva:

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

Guida per sviluppatori "DeveloperGuide<"><h3/h3>>

Per altre informazioni, vedere la guida alla risorsa Elenco stati colori.

Documentazione Java per android.content.res.ColorStateList.

Le parti di questa pagina sono modifiche in base al lavoro creato e condiviso dal Android Open Source e usato in base ai termini descritti nella .

Costruttori

ColorStateList(Int32[][], Int32[])	Crea un colorStateList che restituisce il mapping specificato dagli stati ai colori.
ColorStateList(IntPtr, JniHandleOwnership)	Costruttore usato durante la creazione di rappresentazioni gestite di oggetti JNI; chiamato dal runtime.

Proprietà

ChangingConfigurations	Restituisce una maschera dei parametri di configurazione per cui questo elenco di stati colore può cambiare, richiedendo che venga ricreato.
Class	Restituisce la classe di runtime di questo `Object`oggetto . (Ereditato da Object)
Creator
DefaultColor	Restituisce il colore predefinito in questo `ColorStateList`oggetto .
Handle	Handle all'istanza di Android sottostante. (Ereditato da Object)
IsOpaque	Indica se questo elenco di stati di colore è opaco, il che significa che ogni colore restituito da `#getColorForState(int[], int)` ha un valore alfa pari a 255.
IsStateful	Indica se questo elenco di stati di colore contiene almeno una specifica di stato e la prima specifica non è vuota (e.
JniIdentityHashCode	Consente di eseguire il mapping `android.view.View` dei set di stati ai colori. (Ereditato da Object)
JniPeerMembers	Consente di eseguire il mapping `android.view.View` dei set di stati ai colori.
PeerReference	Consente di eseguire il mapping `android.view.View` dei set di stati ai colori. (Ereditato da Object)
ThresholdClass	Questa API supporta l'infrastruttura Mono per Android e non deve essere usata direttamente dal codice.
ThresholdType	Questa API supporta l'infrastruttura Mono per Android e non deve essere usata direttamente dal codice.

Metodi

Clone()	Crea e restituisce una copia di questo oggetto. (Ereditato da Object)
CreateFromXml(Resources, XmlReader)	Crea un colorStateList da un documento XML.
CreateFromXml(Resources, XmlReader, Resources+Theme)	Crea un colorStateList da un documento XML.
DescribeContents()	Descrivere i tipi di oggetti speciali contenuti nella rappresentazione marshalled di Parcelable.
Dispose()	Consente di eseguire il mapping `android.view.View` dei set di stati ai colori. (Ereditato da Object)
Dispose(Boolean)	Consente di eseguire il mapping `android.view.View` dei set di stati ai colori. (Ereditato da Object)
Equals(Object)	Indica se un altro oggetto è "uguale a" questo. (Ereditato da Object)
GetColorForState(Int32[], Color)	Restituisce il colore associato al set specificato di `android.view.View` stati.
GetHashCode()	Restituisce un valore del codice hash per l'oggetto. (Ereditato da Object)
JavaFinalize()	Chiamato dal Garbage Collector in un oggetto quando Garbage Collection determina che non sono presenti più riferimenti all'oggetto. (Ereditato da Object)
Notify()	Riattiva un singolo thread in attesa del monitoraggio dell'oggetto. (Ereditato da Object)
NotifyAll()	Riattiva tutti i thread in attesa del monitoraggio dell'oggetto. (Ereditato da Object)
SetHandle(IntPtr, JniHandleOwnership)	Imposta la proprietà Handle. (Ereditato da Object)
ToArray<T>()	Consente di eseguire il mapping `android.view.View` dei set di stati ai colori. (Ereditato da Object)
ToString()	Restituisce una rappresentazione in formato stringa dell'oggetto. (Ereditato da Object)
UnregisterFromRuntime()	Consente di eseguire il mapping `android.view.View` dei set di stati ai colori. (Ereditato da Object)
ValueOf(Color)
Wait()	Causa l'attesa del thread corrente fino a quando non viene svegliata, in genere eseguendo>una notifica</em o <em interrotto</>em>>.< (Ereditato da Object)
Wait(Int64)	Causa l'attesa del thread corrente fino a quando non viene svegliata, in genere <>eseguendo una notifica</em o <em interrotto/>>em>o fino a quando non è trascorsa< una determinata quantità di tempo reale. (Ereditato da Object)
Wait(Int64, Int32)	Causa l'attesa del thread corrente fino a quando non viene svegliata, in genere <>eseguendo una notifica</em o <em interrotto/>>em>o fino a quando non è trascorsa< una determinata quantità di tempo reale. (Ereditato da Object)
WithAlpha(Int32)	Crea un nuovo ColorStateList con gli stessi stati e colori di questo, ma dove ogni colore ha il valore alfa specificato (0-255).
WithLStar(Single)	Crea un nuovo ColorStateList con gli stessi stati e colori di questo, ma dove ogni colore ha il valore di luminosità percepito specificato (0-100).
WriteToParcel(Parcel, ParcelableWriteFlags)	Appiattire questo oggetto in un pacchetto.

Implementazioni dell'interfaccia esplicita

IJavaPeerable.Disposed()	Consente di eseguire il mapping `android.view.View` dei set di stati ai colori. (Ereditato da Object)
IJavaPeerable.DisposeUnlessReferenced()	Consente di eseguire il mapping `android.view.View` dei set di stati ai colori. (Ereditato da Object)
IJavaPeerable.Finalized()	Consente di eseguire il mapping `android.view.View` dei set di stati ai colori. (Ereditato da Object)
IJavaPeerable.JniManagedPeerState	Consente di eseguire il mapping `android.view.View` dei set di stati ai colori. (Ereditato da Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Consente di eseguire il mapping `android.view.View` dei set di stati ai colori. (Ereditato da Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Consente di eseguire il mapping `android.view.View` dei set di stati ai colori. (Ereditato da Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	Consente di eseguire il mapping `android.view.View` dei set di stati ai colori. (Ereditato da Object)

Metodi di estensione

JavaCast<TResult>(IJavaObject)	Esegue una conversione dei tipi controllati dal runtime Android.
JavaCast<TResult>(IJavaObject)	Consente di eseguire il mapping `android.view.View` dei set di stati ai colori.
GetJniTypeName(IJavaPeerable)	Consente di eseguire il mapping `android.view.View` dei set di stati ai colori.

Si applica a

Condividi tramite