Ta strona została przetłumaczona przez Cloud Translation API.

Zasoby rysowalne
Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Zasób rysowalny to ogólna koncepcja grafiki, którą można narysować na ekranie. można pobrać za pomocą interfejsów API, takich jak getDrawable(int), lub do innego zasobu XML o takich atrybutach jak android:drawable i android:icon. Jest kilka rodzajów elementów, które można przeciągać:

Plik bitmapowy
: Plik graficzny z bitmapą (PNG, WEBP, JPG lub GIF). Tworzy BitmapDrawable.
Plik dziewięć poprawek: Plik PNG z rozciąganymi obszarami, które pozwalają zmieniać rozmiar obrazów odpowiednio do treści (.9.png). Tworzy NinePatchDrawable.
Lista warstw: Element rysowalny, który zarządza tablicą innych obiektów rysowalnych. Są one rysowane w kolejności tablicy, więc na początku jest rysowany element o największym indeksie. Tworzy LayerDrawable.
Lista stanów: Plik XML odwołujący się do innej grafiki bitmapowej dla różnych stanów, aby na przykład użyć innego obrazu po naciśnięciu przycisku. Tworzy StateListDrawable.
Lista poziomów: Plik XML definiujący element rysowalny, który zarządza licznymi alternatywnymi elementami, z których każdy mają przypisaną maksymalną wartość liczbową. Tworzy LevelListDrawable.
Przejście z możliwością rysowania: Plik XML określający obiekt rysowalny, który może przełączać się między 2 zasobami rysowalnymi. Tworzy TransitionDrawable.
Wektor rysowalny: Plik XML określający obiekt rysowalny, który wstawia inny obiekt rysowalny o określonej odległości. Jest to przydatne, gdy w widoku trzeba narysować tło mniejsze niż rzeczywisty granic.
Klip, który można rysować: Plik XML określający element rysowalny, który przycina kolejny obiekt rysowalny na podstawie obiektu bieżącej wartości. Tworzy ClipDrawable.
Skala rysowalna: Plik XML definiujący element rysowalny, który zmienia rozmiar innego obiektu, w zależności od jego bieżącej wartości. Tworzy ScaleDrawable
Kształt rysowalny.: Plik XML określający kształt geometryczny, w tym kolory i gradienty. Tworzy GradientDrawable.

Dowiedz się, jak utwórz: AnimationDrawable, zobacz dokument Zasoby animacji.

Uwaga: zasób kolorów może być też używany jako obiekt rysowalny w kodzie XML. Na przykład podczas tworzenia listy stanów obiekt rysowalny, możesz odwoływać się do zasobu koloru dla atrybutu android:drawable (android:drawable="@color/green").

Bitmapa

Obraz bitmapy. Android obsługuje pliki mapy bitowej w tych formatach: PNG (preferowany), WEBP (preferowany, wymaga interfejsu API na poziomie 17 lub wyższym), JPG (akceptowalny), GIF (zalecany).

Możesz odwołać się bezpośrednio do pliku bitmapy, używając nazwy pliku jako identyfikatora zasobu lub utworzyć identyfikator zasobu aliasu w pliku XML.

Uwaga: pliki bitmap mogą być automatycznie optymalizowane w formacie bezstratnym kompresję obrazu za pomocą narzędzia aapt. Dla: Na przykład plik PNG o prawdziwym kolorze, który nie wymaga więcej niż 256 kolorów, może zostać przekonwertowany na 8-bitowy. PNG z paletą kolorów. W ten sposób uzyskujesz obraz o takiej samej jakości, który wymaga mniej pamięci.

Pamiętaj więc, że pliki binarne obrazów umieszczone w tym katalogu mogą się zmieniać podczas kompilacji. Jeśli Planujesz odczytać obraz jako strumień bitowy, aby przekonwertować go na bitmapę, folder res/raw/, który nie jest zoptymalizowany.

Plik bitmapy

Plik bitmapy to plik w formacie PNG, WEBP, JPG lub GIF. Android tworzy Drawable w dowolnym z tych plików po zapisaniu ich w katalogu res/drawable/.

lokalizacja pliku:

res/drawable/filename.png (.png, .webp, .jpg lub .gif)
Nazwa pliku to identyfikator zasobu

skompilowany typ danych zasobu:

Wskaźnik zasobu BitmapDrawable

odniesienie do zasobu:

W języku Java: R.drawable.filename
W pliku XML: @[package:]drawable/filename

przykład:

Z obrazem zapisanym pod adresem res/drawable/myimage.png zastosowano ten układ XML obraz w widoku:

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

Ten kod aplikacji pobiera obraz w postaci pliku Drawable:

Kotlin

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

Java

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

zobacz też:

Bitmapa XML

Bitmapa XML to zasób zdefiniowany w kodzie XML, który wskazuje plik bitmapy. Efekt to alias dla nieprzetworzonego pliku bitmapy. Plik XML może określać dodatkowe właściwości bitmapy, takie jak dithering i kafelki.

Uwaga: elementu możesz używać jako elementu podrzędnego element . Dla: np. podczas tworzenia listy stanów lub listy warstw, możesz wykluczyć android:drawable z elementu i zagnieździć w nim element . definiujący element rysowalny.

lokalizacja pliku:

res/drawable/filename.xml) Nazwa pliku to identyfikator zasobu

skompilowany typ danych zasobu:

Wskaźnik zasobu BitmapDrawable

odniesienie do zasobu:

W języku Java: R.drawable.filename
W pliku XML: @[package:]drawable/filename

składnia:

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

elementy:

Wymagane. Określa źródło mapy bitowej i jego właściwości.

Atrybuty:

xmlns:android

Ciąg znaków. Definiuje przestrzeń nazw XML, którą musi być "http://schemas.android.com/apk/res/android" Jest to wymagane tylko wtedy, gdy Elementem głównym jest . Nie jest potrzebny, gdy Element jest zagnieżdżony w elemencie .

android:src

Zasób rysowalny. Wymagany. Odniesienie do elementu rysowalnego .

android:antialias

Wartość logiczna. Włącza lub wyłącza antyaliasing.

android:dither

Wartość logiczna. Włącza lub wyłącza rozpraszanie bitmapy, jeśli nie jest to możliwe mają taką samą konfigurację pikseli jak ekran, na przykład mapę bitową ARGB 8888 na modelu RGB 565. ekranu.

android:filter

Wartość logiczna. Włącza lub wyłącza filtrowanie bitmapy. Filtrowanie jest używane, gdy bitmapa jest zmniejszona lub rozciągnięta w celu wygładzenia.

android:gravity

Słowo kluczowe. Definiuje grawitację dla bitmapy. Grawitacja wskazuje, gdzie umieść obiekt rysowalny w kontenerze, jeśli mapa bitowa jest mniejsza niż kontener.

Musi to być co najmniej jedna z tych wartości stałych rozdzielonych znakiem |:

Wartość	Opis
`top`	Umieść obiekt na górze kontenera, nie zmieniając jego rozmiaru.
`bottom`	Umieść obiekt na dole kontenera, nie zmieniając jego rozmiaru.
`left`	Umieść obiekt przy lewej krawędzi kontenera, nie zmieniając jego rozmiaru.
`right`	Umieść obiekt przy prawej krawędzi kontenera, nie zmieniając jego rozmiaru.
`center_vertical`	Umieść obiekt na środku kontenera w pionie, nie zmieniając jego rozmiaru.
`fill_vertical`	W razie potrzeby zwiększ pionowy rozmiar obiektu, aby wypełnił cały kontener.
`center_horizontal`	Umieść obiekt na środku kontenera w poziomie, nie zmieniając jego rozmiaru.
`fill_horizontal`	W razie potrzeby powiększ obiekt w poziomie, aby wypełnił cały kontener.
`center`	Umieść obiekt na środku kontenera na osi pionowej i poziomej, i jego rozmiaru.
`fill`	W razie potrzeby zwiększ rozmiar obiektu w poziomie i pionie, aby wypełnił cały obszar kontenera. Jest to ustawienie domyślne.
`clip_vertical`	Dodatkowa opcja, w ramach której można przyciąć górne lub dolne krawędzie elementu podrzędnego granic swojego kontenera. Klip jest oparty na grawitacji pionowej: górna grawitacja przycina dolna krawędź grawitacja przycina górną, ale żadna z nich nie przycina obu.
`clip_horizontal`	Dodatkowa opcja, w ramach której można przyciąć lewe lub prawe krawędzie elementu podrzędnego granic swojego kontenera. Klip jest oparty na grawitacji poziomej: lewa grawitacja prawa grawitacja przycina lewą krawędź, ale żadna z nich nie przycina obu.

android:mipMap

Wartość logiczna. Włącza lub wyłącza wskazówkę dotyczącą mipmap. Aby dowiedzieć się więcej, przeczytaj setHasMipMap(). Wartość domyślna to false (fałsz).

android:tileMode

Słowo kluczowe. Określa tryb kafelka. Gdy włączony jest tryb kafelków, bitmapa jest powtórzenia. Grawitacja jest ignorowana po włączeniu trybu kafelka.

Musi mieć jedną z tych stałych wartości:

Wartość	Opis
`disabled`	Nie kafelkuj bitmapy. jest to wartość domyślna
`clamp`	Replikuj kolor krawędzi, jeśli cieniowanie wykracza poza pierwotne granice
`repeat`	Powtórz obraz cieniowania w poziomie i pionie.
`mirror`	Powtórz obraz w cieniu w poziomie i pionie, naprzemienne lustrzane odbicia. sąsiednie obrazy są zawsze łączone.

przykład:

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

zobacz też:

9 poprawek

NinePatch to obraz PNG, w którym można zdefiniować obszary rozciągane które Android skaluje, gdy zawartość widoku wykracza poza normalne granice obrazu. Ty zazwyczaj przypisują ten typ obrazu jako tło widoku, który ma co najmniej jeden zestaw wymiarów do "wrap_content".

Gdy widok powiększa się w celu dopasowania do treści, pojawia się jest również skalowany do rozmiaru widoku. Przykładem użycia obrazu z 9 poprawkami jest tło używane przez standardowy widżet Button na Androida, który musi się rozciągać do umieść tekst (lub obraz) wewnątrz przycisku.

Tak jak w przypadku zwykłej bitmapy, możesz odwoływać się bezpośrednio do pliku z 9 poprawkami lub z zasobu zdefiniowanego przez kod XML.

Pełną dyskusję na temat tworzenia pliku z dziewięcioma poprawkami z rozciąganymi regionami Zobacz Tworzenie map bitowych z możliwością zmiany rozmiaru (pliki z 9 poprawkami).

Plik z 9 poprawkami

lokalizacja pliku:

res/drawable/filename.9.png) Nazwa pliku to identyfikator zasobu

skompilowany typ danych zasobu:

Wskaźnik zasobu NinePatchDrawable

odniesienie do zasobu:

W języku Java: R.drawable.filename
W pliku XML: @[package:]drawable/filename

przykład:

Z obrazem zapisanym o res/drawable/myninepatch.9.png, ten układ XML stosuje dziewięć poprawek do widoku:

zobacz też:

9-poprawka XML

Kod XML „9-patch” to zasób zdefiniowany w kodzie XML, który wskazuje plik z 9 poprawkami. Plik XML może i określać Dithering dla obrazu.

lokalizacja pliku:

res/drawable/filename.xml) Nazwa pliku to identyfikator zasobu

skompilowany typ danych zasobu:

Wskaźnik zasobu NinePatchDrawable

odniesienie do zasobu:

W języku Java: R.drawable.filename
W pliku XML: @[package:]drawable/filename

składnia:

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

elementy:

przykład:

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

Lista warstw

Obiekt LayerDrawable to obiekt rysowalny który zarządza tablicą innych elementów narysowanych. Każdy element rysowalny na liście jest rysowany w kolejności z listy. Ostatni obiekt rysowalny na liście jest rysowany na początku.

Każdy obiekt rysowalny jest reprezentowany przez element wewnątrz pojedynczego elementu .

lokalizacja pliku:

res/drawable/filename.xml) Nazwa pliku to identyfikator zasobu

skompilowany typ danych zasobu:

Wskaźnik zasobu LayerDrawable

odniesienie do zasobu:

W języku Java: R.drawable.filename
W pliku XML: @[package:]drawable/filename

składnia:

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

elementy:

przykład:

Plik XML zapisany o res/drawable/layers.xml:

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

W tym przykładzie do zdefiniowania elementu rysowalnego w tym przykładzie użyto zagnieżdżonego elementu dla każdego elementu o grawitacji "center". Dzięki temu żaden z obrazów nie będzie skalowany do rozmiaru kontenera ze względu na zmiany rozmiaru spowodowane przez obrazy przesunięcia.

Ten kod XML układu stosuje obiekt rysowalny do widoku:

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

Powstały stos obrazów coraz bardziej przesuniętych stron:

zobacz też:

LayerDrawable

Lista stanów

Obiekt StateListDrawable to obiekt rysowalny zdefiniowany w kodzie XML. który korzysta z wielu obrazów do reprezentowania tej samej grafiki, w zależności od stanu obiektu. Stan widżetu Button można na przykład kliknąć, zaznaczyć lub żaden z nich; za pomocą rysowania listy stanów dla każdego z nich stanu.

Listę stanów opisujesz w pliku XML. Każda grafika jest reprezentowana przez element wewnątrz jednego elementu . Co wykorzystuje różne atrybuty, aby opisać stan, w jakim jest używany jako element graficzny obiekt rysowalny.

Podczas każdej zmiany stanu lista stanów jest przesuwana od góry do dołu. Pierwszy element, który pasuje do bieżącego stanu. Wybór nie opiera się na „najlepszym” pasuje”, ale raczej pierwszy element, który spełnia minimalne kryteria obowiązujące w danym stanie.

lokalizacja pliku:

res/drawable/filename.xml) Nazwa pliku to identyfikator zasobu

skompilowany typ danych zasobu:

Wskaźnik zasobu StateListDrawable

odniesienie do zasobu:

W języku Java: R.drawable.filename
W pliku XML: @[package:]drawable/filename

składnia:

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

elementy:

Wymagane. Musi to być element główny. Zawiera co najmniej 1 element .

Atrybuty:

xmlns:android: Ciąg znaków. Wymagane. Definiuje przestrzeń nazw XML, którą musi być "http://schemas.android.com/apk/res/android"
android:constantSize: Wartość logiczna. Prawda, jeśli zgłoszony rozmiar wewnętrzny obiektu rysowania pozostaje na stałym poziomie jako stan zmiany (rozmiar jest maksymalnym rozmiarem dla wszystkich stanów); false, jeśli rozmiar różni się w zależności od do bieżącego stanu. Wartość domyślna to false (fałsz).
android:dither: Wartość logiczna. Prawda, aby włączyć dithering bitmapy, jeśli bitmapa nie ma takiego samego piksela konfigurację jako ekran, na przykład mapę bitową ARGB 8888 na ekranie RGB 565; fałsz na wyłączyć dithering. Wartość domyślna to true (prawda).
android:variablePadding: Wartość logiczna. Prawda, jeśli dopełnienie elementu rysowanego zmienia się w zależności od bieżącego w wybranym stanie; Wartość false, jeśli dopełnienie musi pozostać takie samo w oparciu o maksymalną ze wszystkimi stanami. Aby włączyć tę funkcję, musisz uporać się z wykonywanie układu przy zmianie stanu, co często nie jest obsługiwane. Wartość domyślna to false (fałsz).

Definiuje element rysowalny do użycia w określonych stanach, zgodnie z jego atrybutami. Musi to być element podrzędny elementu .

Atrybuty:

android:drawable: Zasób rysowalny. Wymagany. Odwołanie do zasobu rysowalnego.
android:state_pressed: Wartość logiczna. Prawda, jeśli ten element jest używany po dotknięciu obiektu (np. przycisk). poruszony; false, jeśli ten element jest używany domyślnie, bez kliknięcia.
android:state_focused: Wartość logiczna. Prawda, jeśli ten element jest używany, gdy obiekt jest zaznaczony przy użyciu danych wejściowych, np. gdy użytkownik wybierze pole tekstowe. false, jeśli ten element jest używany domyślnie, i stan niezaznaczony.
android:state_hovered: Wartość logiczna. Prawda, jeśli ten element jest używany po najechaniu na niego kursorem. false, jeśli ten element jest używany w domyślnym stanie innym niż najechanie. Często Element rysowalny może być tym samym obiektem rysowanym użytym jako obiekt rysowalny. stanu.
Wprowadzono w interfejsie API poziomu 14.
android:state_selected: Wartość logiczna. Prawda, jeśli ten element jest używany, gdy obiekt jest bieżącym wybór użytkownika podczas nawigacji za pomocą sterowania kierunkowego, na przykład podczas poruszania się po liście padem kierunkowym. false, jeśli ten element jest używany, gdy obiekt nie jest zaznaczony.
Wybrany stan jest używany, gdy android:state_focused nie jest wystarczający, np. gdy aktywny jest widok listy i element w nim jest zaznaczony za pomocą pada kierunkowego.
android:state_checkable: Wartość logiczna. Prawda, jeśli ten element jest używany, gdy można go wybrać. false, jeśli jest używany, gdy obiektu nie można wybrać. Przydatny tylko wtedy, gdy obiekt może przejście między widżetem, który można wybrać lub którego nie można wybrać.
android:state_checked: Wartość logiczna. Prawda, jeśli ten element jest używany, gdy obiekt jest zaznaczony. Wartość false (fałsz) jest używane, gdy obiekt nie jest zaznaczony.
android:state_enabled: Wartość logiczna. Wartość prawda, jeśli ten element jest używany, gdy obiekt jest włączony. oznacza zdolność do rejestrowania zdarzeń dotknięcia lub kliknięcia; false, jeśli jest używana, gdy obiekt jest wyłączono.
android:state_activated: Wartość logiczna. Prawda, jeśli ten element jest używany, gdy obiekt jest aktywowany jako wybór trwały, np. „highlight” (zaznacz) poprzednio wybranego elementu listy w trwałym widok nawigacji; false, jeśli jest używana, gdy obiekt nie został aktywowany.
Wprowadzono w interfejsie API poziomu 11.
android:state_window_focused: Wartość logiczna. Prawda, jeśli ten element jest używany, gdy okno aplikacji jest zaznaczone, co oznacza aplikacja działa na pierwszym planie; false, jeśli ten element jest używany, gdy aplikacja nie jest aktywne, np. gdy obszar powiadomień zostanie otwarty lub pojawi się okno.

Uwaga: Android stosuje pierwszy element na liście stanów, który pasuje do bieżącego stanu obiektu. Jeśli więc pierwszy element na liście zawiera żadnego z poprzednich atrybutów stanu, jest on stosowany za każdym razem. Właśnie dlatego warto zadbać o jako zawsze ostatnią, jak widać w przykładzie poniżej.

przykład:

Plik XML zapisany o res/drawable/button.xml:

 version="1.0" encoding="utf-8"?>
 xmlns:android="http://schemas.android.com/apk/res/android">
     android:state_pressed="true"
          android:drawable="@drawable/button_pressed" /> 
     android:state_focused="true"
          android:drawable="@drawable/button_focused" /> 
     android:state_hovered="true"
          android:drawable="@drawable/button_focused" /> 
     android:drawable="@drawable/button_normal" />

Ten kod XML układu stosuje do przycisku listę stanów, którą można rysować:

zobacz też:

StateListDrawable

Lista poziomów

Obiekt rysowalny, który zarządza pewną liczbą alternatywnych elementów, z których każdy ma przypisaną maksymalną wartość liczbową . Ustawienie wartości poziomu elementu rysowania za pomocą funkcji setLevel() wczytuje zasób rysowalny w poziomu listy, której wartość android:maxLevel jest większa lub równa wartości i przekazywane do metody.

lokalizacja pliku:

res/drawable/filename.xml) Nazwa pliku to identyfikator zasobu

skompilowany typ danych zasobu:

Wskaźnik zasobu LevelListDrawable

odniesienie do zasobu:

W języku Java: R.drawable.filename
W pliku XML: @[package:]drawable/filename

składnia:

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

elementy:

przykład:

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

Gdy zastosujesz to ustawienie do View, możesz zmienić poziom za pomocą setLevel() lub setImageLevel().

zobacz też:

LevelListDrawable

Przejście z możliwością rysowania

Obiekt TransitionDrawable to obiekt rysowalny które mogą przechodzić między 2 innymi zasobami.

Każdy obiekt rysowalny jest reprezentowany przez element wewnątrz jednego elementu . Obsługiwane są maksymalnie 2 elementy. Aby przejść dalej, wywołaj startTransition() Do przejście do tyłu, wywołaj reverseTransition().

lokalizacja pliku:

res/drawable/filename.xml) Nazwa pliku to identyfikator zasobu

skompilowany typ danych zasobu:

Wskaźnik zasobu TransitionDrawable

odniesienie do zasobu:

W języku Java: R.drawable.filename
W pliku XML: @[package:]drawable/filename

składnia:

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

elementy:

przykład:

Plik XML zapisany o res/drawable/transition.xml:

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

Ten kod XML układu stosuje obiekt rysowalny do widoku:

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

Ten kod wykonuje 500 ms przejścia z pierwszego do drugiego elementu:

Kotlin

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

Java

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

zobacz też:

TransitionDrawable

Element rysowalny wektor

Element rysowalny zdefiniowany w kodzie XML, który wstawia inny obiekt rysowalny o określonej odległości. To jest przydatne gdy widok wymaga tła, które jest mniejsze niż jego rzeczywiste granice.

lokalizacja pliku:

res/drawable/filename.xml) Nazwa pliku to identyfikator zasobu

skompilowany typ danych zasobu:

Wskaźnik zasobu InsetDrawable

odniesienie do zasobu:

W języku Java: R.drawable.filename
W pliku XML: @[package:]drawable/filename

składnia:

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

elementy:

przykład:

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

zobacz też:

InsetDrawable

Element rysowalny w klipsie

Element rysowalny zdefiniowany w kodzie XML, który przypina inny obiekt rysowalny na podstawie bieżącego poziomu obiektu rysowania. Ty może kontrolować szerokość i wysokość elementu rysowanego w zależności od poziomu, w postaci grawitacji, aby kontrolować, gdzie zostanie umieszczony w całym pojemniku. Najczęściej używane do implementacji takie jak paski postępu.

lokalizacja pliku:

res/drawable/filename.xml) Nazwa pliku to identyfikator zasobu

skompilowany typ danych zasobu:

Wskaźnik zasobu ClipDrawable

odniesienie do zasobu:

W języku Java: R.drawable.filename
W pliku XML: @[package:]drawable/filename

składnia:

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

elementy:

Wymagane. Określa element, który można rysować. Musi to być element główny.

Atrybuty:

xmlns:android

Ciąg znaków. Wymagane. Definiuje przestrzeń nazw XML, którą musi być "http://schemas.android.com/apk/res/android"

android:drawable

Zasób rysowalny. Wymagany. Odniesienie do elementu rysowalnego zasobu, który ma zostać przycięty.

android:clipOrientation

Słowo kluczowe. Orientacja klipu.

Musi mieć jedną z tych stałych wartości:

Wartość	Opis
`horizontal`	Przypnij element rysowalny w poziomie.
`vertical`	Przypnij element rysowalny w pionie.

android:gravity

Słowo kluczowe. Określa miejsce klipu w elemencie rysowanym.

Musi to być co najmniej jedna z tych wartości stałych rozdzielonych znakiem |:

Wartość	Opis
`top`	Umieść obiekt na górze kontenera, nie zmieniając jego rozmiaru. Gdy `clipOrientation` ma wartość `"vertical"`, przycinanie ma miejsce na dole elementu, który można rysować.
`bottom`	Umieść obiekt na dole kontenera, nie zmieniając jego rozmiaru. Gdy `clipOrientation` ma wartość `"vertical"`, przycinanie ma miejsce na górze elementu, który można rysować.
`left`	Umieść obiekt przy lewej krawędzi kontenera, nie zmieniając jego rozmiaru. To jest wartość domyślną. Gdy `clipOrientation` ma wartość `"horizontal"`, przycinanie ma miejsce po prawej stronie obiekt rysowalny.
`right`	Umieść obiekt przy prawej krawędzi kontenera, nie zmieniając jego rozmiaru. Gdy `clipOrientation` ma wartość `"horizontal"`, przycinanie ma miejsce po lewej stronie argumentu obiekt rysowalny.
`center_vertical`	Umieść obiekt na środku kontenera w pionie, nie zmieniając jego rozmiaru. Zachowanie przycięcia taka sama jak przy grawitacji `"center"`.
`fill_vertical`	W razie potrzeby zwiększ pionowy rozmiar obiektu, aby wypełnił cały kontener. Gdy `clipOrientation` ma wartość `"vertical"`, przycinanie nie następuje, ponieważ element rysowalny wypełnia w pionie (chyba że poziom, który można narysować ma wartość 0, jest wtedy niewidoczny).
`center_horizontal`	Umieść obiekt na środku kontenera w poziomie, nie zmieniając jego rozmiaru. Przycinanie działa tak samo jak przy grawitacji `"center"`.
`fill_horizontal`	W razie potrzeby powiększ obiekt w poziomie, aby wypełnił cały kontener. Kiedy `clipOrientation` ma wartość `"horizontal"`, przycinanie nie występuje, ponieważ obiekt rysowalny wypełnia w poziomie (chyba że poziom, który można przeciągnąć, ma wartość 0, co oznacza, że nie jest widoczny).
`center`	Umieść obiekt na środku kontenera na osi pionowej i poziomej, i jego rozmiaru. Gdy `clipOrientation` ma wartość `"horizontal"`, przycinanie ma miejsce po lewej i prawej stronie. Gdy `clipOrientation` ma wartość `"vertical"`, przycinanie ma miejsce na górze i na dole.
`fill`	W razie potrzeby zwiększ rozmiar obiektu w poziomie i pionie, aby wypełnił cały obszar kontenera. Przycinanie nie występuje, ponieważ element rysowalny wypełnia w pionie i w poziomie (chyba że poziom, który można przeciągnąć, wynosi 0 – w takim przypadku nie jest widoczne).
`clip_vertical`	Dodatkowa opcja, w ramach której można przyciąć górne lub dolne krawędzie elementu podrzędnego granic swojego kontenera. Klip jest oparty na grawitacji pionowej: górna grawitacja przycina dolna krawędź grawitacja przycina górną, ale żadna z nich nie przycina obu.
`clip_horizontal`	Dodatkowa opcja, w ramach której można przyciąć lewe lub prawe krawędzie elementu podrzędnego granic swojego kontenera. Klip jest oparty na grawitacji poziomej: lewa grawitacja prawa grawitacja przycina lewą krawędź, ale żadna z nich nie przycina obu.

przykład:

Plik XML zapisany o res/drawable/clip.xml:

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

Poniższy kod XML układu stosuje klip, który można rysować do widoku:

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

Poniższy kod pobiera obiekt rysowalny i zwiększa liczbę przycinań do stopniowo odkrywać obraz:

Kotlin

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

Java

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

Zwiększenie poziomu spowoduje zmniejszenie liczby przycięć i powolne wyświetlenie obrazu. Oto i ona na poziomie 7000:

Uwaga: domyślny poziom to 0, co oznacza, że obraz jest całkowicie przycięty. nie jest widoczny. Przy poziomie 10 000 obraz nie jest przycięty i jest w pełni widoczny.

zobacz też:

ClipDrawable

Obiekt do rysowania na skali

Element rysowalny zdefiniowany w pliku XML, który zmienia rozmiar innego obiektu rysowalnego na podstawie jego bieżącego na poziomie 300%.

lokalizacja pliku:

res/drawable/filename.xml) Nazwa pliku to identyfikator zasobu

skompilowany typ danych zasobu:

Wskaźnik zasobu ScaleDrawable

odniesienie do zasobu:

W języku Java: R.drawable.filename
W pliku XML: @[package:]drawable/filename

składnia:

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

elementy:

Wymagane. Określa skalę, którą można rysować. Musi to być element główny.

Atrybuty:

xmlns:android

Ciąg znaków. Wymagane. Definiuje przestrzeń nazw XML, którą musi być "http://schemas.android.com/apk/res/android"

android:drawable

Zasób rysowalny. Wymagany. Odniesienie do elementu rysowalnego .

android:scaleGravity

Słowo kluczowe. Określa pozycję grawitacji po skalowaniu.

Musi to być co najmniej jedna z tych wartości stałych rozdzielonych znakiem |:

Wartość	Opis
`top`	Umieść obiekt na górze kontenera, nie zmieniając jego rozmiaru.
`bottom`	Umieść obiekt na dole kontenera, nie zmieniając jego rozmiaru.
`left`	Umieść obiekt przy lewej krawędzi kontenera, nie zmieniając jego rozmiaru. To jest wartość domyślną.
`right`	Umieść obiekt przy prawej krawędzi kontenera, nie zmieniając jego rozmiaru.
`center_vertical`	Umieść obiekt na środku kontenera w pionie, nie zmieniając jego rozmiaru.
`fill_vertical`	W razie potrzeby zwiększ pionowy rozmiar obiektu, aby wypełnił cały kontener.
`center_horizontal`	Umieść obiekt na środku kontenera w poziomie, nie zmieniając jego rozmiaru.
`fill_horizontal`	W razie potrzeby powiększ obiekt w poziomie, aby wypełnił cały kontener.
`center`	Umieść obiekt na środku kontenera na osi pionowej i poziomej, i jego rozmiaru.
`fill`	W razie potrzeby zwiększ rozmiar obiektu w poziomie i pionie, aby wypełnił cały obszar kontenera.
`clip_vertical`	Dodatkowa opcja, w ramach której można przyciąć górne lub dolne krawędzie elementu podrzędnego granic swojego kontenera. Klip jest oparty na grawitacji pionowej: górna grawitacja przycina dolna krawędź grawitacja przycina górną, ale żadna z nich nie przycina obu.
`clip_horizontal`	Dodatkowa opcja, w ramach której można przyciąć lewe lub prawe krawędzie elementu podrzędnego granic swojego kontenera. Klip jest oparty na grawitacji poziomej: lewa grawitacja prawa grawitacja przycina lewą krawędź, ale żadna z nich nie przycina obu.

android:scaleHeight

Procent. Wysokość skali wyrażona jako procent wartości elementu, który można narysować związane. Format wartości to XX%, np.100% lub 12,5%.

android:scaleWidth

Procent. Szerokość skali wyrażona jako procent elementu, który można narysować związane. Format wartości to XX%, np.100% lub 12,5%.

przykład:

 version="1.0" encoding="utf-8"?>
 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%" />

zobacz też:

ScaleDrawable

Kształt rysowalny

To ogólny kształt zdefiniowany w kodzie XML.

lokalizacja pliku:

res/drawable/filename.xml) Nazwa pliku to identyfikator zasobu

skompilowany typ danych zasobu:

Wskaźnik zasobu GradientDrawable

odniesienie do zasobu:

W języku Java: R.drawable.filename
W pliku XML: @[package:]drawable/filename

składnia:

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

elementy:

Wymagane. Kształt, który można rysować. Musi to być element główny.

Atrybuty:

xmlns:android

Ciąg znaków. Wymagane. Definiuje przestrzeń nazw XML, którą musi być "http://schemas.android.com/apk/res/android"

android:shape

Słowo kluczowe. Określa typ kształtu. Prawidłowe wartości to:

Wartość	Opis
`"rectangle"`	Prostokąt, który wypełnia widok główny. To jest domyślny kształt.
`"oval"`	Owal, który pasuje do wymiarów widoku, który zawiera.
`"line"`	Pozioma linia rozciągająca się wzdłuż szerokości widoku, który zawiera. Ten kształt wymaga elementu do określenia szerokości .
`"ring"`	Okrągły kształt.

Te atrybuty są używane tylko wtedy, gdy android:shape="ring":

android:innerRadius: Wymiar. Promień dla wewnętrznej części pierścienia (otwór w środku) jako wartość wymiaru lub zasób wymiaru.
android:innerRadiusRatio: Swobodna. Promień obszaru wewnętrznego i jego części, wyrażony jako stosunek szerokości pierścienia. Na przykład jeśli chodzi o android:innerRadiusRatio="5", promień wewnętrzny jest równy szerokości pierścienia podzielonego przez 5. Ten została zastąpiona przez android:innerRadius. Wartością domyślną jest 9.
android:thickness: Wymiar. Grubość pierścień, jako wartość wymiaru lub zasób wymiaru.
android:thicknessRatio: Swobodna. Grubość pierścienia wyrażony jako stosunek szerokości pierścienia. Jeśli na przykład android:thicknessRatio="2", to grubość równa się szerokości pierścienia podzielonego przez 2. Ta wartość została zastąpiona przez android:innerRadius. Wartością domyślną jest 3.
android:useLevel: Wartość logiczna. Wartość prawda, jeśli jest używana jako LevelListDrawable. Zwykle ma wartość fałsz, W przeciwnym razie kształt może się nie pojawić.

Tworzy zaokrąglone narożniki kształtu. Ma zastosowanie tylko wtedy, gdy kształt jest prostokątny.

Atrybuty:

android:radius: Wymiar. Promień wszystkich narożników jako wartość wymiaru lub zasób wymiaru. Ta wartość jest zastępowana dla każdego pod kątem tych atrybutów.
android:topLeftRadius: Wymiar. Promień lewego górnego rogu jako wartość wymiaru lub zasób wymiaru.
android:topRightRadius: Wymiar. Promień prawego górnego rogu ekranu jako wartość wymiaru lub zasób wymiaru.
android:bottomLeftRadius: Wymiar. Promień lewego dolnego rogu jako wartość wymiaru lub zasób wymiaru.
android:bottomRightRadius: Wymiar. Promień prawego dolnego rogu jako wartość wymiaru lub zasób wymiaru.

Uwaga: każdy róg musi początkowo mieć róg. promień jest większy niż 1 lub żadne narożniki nie są zaokrąglane. Jeśli chcesz mieć konkretne narożniki aby nie być zaokrąglane, możesz obejść ten problem, używając android:radius do ustawienia narożnika domyślnego. większy od 1, a następnie zastąp każdy narożnik wartościami, które i ustaw 0 („0dp”) w miejscach, gdzie rogi nie mają być zaokrąglone.

Określa kolor gradientu kształtu.

Atrybuty:

android:angle

Liczba całkowita. Kąt gradientu w stopniach. 0 od lewej do prawej, 90 to od dołu do góry. Musi to być wielokrotność liczby 45. Wartość domyślna to 0.

android:centerX

Swobodna. Względna pozycja na osi X środka gradientu (0–1,0).

android:centerY

Swobodna. Względna pozycja Y środka gradientu (0–1,0).

android:centerColor

Kolor. Opcjonalny kolor występujący między kolorem początkowym i końcowym. wartość szesnastkową lub zasób koloru.

android:endColor

Kolor. Kolor końcowy w postaci szesnastkowej. lub zasób koloru.

android:gradientRadius

Swobodna. Promień gradientu. Stosowane tylko wtedy, gdy android:type="radial".

android:startColor

Kolor. Kolor początkowy w postaci szesnastkowej lub zasób koloru.

android:type

Słowo kluczowe. Typ stosowanego wzorca gradientu. Prawidłowe wartości to:

Wartość	Opis
`"linear"`	Gradient liniowy. Jest to ustawienie domyślne.
`"radial"`	Gradient promieniowy. Kolor początkowy to kolor środkowy.
`"sweep"`	Duży gradient linii.

android:useLevel

Wartość logiczna. Prawda, jeśli jest używana jako LevelListDrawable.

Dopełnienie stosowane do elementu widoku danych. Spowoduje to wypełnienie pozycji widoku a nie kształt.

Atrybuty:

android:left: Wymiar. Dopełnienie z lewej strony jako wartość wymiaru lub zasób wymiaru.
android:top: Wymiar. Dopełnienie u góry jako wartość wymiaru lub zasób wymiaru.
android:right: Wymiar. Dopełnienie z prawej strony jako wartość wymiaru lub zasób wymiaru.
android:bottom: Wymiar. Dopełnienie u dołu jako wartość wymiaru lub zasób wymiaru.

Rozmiar kształtu.

Atrybuty:

android:height: Wymiar. Wysokość kształtu jako wartość wymiaru lub zasób wymiaru.
android:width: Wymiar. Szerokość kształtu jako wartość wymiaru lub zasób wymiaru.

Uwaga: domyślnie kształt jest skalowany do rozmiaru kontenera. wyświetlane proporcjonalnie do zdefiniowanych tutaj wymiarów. Gdy używasz kształtu w elemencie ImageView, możesz ograniczyć skalowanie przez ustawienie atrybutu android:scaleType na "center".

Jednolity kolor wypełnienia kształtu.

Atrybuty:

android:color: Kolor. Kolor, który zostanie zastosowany do kształtu w formacie szesnastkowym. lub zasób koloru.

Linia przerywana kształtu.

Atrybuty:

android:width: Wymiar. Grubość linii jako wartość wymiaru lub zasób wymiaru.
android:color: Kolor. Kolor linii, wartość szesnastkową lub zasób koloru.
android:dashGap: Wymiar. Odległość między myślnikami wiersza w formie wartości wymiaru lub zasobu wymiaru. Tej formuły można użyć tylko wtedy, gdy skonfigurowano ustawienie android:dashWidth.
android:dashWidth: Wymiar. Rozmiar każdej linii przerywanej jako wartość wymiaru lub zasób wymiaru. Tej formuły można użyć tylko wtedy, gdy skonfigurowano ustawienie android:dashGap.

przykład:

Plik XML zapisany o res/drawable/gradient_box.xml:

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

Ten kod XML układu stosuje kształt rysowalny do widoku:

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

Ten kod aplikacji pobiera kształt i stosuje go do widoku:

Kotlin

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

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

Java

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

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

zobacz też:

ShapeDrawable

Zasoby rysowalne Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Bitmapa

Plik bitmapy

Kotlin

Java

Bitmapa XML

9 poprawek

Plik z 9 poprawkami

9-poprawka XML

Lista warstw

Lista stanów

Lista poziomów

Przejście z możliwością rysowania

Kotlin

Java

Element rysowalny wektor

Element rysowalny w klipsie

Kotlin

Java

Obiekt do rysowania na skali

Kształt rysowalny

Kotlin

Java

Zasoby rysowalne
Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.