ColorStateList Класс

Ссылка

Определение

Пространство имен:: Android.Content.Res

Сборка:: Mono.Android.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Позволяет сопоставлять android.view.View наборы состояний с цветами.

[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

Наследование: Object

Object
ColorStateList

Атрибуты: RegisterAttribute

Реализации: IParcelable IJavaObject IJavaPeerable IDisposable

android.content.res.ColorStateListсоздаются из XML-файлов ресурсов, определенных в подкаталоге color каталога ресурсов приложения. XML-файл содержит один элемент selector с несколькими элементами item внутри. Пример:

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

Он определяет набор пар "спецификация состояния/цвет", где каждая спецификация состояния определяет набор состояний, в которых представление должно находиться или не находиться, а цвет определяет цвет, связанный с этой спецификацией.

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

Каждый элемент определяет набор пар спецификации состояния и цветов, где спецификация состояния представляет собой последовательность атрибутов, для которых задано значение true или false для представления включения или исключения. Если атрибут не указан для элемента, это может быть любое значение.

Например, следующий элемент будет сопоставляться всякий раз, когда задано состояние фокуса. любые другие состояния могут быть заданы или отменяться:

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

Как правило, список цветовых состояний ссылается на определяемые платформой атрибуты состояния, такие как android.R.attr#state_focused android:state_focused или android.R.attr#state_enabled android:state_enabled; однако также можно использовать атрибуты, определяемые приложением.

<strong>Примечание.</strong> . Список спецификаций состояний будет сопоставляться с в том порядке, в котором они отображаются в XML-файле. По этой причине ранее в файл следует поместить более конкретные элементы. Элемент без спецификации состояния считается соответствующим любому набору состояний и, как правило, полезен в качестве окончательного элемента для использования по умолчанию.

Если элемент без спецификации состояния помещается перед другими элементами, эти элементы будут игнорироваться.

"ItemAttributes"><h3>Атрибуты< элемента/h3>

Каждый элемент должен определять android.R.attr#color android:color атрибут, который может быть шестнадцатеричным цветом в стиле HTML, ссылкой на ресурс цвета или ( в API 23 и более поздних версий ) атрибутом темы, который разрешается в цвет.

Начиная с API 23 элементы при необходимости могут определять android.R.attr#alpha android:alpha атрибут для изменения непрозрачности базового цвета. Этот атрибут принимает значение с плавающей запятой от 0 до 1 или атрибут темы, который разрешается как таковой. Общий цвет элемента вычисляется путем умножения на альфа-канал базового цвета на alpha значение. Например, следующий элемент представляет контрастный цвет темы при непрозрачности 50 %.

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

Начиная с API 31 элементы при необходимости могут определять android.R.attr#lStar android:lStar атрибут для изменения яркости базового цвета. Этот атрибут принимает значение с плавающей запятой от 0 до 100 или атрибут темы, который разрешается как таковой. Общий цвет элемента вычисляется путем преобразования базового цвета в цветовое пространство, понятное для специальных возможностей, и задания L* значения, указанного в атрибуте lStar . Например, следующий элемент представляет контрастный цвет темы с 50 % цептуальной яркостью:

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

"DeveloperGuide"><h3>Руководство< для разработчиков/h3>

Дополнительные сведения см. в руководстве по ресурсу списка состояния цвета.

Документация по Java для android.content.res.ColorStateList.

Части этой страницы являются изменениями, основанными на работе, созданной и совместно используемой проектом Android и используемой в соответствии с условиями, Creative Commons 2.5 Attribution License.

Конструкторы

ColorStateList(Int32[][], Int32[])	Создает Объект ColorStateList, возвращающий указанное сопоставление между состояниями и цветами.
ColorStateList(IntPtr, JniHandleOwnership)	Конструктор, используемый при создании управляемых представлений объектов JNI; вызывается средой выполнения.

Свойства

ChangingConfigurations	Возвращает маску параметров конфигурации, для которых этот список состояний цветов может измениться, требуя его повторного создания.
Class	Возвращает класс среды выполнения данного объекта `Object`. (Унаследовано от Object)
Creator
DefaultColor	Возвращает цвет по умолчанию в этом объекте `ColorStateList`.
Handle	Дескриптор базового экземпляра Android. (Унаследовано от Object)
IsOpaque	Указывает, является ли этот список состояний цвета непрозрачным, что означает, что каждый цвет, возвращаемый из `#getColorForState(int[], int)` , имеет альфа-значение 255.
IsStateful	Указывает, содержит ли этот список состояний цвета хотя бы одну спецификацию состояния, а первая спецификация не пуста (e.
JniIdentityHashCode	Позволяет сопоставлять `android.view.View` наборы состояний с цветами. (Унаследовано от Object)
JniPeerMembers	Позволяет сопоставлять `android.view.View` наборы состояний с цветами.
PeerReference	Позволяет сопоставлять `android.view.View` наборы состояний с цветами. (Унаследовано от Object)
ThresholdClass	Этот API поддерживает инфраструктуру Mono для Android и не предназначен для использования непосредственно из кода.
ThresholdType	Этот API поддерживает инфраструктуру Mono для Android и не предназначен для использования непосредственно из кода.

Методы

Clone()	Создает и возвращает копию этого объекта. (Унаследовано от Object)
CreateFromXml(Resources, XmlReader)	Создает ColorStateList на основе XML-документа.
CreateFromXml(Resources, XmlReader, Resources+Theme)	Создает ColorStateList на основе XML-документа.
DescribeContents()	Описывать типы специальных объектов, содержащихся в маршалируемом представлении этого объектного объекта.
Dispose()	Позволяет сопоставлять `android.view.View` наборы состояний с цветами. (Унаследовано от Object)
Dispose(Boolean)	Позволяет сопоставлять `android.view.View` наборы состояний с цветами. (Унаследовано от Object)
Equals(Object)	Указывает, равен ли какой-то другой объект этому объекту. (Унаследовано от Object)
GetColorForState(Int32[], Color)	Возвращает цвет, связанный с заданным набором состояний `android.view.View` .
GetHashCode()	Возвращает значение хэш-кода для объекта. (Унаследовано от Object)
JavaFinalize()	Вызывается сборщиком мусора для объекта , когда сборка мусора определяет, что больше нет ссылок на объект . (Унаследовано от Object)
Notify()	Пробуждает один поток, ожидающий монитора этого объекта. (Унаследовано от Object)
NotifyAll()	Пробуждает все потоки, ожидающие на мониторе этого объекта. (Унаследовано от Object)
SetHandle(IntPtr, JniHandleOwnership)	Задает свойство Handle. (Унаследовано от Object)
ToArray<T>()	Позволяет сопоставлять `android.view.View` наборы состояний с цветами. (Унаследовано от Object)
ToString()	Возвращает строковое представление объекта. (Унаследовано от Object)
UnregisterFromRuntime()	Позволяет сопоставлять `android.view.View` наборы состояний с цветами. (Унаследовано от Object)
ValueOf(Color)
Wait()	Вызывает ожидание текущего потока, пока он не пробудится, как правило, из-за <уведомления><<> или>прерывания или прерывания.>< (Унаследовано от Object)
Wait(Int64)	Вызывает ожидание текущего потока, пока он не пробудится, как правило, путем <уведомления><<> или>прерывания или прерывания<> или до истечения определенного количества реального времени. (Унаследовано от Object)
Wait(Int64, Int32)	Вызывает ожидание текущего потока, пока он не пробудится, как правило, путем <уведомления><<> или>прерывания или прерывания<> или до истечения определенного количества реального времени. (Унаследовано от Object)
WithAlpha(Int32)	Создает объект ColorStateList с теми же состояниями и цветами, что и этот, но в котором каждый цвет имеет указанное альфа-значение (0–255).
WithLStar(Single)	Создает объект ColorStateList, который имеет те же состояния и цвета, что и этот, но где каждый цвет имеет указанное значение воспринимаемой яркости (0–100).
WriteToParcel(Parcel, ParcelableWriteFlags)	Разведите этот объект в плоскую структуру в объект Parcel.

Явные реализации интерфейса

IJavaPeerable.Disposed()	Позволяет сопоставлять `android.view.View` наборы состояний с цветами. (Унаследовано от Object)
IJavaPeerable.DisposeUnlessReferenced()	Позволяет сопоставлять `android.view.View` наборы состояний с цветами. (Унаследовано от Object)
IJavaPeerable.Finalized()	Позволяет сопоставлять `android.view.View` наборы состояний с цветами. (Унаследовано от Object)
IJavaPeerable.JniManagedPeerState	Позволяет сопоставлять `android.view.View` наборы состояний с цветами. (Унаследовано от Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Позволяет сопоставлять `android.view.View` наборы состояний с цветами. (Унаследовано от Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Позволяет сопоставлять `android.view.View` наборы состояний с цветами. (Унаследовано от Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	Позволяет сопоставлять `android.view.View` наборы состояний с цветами. (Унаследовано от Object)

Методы расширения

JavaCast<TResult>(IJavaObject)	Выполняет преобразование типа, проверенного средой выполнения Android.
JavaCast<TResult>(IJavaObject)	Позволяет сопоставлять `android.view.View` наборы состояний с цветами.
GetJniTypeName(IJavaPeerable)	Позволяет сопоставлять `android.view.View` наборы состояний с цветами.

Применяется к