Доступные ресурсы

Рисуемый ресурс — это общая концепция графики, которую можно нарисовать на экране и которую можно получить с помощью API, например getDrawable(int) или применить к другому XML-ресурсу с такими атрибутами, как android:drawable и android:icon . Существует несколько типов чертежей:

Растровый файл

Растровый графический файл (PNG, WEBP, JPG или GIF). Создает BitmapDrawable .

Файл с девятью патчами

PNG-файл с растягиваемыми областями, позволяющими изменять размер изображений в зависимости от содержимого ( .9.png ). Создает NinePatchDrawable .

Список слоев

Drawable, который управляет массивом других drawable. Они рисуются в порядке массива, поэтому элемент с наибольшим индексом отображается сверху. Создает LayerDrawable .

Государственный список

XML-файл, который ссылается на разные растровые изображения для разных состояний — например, для использования другого изображения при нажатии кнопки. Создает StateListDrawable .

Список уровней

XML-файл, определяющий объект рисования, который управляет несколькими альтернативными объектами рисования, каждому из которых присвоено максимальное числовое значение. Создает LevelListDrawable .

Переход с возможностью рисования

XML-файл, определяющий объект рисования, который может плавно переходить между двумя ресурсами рисования. Создает TransitionDrawable .

Вставка выдвижная

XML-файл, определяющий объект рисования, который вставляет другой объект рисования на указанное расстояние. Это полезно, когда представлению требуется фоновый рисунок, который меньше фактических границ представления.

Клип выдвижной

XML-файл, определяющий объект рисования, который отсекает другой объект рисования на основе текущего значения уровня этого объекта рисования. Создает ClipDrawable .

Масштабируемый

XML-файл, определяющий объект рисования, который изменяет размер другого объекта рисования в зависимости от его текущего значения уровня. Создает ScaleDrawable

Рисуемая форма .

XML-файл, определяющий геометрическую фигуру, включая цвета и градиенты. Создает GradientDrawable .

Сведения о том, как создать AnimationDrawable , см. в документе ресурсов анимации .

Примечание. Ресурс цвета также можно использовать как объект рисования в XML. Например, при создании списка состояний drawable вы можете ссылаться на ресурс цвета для атрибута android:drawable ( android:drawable="@color/green" ).

Растровое изображение

Растровое изображение. Android поддерживает растровые файлы в следующих форматах: PNG (предпочтительно), WEBP (предпочтительно, требуется уровень API 17 или выше), JPG (приемлемо), GIF (не рекомендуется).

Вы можете напрямую ссылаться на растровый файл, используя имя файла в качестве идентификатора ресурса, или создать псевдоним идентификатора ресурса в XML.

Примечание. Растровые файлы могут быть автоматически оптимизированы со сжатием изображений без потерь с помощью инструмента aapt во время процесса сборки. Например, полноцветный PNG, для которого не требуется более 256 цветов, можно преобразовать в 8-битный PNG с цветовой палитрой. В результате получается изображение одинакового качества, требующее меньше памяти.

Поэтому имейте в виду, что двоичные файлы изображений, помещенные в этот каталог, могут измениться во время сборки. Если вы планируете читать изображение как битовый поток и конвертировать его в растровое изображение, вместо этого поместите изображения в папку res/raw/ , где они не оптимизированы.

Растровый файл

Растровый файл — это файл PNG, WEBP, JPG или GIF. Android создает ресурс Drawable для любого из этих файлов, когда вы сохраняете их в каталоге res/drawable/ .

расположение файла:

res/drawable/ filename .png ( .png , .webp , .jpg или .gif )
Имя файла — это идентификатор ресурса.

тип данных скомпилированного ресурса:

Указатель ресурса на BitmapDrawable

ссылка на ресурс:

В Java: R.drawable. filename
В XML: @[ package :]drawable/ filename

пример:

Если изображение сохранено в res/drawable/myimage.png , этот XML-макет применяет изображение к представлению:

<ImageView
    android:layout_height="wrap_content"
    android:layout_width="wrap_content"
    android:src="@drawable/myimage" />

Следующий код приложения извлекает изображение как Drawable :

Котлин

val drawable: Drawable? = ResourcesCompat.getDrawable(resources, R.drawable.myimage, null)

Ява

Resources res = getResources();
Drawable drawable = ResourcesCompat.getDrawable(res, R.drawable.myimage, null);

см. также:

• Обзор чертежей
• BitmapDrawable

XML-растровое изображение

Растровое изображение XML — это ресурс, определенный в XML, который указывает на файл растрового изображения. Эффект представляет собой псевдоним для файла необработанного растрового изображения. XML может указывать дополнительные свойства растрового изображения, такие как сглаживание и мозаика.

Примечание. Вы можете использовать элемент <bitmap> как дочерний элемент элемента <item> . Например, при создании списка состояний или списка слоев вы можете исключить атрибут android:drawable из элемента <item> и вложить в него <bitmap> , определяющий элемент, который можно рисовать.

расположение файла:

res/drawable/ filename .xml
Имя файла — это идентификатор ресурса.

тип данных скомпилированного ресурса:

Указатель ресурса на BitmapDrawable

ссылка на ресурс:

В Java: R.drawable. filename
В XML: @[ package :]drawable/ filename

синтаксис:

<?xml version="1.0" encoding="utf-8"?>
<bitmap
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:src="@[package:]drawable/drawable_resource"
    android:antialias=["true" | "false"]
    android:dither=["true" | "false"]
    android:filter=["true" | "false"]
    android:gravity=["top" | "bottom" | "left" | "right" | "center_vertical" |
                      "fill_vertical" | "center_horizontal" | "fill_horizontal" |
                      "center" | "fill" | "clip_vertical" | "clip_horizontal"]
    android:mipMap=["true" | "false"]
    android:tileMode=["disabled" | "clamp" | "repeat" | "mirror"] />

элементы:

<bitmap>

Необходимый. Определяет источник растрового изображения и его свойства.

Атрибуты:

xmlns:android

Нить . Определяет пространство имен XML, которое должно иметь вид "http://schemas.android.com/apk/res/android" . Это требуется только в том случае, если <bitmap> является корневым элементом. Это не требуется, если <bitmap> вложен внутри <item> .

android:src

Рисуемый ресурс . Необходимый . Ссылка на доступный ресурс.

android:antialias

Логическое значение . Включает или отключает сглаживание.

android:dither

Логическое значение . Включает или отключает сглаживание растрового изображения, если растровое изображение не имеет той же конфигурации пикселей, что и экран, например растровое изображение ARGB 8888 на экране RGB 565.

android:filter

Логическое значение . Включает или отключает фильтрацию растровых изображений. Фильтрация используется, когда растровое изображение сжимается или растягивается для сглаживания его внешнего вида.

android:gravity

Ключевое слово . Определяет гравитацию растрового изображения. Гравитация указывает, где расположить объект рисования в контейнере, если растровое изображение меньше контейнера.

Должно быть одно или несколько из следующих значений констант, разделенных | :

Ценить	Описание
top	Поместите объект вверху контейнера, не меняя его размера.
bottom	Поместите объект на дно контейнера, не меняя его размера.
left	Поместите объект у левого края контейнера, не меняя его размера.
right	Поместите объект у правого края контейнера, не меняя его размера.
center_vertical	Поместите объект в вертикальный центр его контейнера, не меняя его размера.
fill_vertical	При необходимости увеличьте вертикальный размер объекта, чтобы он полностью заполнил контейнер.
center_horizontal	Разместите объект в горизонтальном центре его контейнера, не меняя его размера.
fill_horizontal	При необходимости увеличьте горизонтальный размер объекта, чтобы он полностью заполнил контейнер.
center	Поместите объект в центр контейнера как по вертикальной, так и по горизонтальной оси, не меняя его размера.
fill	При необходимости увеличьте горизонтальный и вертикальный размер объекта, чтобы он полностью заполнил контейнер. Это значение по умолчанию.
clip_vertical	Дополнительная опция, которую можно настроить так, чтобы верхние и/или нижние края дочернего элемента были обрезаны до границ его контейнера. Зажим основан на вертикальной силе тяжести: верхняя сила тяжести зажимает нижний край, нижняя сила тяжести зажимает верхний край, и ни один из них не зажимает оба края.
clip_horizontal	Дополнительная опция, которую можно настроить так, чтобы левый и/или правый края дочернего элемента были обрезаны до границ его контейнера. Зажим основан на горизонтальной силе тяжести: левая сила тяжести зажимает правый край, правая сила тяжести зажимает левый край, и ни один из них не зажимает оба края.

android:mipMap

Логическое значение . Включает или отключает подсказку MIP-карты. См. setHasMipMap() для получения дополнительной информации. Значение по умолчанию — ложь.

android:tileMode

Ключевое слово . Определяет режим плитки. Когда режим плитки включен, растровое изображение повторяется. Гравитация игнорируется, когда включен режим плитки.

Должно быть одно из следующих постоянных значений:

Ценить	Описание
disabled	Не размещайте растровое изображение плиткой. Это значение по умолчанию.
clamp	Реплицируйте цвет края, если шейдер выходит за пределы исходных границ.
repeat	Повторите изображение шейдера по горизонтали и вертикали.
mirror	Повторяйте изображение шейдера по горизонтали и вертикали, чередуя зеркальные изображения, чтобы соседние изображения всегда совпадали.

пример:

<?xml version="1.0" encoding="utf-8"?>
<bitmap xmlns:android="http://schemas.android.com/apk/res/android"
    android:src="@drawable/icon"
    android:tileMode="repeat" />

см. также:

• BitmapDrawable
• Создание ресурсов псевдонимов

Девять патчей

NinePatch — это изображение PNG, в котором вы можете определить растягиваемые области, которые Android масштабирует, когда содержимое в представлении выходит за обычные границы изображения. Обычно вы назначаете этот тип изображения в качестве фона представления, у которого хотя бы одно измерение имеет значение "wrap_content" .

Когда представление увеличивается, чтобы вместить содержимое, изображение из девяти фрагментов также масштабируется в соответствии с размером представления. Примером использования изображения из девяти патчей является фон, используемый стандартным виджетом Android Button , который должен растягиваться, чтобы разместить текст (или изображение) внутри кнопки.

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

Подробное обсуждение того, как создать файл с девятью исправлениями и растягиваемыми областями, см. в разделе Создание растровых изображений с изменяемым размером (файлы с девятью исправлениями) .

Файл с девятью патчами

расположение файла:

res/drawable/ filename .9.png
Имя файла — это идентификатор ресурса.

тип данных скомпилированного ресурса:

Указатель ресурса на NinePatchDrawable

ссылка на ресурс:

В Java: R.drawable. filename
В XML: @[ package :]drawable/ filename

пример:

С изображением, сохраненным в res/drawable/myninepatch.9.png , этот XML-макет применяет девять патчей к представлению:

<Button
    android:layout_height="wrap_content"
    android:layout_width="wrap_content"
    android:background="@drawable/myninepatch" />

см. также:

• Создание растровых изображений с изменяемым размером (файлы с 9 патчами)
• NinePatchDrawable

XML с девятью исправлениями

XML-файл с девятью исправлениями — это ресурс, определенный в XML, который указывает на файл с девятью исправлениями. XML может указывать сглаживание изображения.

расположение файла:

res/drawable/ filename .xml
Имя файла — это идентификатор ресурса.

тип данных скомпилированного ресурса:

Указатель ресурса на NinePatchDrawable

ссылка на ресурс:

В Java: R.drawable. filename
В XML: @[ package :]drawable/ filename

синтаксис:

<?xml version="1.0" encoding="utf-8"?>
<nine-patch
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:src="@[package:]drawable/drawable_resource"
    android:dither=["true" | "false"] />

элементы:

<nine-patch>

Необходимый. Определяет источник девяти патчей и его свойства.

Атрибуты:

xmlns:android

Нить . Необходимый. Определяет пространство имен XML, которое должно иметь вид "http://schemas.android.com/apk/res/android" .

android:src

Рисуемый ресурс . Необходимый . Ссылка на файл с девятью исправлениями.

android:dither

Логическое значение . Включает или отключает сглаживание растрового изображения, если растровое изображение не имеет той же конфигурации пикселей, что и экран, например растровое изображение ARGB 8888 на экране RGB 565.

пример:

<?xml version="1.0" encoding="utf-8"?>
<nine-patch xmlns:android="http://schemas.android.com/apk/res/android"
    android:src="@drawable/myninepatch"
    android:dither="false" />

Список слоев

LayerDrawable — это объект рисования, который управляет массивом других объектов рисования. Каждый рисунок в списке рисуется в порядке списка. Последний объект в списке рисуется сверху.

Каждый объект рисования представлен элементом <item> внутри одного элемента <layer-list> .

расположение файла:

res/drawable/ filename .xml
Имя файла — это идентификатор ресурса.

тип данных скомпилированного ресурса:

Указатель ресурса на LayerDrawable

ссылка на ресурс:

В Java: R.drawable. filename
В XML: @[ package :]drawable/ filename

синтаксис:

<?xml version="1.0" encoding="utf-8"?>
<layer-list
    xmlns:android="http://schemas.android.com/apk/res/android" >
    <item
        android:drawable="@[package:]drawable/drawable_resource"
        android:id="@[+][package:]id/resource_name"
        android:top="dimension"
        android:right="dimension"
        android:bottom="dimension"
        android:left="dimension" />
</layer-list>

элементы:

<layer-list>

Необходимый. Это должен быть корневой элемент. Содержит один или несколько элементов <item> .

Атрибуты:

xmlns:android

Нить . Необходимый. Определяет пространство имен XML, которое должно иметь вид "http://schemas.android.com/apk/res/android" .

<item>

Определяет объект рисования для размещения в объекте рисования слоя в положении, определяемом его атрибутами. Должен быть дочерним элементом элемента <layer-list> . Принимает дочерние элементы <bitmap> .

Атрибуты:

android:drawable

Рисуемый ресурс . Необходимый . Ссылка на доступный ресурс.

android:id

Идентификатор ресурса . Уникальный идентификатор ресурса для этого объекта. Чтобы создать новый идентификатор ресурса для этого элемента, используйте форму: "@+id/ name " . Символ плюса указывает, что он создан как новый идентификатор. Вы можете использовать этот идентификатор для получения и изменения объекта рисования с помощью View.findViewById() или Activity.findViewById() .

android:top

Измерение . Верхнее смещение как значение размера или ресурс измерения .

android:right

Измерение . Правое смещение в виде значения измерения или ресурса измерения .

android:bottom

Измерение . Нижнее смещение в виде значения размера или ресурса измерения .

android:left

Измерение . Смещение слева в виде значения измерения или ресурса измерения .

По умолчанию все рисуемые элементы масштабируются в соответствии с размером содержащего их представления. Таким образом, размещение изображений в списке слоев в разных позициях может увеличить размер изображения, а некоторые изображения масштабируются соответствующим образом.

Чтобы избежать масштабирования элементов в списке, используйте элемент <bitmap> внутри элемента <item> , чтобы указать рисуемый объект и определить гравитацию для чего-то, что не масштабируется, например "center" . Например, следующий <item> определяет элемент, который масштабируется в соответствии с представлением контейнера:

<item android:drawable="@drawable/image" />

Чтобы избежать масштабирования, в следующем примере используется элемент <bitmap> с центрированной гравитацией:

<item>
  <bitmap android:src="@drawable/image"
          android:gravity="center" />
</item>

пример:

XML-файл, сохраненный в res/drawable/layers.xml :

<?xml version="1.0" encoding="utf-8"?>
<layer-list xmlns:android="http://schemas.android.com/apk/res/android">
    <item>
      <bitmap android:src="@drawable/android_red"
        android:gravity="center" />
    </item>
    <item android:top="10dp" android:left="10dp">
      <bitmap android:src="@drawable/android_green"
        android:gravity="center" />
    </item>
    <item android:top="20dp" android:left="20dp">
      <bitmap android:src="@drawable/android_blue"
        android:gravity="center" />
    </item>
</layer-list>

В этом примере используется вложенный элемент <bitmap> для определения рисуемого ресурса для каждого элемента с "center" силой тяжести. Это гарантирует, что ни одно из изображений не будет масштабировано в соответствии с размером контейнера из-за изменения размера, вызванного смещением изображений.

Этот XML-макет применяет возможность рисования к представлению:

<ImageView
    android:layout_height="wrap_content"
    android:layout_width="wrap_content"
    android:src="@drawable/layers" />

В результате получается стопка изображений со все большим смещением:

см. также:

• LayerDrawable

Государственный список

StateListDrawable — это объект с возможностью рисования, определенный в XML, который использует несколько изображений для представления одной и той же графики, в зависимости от состояния объекта. Например, виджет Button может находиться в состоянии касания, фокусировки или ни того, ни другого; используя рисуемый список состояний, вы можете предоставить различное фоновое изображение для каждого состояния.

Вы описываете список состояний в файле XML. Каждое изображение представлено элементом <item> внутри одного элемента <selector> . Каждый <item> использует различные атрибуты для описания состояния, в котором он используется в качестве изображения для рисуемого объекта.

При каждом изменении состояния список состояний просматривается сверху вниз и используется первый элемент, соответствующий текущему состоянию. Выбор основан не на «наилучшем совпадении», а на первом элементе, который соответствует минимальным критериям штата.

расположение файла:

res/drawable/ filename .xml
Имя файла — это идентификатор ресурса.

тип данных скомпилированного ресурса:

Указатель ресурса на StateListDrawable

ссылка на ресурс:

В Java: R.drawable. filename
В XML: @[ package :]drawable/ filename

синтаксис:

<?xml version="1.0" encoding="utf-8"?>
<selector xmlns:android="http://schemas.android.com/apk/res/android"
    android:constantSize=["true" | "false"]
    android:dither=["true" | "false"]
    android:variablePadding=["true" | "false"] >
    <item
        android:drawable="@[package:]drawable/drawable_resource"
        android:state_pressed=["true" | "false"]
        android:state_focused=["true" | "false"]
        android:state_hovered=["true" | "false"]
        android:state_selected=["true" | "false"]
        android:state_checkable=["true" | "false"]
        android:state_checked=["true" | "false"]
        android:state_enabled=["true" | "false"]
        android:state_activated=["true" | "false"]
        android:state_window_focused=["true" | "false"] />
</selector>

элементы:

<selector>

Необходимый. Это должен быть корневой элемент. Содержит один или несколько элементов <item> .

Атрибуты:

xmlns:android

Нить . Необходимый. Определяет пространство имен XML, которое должно иметь вид "http://schemas.android.com/apk/res/android" .

android:constantSize

Логическое значение . Истинно, если сообщаемый внутренний размер рисуемого объекта остается постоянным при изменении состояния (размер является максимальным из всех состояний); false, если размер меняется в зависимости от текущего состояния. По умолчанию — ложь.

android:dither

Логическое значение . Значение true, чтобы включить сглаживание растрового изображения, если растровое изображение не имеет той же конфигурации пикселей, что и экран, например растровое изображение ARGB 8888 на экране RGB 565; false, чтобы отключить сглаживание. По умолчанию верно.

android:variablePadding

Логическое значение . True, если заполнение рисуемого объекта изменяется в зависимости от текущего выбранного состояния; false, если заполнение должно оставаться прежним, исходя из максимального заполнения всех состояний. Включение этой функции требует, чтобы вы выполняли макет при изменении состояния, что часто не поддерживается. По умолчанию — ложь.

<item>

Определяет объект Drawable, который будет использоваться в определенных состояниях, как описано его атрибутами. Должен быть дочерним элементом элемента <selector> .

Атрибуты:

android:drawable

Рисуемый ресурс . Необходимый . Ссылка на доступный ресурс.

android:state_pressed

Логическое значение . True, если этот элемент используется при касании объекта, например при нажатии кнопки; false, если этот элемент используется в неиспользуемом состоянии по умолчанию.

android:state_focused

Логическое значение . True, если этот элемент используется, когда объект имеет фокус ввода, например, когда пользователь выбирает ввод текста; false, если этот элемент используется по умолчанию, в несфокусированном состоянии.

android:state_hovered

Логическое значение . True, если этот элемент используется при наведении курсора на объект; false, если этот элемент используется по умолчанию, без наведения. Часто этот объект рисования может быть тем же объектом, который используется для «сфокусированного» состояния.

Представлено на уровне API 14.

android:state_selected

Логическое значение . True, если этот элемент используется, когда объект является текущим выбором пользователя при навигации с помощью элемента управления направлением, например, при навигации по списку с помощью крестовины; false, если этот элемент используется, когда объект не выбран.

Выбранное состояние используется, когда android:state_focused недостаточно, например, когда представление списка имеет фокус и элемент внутри него выбирается с помощью D-pad.

android:state_checkable

Логическое значение . Истинно, если этот элемент используется, когда объект доступен для выбора; false, если этот элемент используется, когда объект недоступен для выбора. Полезно только в том случае, если объект может переходить между выбираемым и невыбираемым виджетом.

android:state_checked

Логическое значение . True, если этот элемент используется при выборе объекта; false, если он используется, когда объект не выбран.

android:state_enabled

Логическое значение . True, если этот элемент используется, когда объект включен, то есть способен получать события касания или щелчка; false, если он используется, когда объект отключен.

android:state_activated

Логическое значение . True, если этот элемент используется, когда объект активируется в качестве постоянного выбора, например, для «выделения» ранее выбранного элемента списка в постоянном представлении навигации; false, если он используется, когда объект не активирован.

Представлено на уровне API 11.

android:state_window_focused

Логическое значение . True, если этот элемент используется, когда окно приложения находится в фокусе, то есть приложение находится на переднем плане; false, если этот элемент используется, когда окно приложения не имеет фокуса, например, если шторка уведомления опущена или появляется диалоговое окно.

Примечание. Android применяет первый элемент в списке состояний, соответствующий текущему состоянию объекта. Таким образом, если первый элемент в списке не содержит ни одного из предыдущих атрибутов состояния, он применяется каждый раз. Вот почему вы хотите, чтобы значение по умолчанию всегда было последним, как показано в следующем примере.

пример:

XML-файл, сохраненный в res/drawable/button.xml :

<?xml version="1.0" encoding="utf-8"?>
<selector xmlns:android="http://schemas.android.com/apk/res/android">
    <item android:state_pressed="true"
          android:drawable="@drawable/button_pressed" /> <!-- pressed -->
    <item android:state_focused="true"
          android:drawable="@drawable/button_focused" /> <!-- focused -->
    <item android:state_hovered="true"
          android:drawable="@drawable/button_focused" /> <!-- hovered -->
    <item android:drawable="@drawable/button_normal" /> <!-- default -->
</selector>

Этот XML-макет применяет список состояний, который можно нарисовать к кнопке:

<Button
    android:layout_height="wrap_content"
    android:layout_width="wrap_content"
    android:background="@drawable/button" />

см. также:

• StateListDrawable

Список уровней

Drawable, который управляет несколькими альтернативными drawables, каждому из которых присвоено максимальное числовое значение. Установка значения уровня объекта drawable с помощью setLevel() загружает ресурс drawable в список уровней, значение которого android:maxLevel больше или равно значению, переданному методу.

расположение файла:

res/drawable/ filename .xml
Имя файла — это идентификатор ресурса.

тип данных скомпилированного ресурса:

Указатель ресурса на LevelListDrawable

ссылка на ресурс:

В Java: R.drawable. filename
В XML: @[ package :]drawable/ filename

синтаксис:

<?xml version="1.0" encoding="utf-8"?>
<level-list
    xmlns:android="http://schemas.android.com/apk/res/android" >
    <item
        android:drawable="@drawable/drawable_resource"
        android:maxLevel="integer"
        android:minLevel="integer" />
</level-list>

элементы:

<level-list>

Необходимый. Это должен быть корневой элемент. Содержит один или несколько элементов <item> .

Атрибуты:

xmlns:android

Нить . Необходимый. Определяет пространство имен XML, которое должно иметь вид "http://schemas.android.com/apk/res/android" .

<item>

Определяет объект для использования на определенном уровне.

Атрибуты:

android:drawable

Рисуемый ресурс . Необходимый . Ссылка на доступный ресурс для вставки.

android:maxLevel

Целое число . Максимальный уровень, разрешенный для этого предмета.

android:minLevel

Целое число . Минимальный уровень, разрешенный для этого предмета.

пример:

<?xml version="1.0" encoding="utf-8"?>
<level-list xmlns:android="http://schemas.android.com/apk/res/android" >
    <item
        android:drawable="@drawable/status_off"
        android:maxLevel="0" />
    <item
        android:drawable="@drawable/status_on"
        android:maxLevel="1" />
</level-list>

Как только это будет применено к View , уровень можно будет изменить с помощью setLevel() или setImageLevel() .

см. также:

• LevelListDrawable

Переход с возможностью рисования

TransitionDrawable — это рисуемый объект, который может плавно переходить между двумя другими рисуемыми ресурсами.

Каждый объект рисования представлен элементом <item> внутри одного элемента <transition> . Поддерживается не более двух элементов. Чтобы перейти вперед, вызовите startTransition() . Чтобы перейти назад, вызовите reverseTransition() .

расположение файла:

res/drawable/ filename .xml
Имя файла — это идентификатор ресурса.

тип данных скомпилированного ресурса:

Указатель ресурса на TransitionDrawable

ссылка на ресурс:

В Java: R.drawable. filename
В XML: @[ package :]drawable/ filename

синтаксис:

<?xml version="1.0" encoding="utf-8"?>
<transition
xmlns:android="http://schemas.android.com/apk/res/android" >
    <item
        android:drawable="@[package:]drawable/drawable_resource"
        android:id="@[+][package:]id/resource_name"
        android:top="dimension"
        android:right="dimension"
        android:bottom="dimension"
        android:left="dimension" />
</transition>

элементы:

<transition>

Необходимый. Это должен быть корневой элемент. Содержит один или несколько элементов <item> .

Атрибуты:

xmlns:android

Нить . Необходимый. Определяет пространство имен XML, которое должно иметь вид "http://schemas.android.com/apk/res/android" .

<item>

Определяет объект рисования, который будет использоваться как часть рисуемого перехода. Должен быть дочерним элементом элемента <transition> . Принимает дочерние элементы <bitmap> .

Атрибуты:

android:drawable

Рисуемый ресурс . Необходимый . Ссылка на доступный ресурс.

android:id

Идентификатор ресурса . Уникальный идентификатор ресурса для этого объекта. Чтобы создать новый идентификатор ресурса для этого элемента, используйте форму: "@+id/ name " . Символ плюса указывает, что он создан как новый идентификатор. Вы можете использовать этот идентификатор для получения и изменения объекта рисования с помощью View.findViewById() или Activity.findViewById() .

android:top

Целое число . Верхнее смещение в пикселях.

android:right

Целое число . Правое смещение в пикселях.

android:bottom

Целое число . Нижнее смещение в пикселях.

android:left

Целое число . Смещение слева в пикселях.

пример:

XML-файл, сохраненный в res/drawable/transition.xml :

<?xml version="1.0" encoding="utf-8"?>
<transition xmlns:android="http://schemas.android.com/apk/res/android">
    <item android:drawable="@drawable/on" />
    <item android:drawable="@drawable/off" />
</transition>

Этот XML-макет применяет возможность рисования к представлению:

<ImageButton
    android:id="@+id/button"
    android:layout_height="wrap_content"
    android:layout_width="wrap_content"
    android:src="@drawable/transition" />

А следующий код выполняет переход за 500 мс от первого элемента ко второму:

Котлин

val button: ImageButton = findViewById(R.id.button)
val drawable: Drawable = button.drawable
if (drawable is TransitionDrawable) {
    drawable.startTransition(500)
}

Ява

ImageButton button = (ImageButton) findViewById(R.id.button);
Drawable drawable = button.getDrawable();
if (drawable instanceof TransitionDrawable) {
    ((TransitionDrawable) drawable).startTransition(500);
}

см. также:

• TransitionDrawable

Вставка выдвижная

Объект рисования, определенный в XML, который вставляет другой объект рисования на указанное расстояние. Это полезно, когда для представления требуется фон, который меньше фактических границ представления.

расположение файла:

res/drawable/ filename .xml
Имя файла — это идентификатор ресурса.

тип данных скомпилированного ресурса:

Указатель ресурса на InsetDrawable

ссылка на ресурс:

В Java: R.drawable. filename
В XML: @[ package :]drawable/ filename

синтаксис:

<?xml version="1.0" encoding="utf-8"?>
<inset
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:drawable="@drawable/drawable_resource"
    android:insetTop="dimension"
    android:insetRight="dimension"
    android:insetBottom="dimension"
    android:insetLeft="dimension" />

элементы:

<inset>

Необходимый. Определяет возможность рисования вставки. Это должен быть корневой элемент.

Атрибуты:

xmlns:android

Нить . Необходимый. Определяет пространство имен XML, которое должно иметь вид "http://schemas.android.com/apk/res/android" .

android:drawable

Рисуемый ресурс . Необходимый . Ссылка на доступный ресурс для вставки.

android:insetTop

Измерение . Верхняя вставка — значение измерения или ресурс измерения .

android:insetRight

Измерение . Правая вставка в виде значения измерения или ресурса измерения .

android:insetBottom

Измерение . Нижняя вставка — значение измерения или ресурс измерения .

android:insetLeft

Измерение . Левая вставка — значение измерения или ресурс измерения .

пример:

<?xml version="1.0" encoding="utf-8"?>
<inset xmlns:android="http://schemas.android.com/apk/res/android"
    android:drawable="@drawable/background"
    android:insetTop="10dp"
    android:insetLeft="10dp" />

см. также:

• InsetDrawable

Клип выдвижной

Объект рисования, определенный в XML, который отсекает другой объект рисования на основе текущего уровня этого объекта рисования. Вы можете контролировать, насколько обрезается дочерний объект по ширине и высоте в зависимости от уровня, а также гравитацию, чтобы контролировать, где он размещается в общем контейнере. Чаще всего используется для реализации таких вещей, как индикаторы выполнения.

расположение файла:

res/drawable/ filename .xml
Имя файла — это идентификатор ресурса.

тип данных скомпилированного ресурса:

Указатель ресурса на ClipDrawable

ссылка на ресурс:

В Java: R.drawable. filename
В XML: @[ package :]drawable/ filename

синтаксис:

<?xml version="1.0" encoding="utf-8"?>
<clip
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:drawable="@drawable/drawable_resource"
    android:clipOrientation=["horizontal" | "vertical"]
    android:gravity=["top" | "bottom" | "left" | "right" | "center_vertical" |
                     "fill_vertical" | "center_horizontal" | "fill_horizontal" |
                     "center" | "fill" | "clip_vertical" | "clip_horizontal"] />

элементы:

<clip>

Необходимый. Определяет клип, который можно рисовать. Это должен быть корневой элемент.

Атрибуты:

xmlns:android

Нить . Необходимый. Определяет пространство имен XML, которое должно иметь вид "http://schemas.android.com/apk/res/android" .

android:drawable

Рисуемый ресурс . Необходимый . Ссылка на ресурс, который можно обрезать.

android:clipOrientation

Ключевое слово . Ориентация клипа.

Должно быть одно из следующих постоянных значений:

Ценить	Описание
horizontal	Закрепите выдвижной элемент горизонтально.
vertical	Закрепите вытягиваемый вертикально.

android:gravity

Ключевое слово . Указывает, где обрезать рисунок.

Должно быть одно или несколько из следующих значений констант, разделенных | :

Ценить	Описание
top	Поместите объект вверху контейнера, не меняя его размера. Когда clipOrientation имеет значение "vertical" , обрезка происходит в нижней части рисуемого объекта.
bottom	Поместите объект на дно контейнера, не меняя его размера. Когда clipOrientation имеет значение "vertical" , обрезка происходит в верхней части рисуемого объекта.
left	Поместите объект у левого края контейнера, не меняя его размера. Это значение по умолчанию. Когда clipOrientation имеет значение "horizontal" , обрезка происходит с правой стороны рисуемого объекта.
right	Поместите объект у правого края контейнера, не меняя его размера. Когда clipOrientation имеет значение "horizontal" , обрезка происходит с левой стороны рисуемого объекта.
center_vertical	Поместите объект в вертикальный центр его контейнера, не меняя его размера. Отсечение ведет себя так же, как и в случае, когда гравитация находится в "center" .
fill_vertical	При необходимости увеличьте вертикальный размер объекта, чтобы он полностью заполнил контейнер. Когда clipOrientation имеет значение "vertical" , обрезка не происходит, поскольку рисуемый объект заполняет вертикальное пространство (если только уровень рисования не равен 0, в этом случае он не виден).
center_horizontal	Поместите объект в горизонтальный центр его контейнера, не меняя его размера. Отсечение ведет себя так же, как и в случае, когда гравитация находится в "center" .
fill_horizontal	При необходимости увеличьте горизонтальный размер объекта, чтобы он полностью заполнил контейнер. Когда clipOrientation имеет значение "horizontal" , обрезка не происходит, поскольку рисуемый объект заполняет горизонтальное пространство (если только уровень рисования не равен 0, в этом случае он не виден).
center	Поместите объект в центр контейнера как по вертикальной, так и по горизонтальной оси, не меняя его размера. Когда clipOrientation имеет значение "horizontal" , обрезка происходит слева и справа. Когда clipOrientation имеет значение "vertical" , обрезка происходит сверху и снизу.
fill	При необходимости увеличьте горизонтальный и вертикальный размер объекта, чтобы он полностью заполнил контейнер. Никакого отсечения не происходит, поскольку рисуемый объект заполняет горизонтальное и вертикальное пространство (если только уровень рисования не равен 0, в этом случае он не виден).
clip_vertical	Дополнительная опция, которую можно настроить так, чтобы верхние и/или нижние края дочернего элемента были обрезаны до границ его контейнера. Зажим основан на вертикальной силе тяжести: верхняя сила тяжести зажимает нижний край, нижняя сила тяжести зажимает верхний край, и ни один из них не зажимает оба края.
clip_horizontal	Дополнительная опция, которую можно настроить так, чтобы левый и/или правый края дочернего элемента были обрезаны до границ его контейнера. Зажим основан на горизонтальной силе тяжести: левая сила тяжести зажимает правый край, правая сила тяжести зажимает левый край, и ни один из них не зажимает оба края.

пример:

XML-файл, сохраненный в res/drawable/clip.xml :

<?xml version="1.0" encoding="utf-8"?>
<clip xmlns:android="http://schemas.android.com/apk/res/android"
    android:drawable="@drawable/android"
    android:clipOrientation="horizontal"
    android:gravity="left" />

Следующий XML макета применяет клип, который можно рисовать, к представлению:

<ImageView
    android:id="@+id/image"
    android:src="@drawable/clip"
    android:layout_height="wrap_content"
    android:layout_width="wrap_content" />

Следующий код получает возможность рисования и увеличивает объем обрезки для постепенного раскрытия изображения:

Котлин

val imageview: ImageView = findViewById(R.id.image)
val drawable: Drawable = imageview.background
if (drawable is ClipDrawable) {
    drawable.level = drawable.level + 1000
}

Ява

ImageView imageview = (ImageView) findViewById(R.id.image);
Drawable drawable = imageview.getBackground();
if (drawable instanceof ClipDrawable) {
    ((ClipDrawable)drawable).setLevel(drawable.getLevel() + 1000);
}

Увеличение уровня уменьшает количество обрезки и медленно раскрывает изображение. Вот он на уровне 7000:

Примечание. Уровень по умолчанию — 0, который полностью обрезается, поэтому изображение не видно. Когда уровень равен 10 000, изображение не обрезается и полностью видно.

см. также:

• ClipDrawable

Масштабируемый

Объект рисования, определенный в XML, который изменяет размер другого объекта рисования в зависимости от его текущего уровня.

расположение файла:

res/drawable/ filename .xml
Имя файла — это идентификатор ресурса.

тип данных скомпилированного ресурса:

Указатель ресурса на ScaleDrawable

ссылка на ресурс:

В Java: R.drawable. filename
В XML: @[ package :]drawable/ filename

синтаксис:

<?xml version="1.0" encoding="utf-8"?>
<scale
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:drawable="@drawable/drawable_resource"
    android:scaleGravity=["top" | "bottom" | "left" | "right" | "center_vertical" |
                          "fill_vertical" | "center_horizontal" | "fill_horizontal" |
                          "center" | "fill" | "clip_vertical" | "clip_horizontal"]
    android:scaleHeight="percentage"
    android:scaleWidth="percentage" />

элементы:

<scale>

Необходимый. Определяет масштаб рисования. Это должен быть корневой элемент.

Атрибуты:

xmlns:android

Нить . Необходимый. Определяет пространство имен XML, которое должно иметь вид "http://schemas.android.com/apk/res/android" .

android:drawable

Рисуемый ресурс . Необходимый . Ссылка на доступный ресурс.

android:scaleGravity

Ключевое слово . Указывает положение гравитации после масштабирования.

Должно быть одно или несколько из следующих значений констант, разделенных | :

Ценить	Описание
top	Поместите объект вверху контейнера, не меняя его размера.
bottom	Поместите объект на дно контейнера, не меняя его размера.
left	Поместите объект у левого края контейнера, не меняя его размера. Это значение по умолчанию.
right	Поместите объект у правого края контейнера, не меняя его размера.
center_vertical	Поместите объект в вертикальный центр его контейнера, не меняя его размера.
fill_vertical	При необходимости увеличьте вертикальный размер объекта, чтобы он полностью заполнил контейнер.
center_horizontal	Поместите объект в горизонтальный центр его контейнера, не меняя его размера.
fill_horizontal	При необходимости увеличьте горизонтальный размер объекта, чтобы он полностью заполнил контейнер.
center	Поместите объект в центр контейнера как по вертикальной, так и по горизонтальной оси, не меняя его размера.
fill	При необходимости увеличьте горизонтальный и вертикальный размер объекта, чтобы он полностью заполнил контейнер.
clip_vertical	Дополнительная опция, которую можно настроить так, чтобы верхние и/или нижние края дочернего элемента были обрезаны до границ его контейнера. Зажим основан на вертикальной силе тяжести: верхняя сила тяжести зажимает нижний край, нижняя сила тяжести зажимает верхний край, и ни один из них не зажимает оба края.
clip_horizontal	Дополнительная опция, которую можно настроить так, чтобы левый и/или правый края дочернего элемента были обрезаны до границ его контейнера. Зажим основан на горизонтальной силе тяжести: левая сила тяжести зажимает правый край, правая сила тяжести зажимает левый край, и ни один из них не зажимает оба края.

android:scaleHeight

Процент . Высота шкалы, выраженная в процентах от границы рисуемого объекта. Формат значения — XX%, например 100% или 12,5%.

android:scaleWidth

Процент . Ширина шкалы, выраженная в процентах от границы рисуемого объекта. Формат значения — XX%, например 100% или 12,5%.

пример:

<?xml version="1.0" encoding="utf-8"?>
<scale xmlns:android="http://schemas.android.com/apk/res/android"
    android:drawable="@drawable/logo"
    android:scaleGravity="center_vertical|center_horizontal"
    android:scaleHeight="80%"
    android:scaleWidth="80%" />

см. также:

• ScaleDrawable

Рисуемая форма

Это общая форма, определенная в XML.

расположение файла:

res/drawable/ filename .xml
Имя файла — это идентификатор ресурса.

тип данных скомпилированного ресурса:

Указатель ресурса на GradientDrawable

ссылка на ресурс:

В Java: R.drawable. filename
В XML: @[ package :]drawable/ filename

синтаксис:

<?xml version="1.0" encoding="utf-8"?>
<shape
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:shape=["rectangle" | "oval" | "line" | "ring"] >
    <corners
        android:radius="integer"
        android:topLeftRadius="integer"
        android:topRightRadius="integer"
        android:bottomLeftRadius="integer"
        android:bottomRightRadius="integer" />
    <gradient
        android:angle="integer"
        android:centerX="float"
        android:centerY="float"
        android:centerColor="integer"
        android:endColor="color"
        android:gradientRadius="integer"
        android:startColor="color"
        android:type=["linear" | "radial" | "sweep"]
        android:useLevel=["true" | "false"] />
    <padding
        android:left="integer"
        android:top="integer"
        android:right="integer"
        android:bottom="integer" />
    <size
        android:width="integer"
        android:height="integer" />
    <solid
        android:color="color" />
    <stroke
        android:width="integer"
        android:color="color"
        android:dashWidth="integer"
        android:dashGap="integer" />
</shape>

элементы:

<shape>

Необходимый. Рисуемая форма. Это должен быть корневой элемент.

Атрибуты:

xmlns:android

Нить . Необходимый. Определяет пространство имен XML, которое должно иметь вид "http://schemas.android.com/apk/res/android" .

android:shape

Ключевое слово . Определяет тип фигуры. Допустимые значения:

Ценить	Описание
"rectangle"	Прямоугольник, заполняющий содержащее его представление. Это форма по умолчанию.
"oval"	Овальная форма, соответствующая размерам содержащего представления.
"line"	Горизонтальная линия, охватывающая ширину содержащего представления. Для этой формы требуется элемент <stroke> , чтобы определить ширину линии.
"ring"	Форма кольца.

Следующие атрибуты используются только при android:shape="ring" :

android:innerRadius

Измерение . Радиус внутренней части кольца (отверстие посередине) как значение размера или ресурс размера .

android:innerRadiusRatio

Плавать . Радиус внутренней части кольца, выраженный как отношение ширины кольца. Например, если android:innerRadiusRatio="5" , то внутренний радиус равен ширине кольца, разделенной на 5. Это значение переопределяется android:innerRadius . Значение по умолчанию — 9.

android:thickness

Измерение . Толщина кольца как значение размера или ресурс размера .

android:thicknessRatio

Плавать . Толщина кольца выражается как отношение ширины кольца. Например, если android:thicknessRatio="2" , то толщина равна ширине кольца, разделенной на 2. Это значение переопределяется android:innerRadius . Значение по умолчанию — 3.

android:useLevel

Логическое значение . True, если это используется как LevelListDrawable . Обычно это неверно, иначе ваша фигура может не появиться.

<corners>

Создает закругленные углы фигуры. Применяется только в том случае, если фигура представляет собой прямоугольник.

Атрибуты:

android:radius

Измерение . Радиус для всех углов в виде значения размера или ресурса размера . Это переопределяется для каждого угла следующими атрибутами.

android:topLeftRadius

Измерение . Радиус верхнего левого угла в виде значения размера или ресурса измерения .

android:topRightRadius

Измерение . Радиус верхнего правого угла в виде значения размера или ресурса измерения .

android:bottomLeftRadius

Измерение . Радиус нижнего левого угла в виде значения размера или ресурса измерения .

android:bottomRightRadius

Измерение . Радиус правого нижнего угла в виде значения размера или ресурса измерения .

Примечание. Изначально каждый угол должен иметь радиус угла больше 1, иначе углы не будут закруглены. Если вы хотите, чтобы определенные углы не были закруглены, обходным путем является использование android:radius чтобы установить радиус угла по умолчанию больше 1, а затем переопределить каждый угол значениями, которые вам действительно нужны, указав 0 («0dp») там, где вы этого не делаете. Мне не нужны закругленные углы.

<gradient>

Задает цвет градиента для фигуры.

Атрибуты:

android:angle

Целое число . Угол градиента в градусах. 0 слева направо, 90 снизу вверх. Оно должно быть кратно 45. Значение по умолчанию — 0.

android:centerX

Плавать . Относительное X-положение центра градиента (0–1,0).

android:centerY

Плавать . Относительное положение по оси Y центра градиента (0–1,0).

android:centerColor

Цвет . Необязательный цвет, который находится между начальным и конечным цветами в виде шестнадцатеричного значения или ресурса цвета .

android:endColor

Цвет . Конечный цвет в виде шестнадцатеричного значения или ресурса цвета .

android:gradientRadius

Плавать . Радиус градиента. Применяется только тогда, когда android:type="radial" .

android:startColor

Цвет . Начальный цвет в виде шестнадцатеричного значения или ресурса цвета .

android:type

Ключевое слово . Тип применяемого шаблона градиента. Допустимые значения:

Ценить	Описание
"linear"	Линейный градиент. Это значение по умолчанию.
"radial"	Радиальный градиент. Начальный цвет — это центральный цвет.
"sweep"	Широкая линия градиента.

android:useLevel

Логическое значение . True, если это используется как LevelListDrawable .

<padding>

Заполнение, применяемое к содержащему элементу представления. Это дополняет положение содержимого представления, а не формы.

Атрибуты:

android:left

Измерение . Заполнение слева в качестве значения измерения или ресурса измерения .

android:top

Измерение . Верхнее дополнение в качестве значения измерения или ресурса измерения .

android:right

Измерение . Заполнение справа в качестве значения измерения или ресурса измерения .

android:bottom

Измерение . Нижнее дополнение в качестве значения измерения или ресурса измерения .

<size>

Размер формы.

Атрибуты:

android:height

Измерение . Высота фигуры как значение размера или ресурс измерения .

android:width

Измерение . Ширина фигуры как значение размера или ресурс измерения .

Примечание. По умолчанию фигура масштабируется до размера представления контейнера, пропорционального определенным здесь размерам. Когда вы используете фигуру в ImageView , вы можете ограничить масштабирование, установивandroid:scaleType значение "center" .

<solid>

Сплошной цвет для заполнения формы.

Атрибуты:

android:color

Цвет . Цвет, применяемый к фигуре, в виде шестнадцатеричного значения или ресурса цвета .

<stroke>

Линия обводки фигуры.

Атрибуты:

android:width

Измерение . Толщина линии как значение размера или ресурс измерения .

android:color

Цвет . Цвет линии в виде шестнадцатеричного значения или ресурса цвета .

android:dashGap

Измерение . Расстояние между штрихами линий как значение размера или ресурс измерения . Действует только в том случае, если установлен android:dashWidth .

android:dashWidth

Измерение . Размер каждой пунктирной линии как значения измерения или ресурса измерения . Действует только в том случае, если установлен android:dashGap .

пример:

XML-файл, сохраненный в res/drawable/gradient_box.xml :

<?xml version="1.0" encoding="utf-8"?>
<shape xmlns:android="http://schemas.android.com/apk/res/android"
    android:shape="rectangle">
    <gradient
        android:startColor="#FFFF0000"
        android:endColor="#80FF00FF"
        android:angle="45"/>
    <padding android:left="7dp"
        android:top="7dp"
        android:right="7dp"
        android:bottom="7dp" />
    <corners android:radius="8dp" />
</shape>

Этот XML макета применяет фигуру, которую можно рисовать, к представлению:

<TextView
    android:background="@drawable/gradient_box"
    android:layout_height="wrap_content"
    android:layout_width="wrap_content" />

Этот код приложения получает фигуру, которую можно нарисовать, и применяет ее к представлению:

Котлин

val shape: Drawable? = getDrawable(resources, R.drawable.gradient_box, getTheme())

val tv: TextView = findViewById(R.id.textview)
tv.background = shape

Ява

Resources res = getResources();
Drawable shape = ResourcesCompat.getDrawable(res, R.drawable.gradient_box, getTheme());

TextView tv = (TextView)findViewById(R.id.textview);
tv.setBackground(shape);

см. также:

• ShapeDrawable