Эта страница переведена с помощью Cloud Translation API.

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

Рисуемый ресурс — это общая концепция графики, которую можно нарисовать на экране и которую можно получить с помощью 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);

см. также:

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" />

см. также:

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

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" />

см. также:

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"] />

элементы:

пример:

<?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>

элементы:

пример:

<?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>

элементы:

пример:

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" />

элементы:

пример:

<?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

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

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

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

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

Color state list

Layout

Доступные ресурсы Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

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

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

Котлин

Ява

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

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

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

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

Список слоев

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

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

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

Котлин

Ява

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

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

Котлин

Ява

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

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

Котлин

Ява

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