ColorStateList Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Permite asignar android.view.View
conjuntos de estados a colores.
[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
- Herencia
- Atributos
- Implementaciones
Comentarios
Permite asignar android.view.View
conjuntos de estados a colores.
android.content.res.ColorStateList
se crean a partir de archivos de recursos XML definidos en el directorio del subdirectorio "color" del directorio de recursos de una aplicación. El archivo XML contiene un único elemento "selector" con un número de elementos "item" dentro. Por ejemplo:
<selector xmlns:android="http://schemas.android.com/apk/res/android">
<item android:state_focused="true"
android:color="@color/sample_focused" />
<item android:state_pressed="true"
android:state_enabled="false"
android:color="@color/sample_disabled_pressed" />
<item android:state_enabled="false"
android:color="@color/sample_disabled_not_pressed" />
<item android:color="@color/sample_default" />
</selector>
Esto define un conjunto de pares de especificaciones o colores de estado donde cada especificación de estado especifica un conjunto de estados en los que una vista debe estar o no en y el color especifica el color asociado a esa especificación.
"StateSpec"><h3>State specs</h3>
Cada elemento define un conjunto de pares de especificaciones de estado y color, donde la especificación de estado es una serie de atributos establecidos true
en o false
para representar la inclusión o exclusión. Si no se especifica un atributo para un elemento, puede ser cualquier valor.
Por ejemplo, el siguiente elemento coincidirá siempre que se establezca el estado centrado; cualquier otro estado puede establecerse o anularse:
<item android:state_focused="true"
android:color="@color/sample_focused" />
Normalmente, una lista de estados de color hará referencia a atributos de estado definidos por el marco como android.R.attr#state_focused android:state_focused
o android.R.attr#state_enabled android:state_enabled
; sin embargo, también se pueden usar atributos definidos por la aplicación.
<strong>Note:</strong> La lista de especificaciones de estado se comparará con en el orden en que aparecen en el archivo XML. Por este motivo, los elementos más específicos deben colocarse anteriormente en el archivo. Un elemento sin especificación de estado se considera que coincide con cualquier conjunto de estados y suele ser útil como elemento final que se usará como valor predeterminado.
Si un elemento sin especificación de estado se coloca antes que otros elementos, se omitirán esos elementos.
"ItemAttributes"><h3>Atributos de elemento</h3>
Cada elemento debe definir un android.R.attr#color android:color
atributo, que puede ser un color hexadecimal de estilo HTML, una referencia a un recurso de color o , en la API 23 y versiones posteriores, un atributo de tema que se resuelve en un color.
A partir de la API 23, los elementos pueden definir opcionalmente un android.R.attr#alpha android:alpha
atributo para modificar la opacidad del color base. Este atributo toma un valor de punto flotante entre 0 y 1 o un atributo de tema que se resuelve como tal. El color general del elemento se calcula multiplicando por el canal alfa del color base por el alpha
valor . Por ejemplo, el siguiente elemento representa el color de énfasis del tema al 50 % de opacidad:
<item android:state_enabled="false"
android:color="?android:attr/colorAccent"
android:alpha="0.5" />
A partir de la API 31, los elementos pueden definir opcionalmente un android.R.attr#lStar android:lStar
atributo para modificar la luminancia perceptual del color base. Este atributo toma un valor de punto flotante entre 0 y 100 o un atributo de tema que se resuelve como tal. El color general del elemento se calcula convirtiendo el color base en un espacio de colores descriptivo de accesibilidad y estableciendo su L* en el valor especificado en el lStar
atributo. Por ejemplo, el siguiente elemento representa el color de énfasis del tema al 50 % de la luminancia perceptual:
<item android:state_enabled="false"
android:color="?android:attr/colorAccent"
android:lStar="50" />
"DeveloperGuide"><h3>Developer guide</h3>
Para obtener más información, consulte la guía sobre el recurso de lista de estados de color.
Documentación de Java para android.content.res.ColorStateList
.
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código Project y que se usan según los términos Creative Commons 2.5 Attribution License.
Constructores
ColorStateList(Int32[][], Int32[]) |
Crea un ColorStateList que devuelve la asignación especificada de estados a colores. |
ColorStateList(IntPtr, JniHandleOwnership) |
Constructor utilizado al crear representaciones administradas de objetos JNI; llamado por el tiempo de ejecución. |
Propiedades
ChangingConfigurations |
Devuelve una máscara de los parámetros de configuración para los que esta lista de estados de color puede cambiar, lo que requiere que se vuelva a crear. |
Class |
Devuelve la clase en tiempo de ejecución de este |
Creator | |
DefaultColor |
Devuelve el color predeterminado en este |
Handle |
Identificador de la instancia de Android subyacente. (Heredado de Object) |
IsOpaque |
Indica si esta lista de estados de color es opaca, lo que significa que cada color devuelto tiene |
IsStateful |
Indica si esta lista de estados de color contiene al menos una especificación de estado y la primera especificación no está vacía (e. |
JniIdentityHashCode |
Permite asignar |
JniPeerMembers |
Permite asignar |
PeerReference |
Permite asignar |
ThresholdClass |
Esta API admite la infraestructura mono para Android y no está pensada para usarse directamente desde el código. |
ThresholdType |
Esta API admite la infraestructura mono para Android y no está pensada para usarse directamente desde el código. |
Métodos
Clone() |
Crea y devuelve una copia de este objeto. (Heredado de Object) |
CreateFromXml(Resources, XmlReader) |
Crea un ColorStateList a partir de un documento XML. |
CreateFromXml(Resources, XmlReader, Resources+Theme) |
Crea un ColorStateList a partir de un documento XML. |
DescribeContents() |
Describir los tipos de objetos especiales contenidos en la representación serializado de este Parcelable. |
Dispose() |
Permite asignar |
Dispose(Boolean) |
Permite asignar |
Equals(Object) |
Indica si algún otro objeto es "igual a" este. (Heredado de Object) |
GetColorForState(Int32[], Color) |
Devuelve el color asociado al conjunto de |
GetHashCode() |
Devuelve un valor de código hash del objeto. (Heredado de Object) |
JavaFinalize() |
Lo llama el recolector de elementos no utilizados en un objeto cuando la recolección de elementos no utilizados determina que no hay más referencias al objeto . (Heredado de Object) |
Notify() |
Activa un único subproceso que está esperando en el monitor de este objeto. (Heredado de Object) |
NotifyAll() |
Activa todos los subprocesos que están esperando en el monitor de este objeto. (Heredado de Object) |
SetHandle(IntPtr, JniHandleOwnership) |
Establece la propiedad Handle. (Heredado de Object) |
ToArray<T>() |
Permite asignar |
ToString() |
Devuelve una representación de cadena del objeto. (Heredado de Object) |
UnregisterFromRuntime() |
Permite asignar |
ValueOf(Color) | |
Wait() |
Hace que el subproceso actual espere hasta que se despierte, normalmente por ser em notificado/em> o <em>interrumpido</em>.<>< (Heredado de Object) |
Wait(Int64) |
Hace que el subproceso actual espere hasta que se despierte, normalmente por ser <em>notificado</em> o <em>interrumpido</em>, o hasta que haya transcurrido una cierta cantidad de tiempo real. (Heredado de Object) |
Wait(Int64, Int32) |
Hace que el subproceso actual espere hasta que se despierte, normalmente por ser <em>notificado</em> o <em>interrumpido</em>, o hasta que haya transcurrido una cierta cantidad de tiempo real. (Heredado de Object) |
WithAlpha(Int32) |
Crea un nuevo ColorStateList que tiene los mismos estados y colores que este, pero donde cada color tiene el valor alfa especificado (0-255). |
WithLStar(Single) |
Crea un nuevo ColorStateList que tiene los mismos estados y colores que este, pero donde cada color tiene el valor de luminosidad percibido especificado (0-100). |
WriteToParcel(Parcel, ParcelableWriteFlags) |
Aplane este objeto en un paquete. |
Implementaciones de interfaz explícitas
IJavaPeerable.Disposed() |
Permite asignar |
IJavaPeerable.DisposeUnlessReferenced() |
Permite asignar |
IJavaPeerable.Finalized() |
Permite asignar |
IJavaPeerable.JniManagedPeerState |
Permite asignar |
IJavaPeerable.SetJniIdentityHashCode(Int32) |
Permite asignar |
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Permite asignar |
IJavaPeerable.SetPeerReference(JniObjectReference) |
Permite asignar |
Métodos de extensión
JavaCast<TResult>(IJavaObject) |
Realiza una conversión de tipos comprobados en tiempo de ejecución de Android. |
JavaCast<TResult>(IJavaObject) |
Permite asignar |
GetJniTypeName(IJavaPeerable) |
Permite asignar |