Bu sayfa, Cloud Translation API ile çevrilmiştir.

Çekilebilir kaynaklar

Çekilebilir kaynak, ekrana çizilebilecek bir grafik için genel bir kavramdır ve getDrawable(int) gibi API'lerle alabilir veya android:drawable ve android:icon gibi özelliklere sahip başka bir XML kaynağına ekleyin. Birkaç çekilebilir öğe türü vardır:

Bit eşlem dosyası
: Bit eşlem grafik dosyası (PNG, WEBP, JPG veya GIF). BitmapDrawable oluşturur.
Dokuz yama dosyası: Resimlerin içeriğe göre yeniden boyutlandırılabileceği bölgeler içeren bir PNG dosyası (.9.png). NinePatchDrawable oluşturur.
Katman listesi: Diğer çekilebilir öğeleri yöneten çekilebilir. Bunlar dizi sırasında çizilir, bu nedenle en büyük endeksli öğe en üste çizilir. LayerDrawable oluşturur.
Eyalet listesi: Farklı bit eşlem grafiklerine referans veren bir XML dosyası kullanabilirsiniz. Örneğin, bir düğmeye dokunulduğunda farklı bir resim kullanmak için. StateListDrawable oluşturur.
Seviye listesi: Her biri alternatif çekilebilir öğeleri yöneten bir çekilebilirliği tanımlayan XML dosyası bir maksimum sayısal değer atar. LevelListDrawable oluşturur.
Geçiş çizimi: İki çizili kaynak arasında geçiş yapabilen bir çekilebilirliği tanımlayan XML dosyası. TransitionDrawable oluşturur.
İç içe doğru çekilebilir: Belirli bir uzaklığa göre başka bir çekilebilir içeriği ekleyen XML dosyası. Bu özellik, görünümün gerçek boyutundan daha küçük bir arka plan çekilebilirliği gerektiğinde yararlı olur sınırlar.
Çekmeceli klip: Bir çekilebilir sözcüğünü tanımlayan ve bu çekilebilir öğenin Mevcut düzey değeri. ClipDrawable oluşturur.
Çekilebilir ölçekleme: Şu boyuta göre başka bir çekilebilir öğenin boyutunu değiştiren bir çekilebilirliği tanımlayan XML dosyası: Mevcut düzey değeri. ScaleDrawable oluşturur
Şekil çekilebilir.: Renkler ve gradyanlar dahil olmak üzere geometrik bir şekli tanımlayan XML dosyası. GradientDrawable oluşturur.

Nasıl yapıldığını AnimationDrawable oluşturun, Animasyon kaynakları dokümanını inceleyin.

Not: Renk kaynağı da XML’de çekilebilir olarak kullanılır. Örneğin, bir eyalet listesi oluştururken Paintable'ı seçerseniz android:drawable özelliği (android:drawable="@color/green") için bir renk kaynağına başvurabilirsiniz.

Bit eşlem

Bit eşlem resmi. Android, şu biçimlerdeki bit eşlem dosyalarını destekler: PNG (tercih edilen), WEBP (tercih edilir, API düzeyi 17 veya üstü gerekir), JPG (kabul edilebilir), GIF (önerilmez).

Kaynak kimliği olarak dosya adını kullanıp bit eşlem dosyasına doğrudan başvurabilir veya XML'de takma ad kaynak kimliği.

Not: Bit eşlem dosyaları, kayıpsız değer ile otomatik olarak optimize edilebilir. resim sıkıştırma işlemi sırasında aapt aracı kullanılabilir. Örneğin, örneğin, 256'dan fazla renk gerektirmeyen gerçek renkli bir PNG dosyası 8 bit'e dönüştürülebilir PNG. Böylece daha az resim gerektiren, eşit kalitede bir resim elde edilir. hafızada bulabilirsiniz.

Bu nedenle, bu dizine yerleştirilen görüntü ikili programlarının derleme sırasında değişebileceğini unutmayın. Eğer bir resmi bit eşlem haline getirmek için bit akış olarak okumayı planlıyorsanız, resimlerinizi Bunun yerine, optimize edilmeyen res/raw/ klasörü gösterilir.

Bit eşlem dosyası

Bit eşlem bir PNG, WEBP, JPG veya GIF dosyasıdır. Android bir Drawable oluşturur res/drawable/ dizinine kaydettiğinizde bu dosyalardan herhangi biri için bir kaynak oluşturun.

dosya konumu:

res/drawable/filename.png (.png, .webp, .jpg veya .gif)
Dosya adı, kaynak kimliğidir

derlenen kaynak veri türü:

Kaynak işaretçisini bir BitmapDrawable

kaynak referansı:

. Java'da: R.drawable.filename
XML'de: @[package:]drawable/filename

örnek:

res/drawable/myimage.png konumuna kaydedilen bir resimle, bu düzen XML'i geçerli olur bir görünüm oluşturabilir:

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

Aşağıdaki uygulama kodu, görüntüyü Drawable biçiminde alır:

Kotlin

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

Java

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

ayrıca bkz.:

XML bit eşlemi

XML bit eşlemi, XML'de tanımlı ve bir bit eşlem dosyasına işaret eden kaynaktır. Bu efekt, alan adının ham bit eşlem dosyası. XML, bit eşlem için titreme ve parçalama gibi ek özellikler belirtebilir.

Not: <bitmap> öğesini şunun alt öğesi olarak kullanabilirsiniz: <item> öğesidir. Örneğin, örneğin bir durum listesi veya katman listesi oluştururken, android:drawable öğesini hariç tutabilirsiniz özelliğini bir <item> öğesinden kaldırıp bu öğenin içine bir <bitmap> yerleştirin çekilebilir öğeyi tanımlayan bir kod içerir.

dosya konumu:

res/drawable/filename.xml
Dosya adı, kaynak kimliğidir

derlenen kaynak veri türü:

Kaynak işaretçisini bir BitmapDrawable

kaynak referansı:

. Java'da: R.drawable.filename
XML'de: @[package:]drawable/filename

söz dizimi:

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

öğeler:

<bitmap>

Zorunlu. Bit eşlem kaynağını ve özelliklerini tanımlar.

Özellikler:

xmlns:android

Dize. Şu olması gereken XML ad alanını tanımlar: "http://schemas.android.com/apk/res/android" Bu yalnızca <bitmap>, kök öğedir. <bitmap>, <item> içine yerleştirilmiştir.

android:src

Çekilebilir kaynak. Zorunludur. Çekilebilir öğeye referans verme gösterir.

android:antialias

Boole. Düzeltmeyi etkinleştirir veya devre dışı bırakır.

android:dither

Boole. Bit eşlem çalışmazsa bit eşlem için titretmeyi etkinleştirir veya devre dışı bırakır ekranla aynı piksel yapılandırmasına sahip olmalıdır (örneğin, RGB 565'te ARGB 8888 bit eşlemi). tıklayın.

android:filter

Boole. Bit eşlem filtrelemeyi etkinleştirir veya devre dışı bırakır. Filtreleme, bit eşlem, görünümünü yumuşatmak için küçültülür veya uzatılır.

android:gravity

Anahtar kelime. Bit eşlemin yer çekimini tanımlar. Yer çekimi, bir öğeyi bit eşlem kapsayıcıdan küçükse çekilebilir öğeyi kapsayıcıya yerleştirin.

| ile ayrılmış aşağıdaki sabit değerlerden biri veya daha fazlası olmalıdır:

Değer	Açıklama
`top`	Nesneyi, boyutunu değiştirmeden kapsayıcının üst kısmına yerleştirin.
`bottom`	Nesneyi, boyutunu değiştirmeden kabının alt kısmına yerleştirin.
`left`	Nesneyi, boyutunu değiştirmeden kapsayıcının sol kenarına yerleştirin.
`right`	Nesneyi, boyutunu değiştirmeden kapsayıcının sağ kenarına yerleştirin.
`center_vertical`	Nesneyi, boyutunu değiştirmeden kapsayıcının dikey olarak ortasına yerleştirin.
`fill_vertical`	Gerekirse nesnenin dikey boyutunu büyüterek kapsayıcıyı tamamen doldurmasını sağlayın.
`center_horizontal`	Nesneyi, boyutunu değiştirmeden kapsayıcının yatay merkezine yerleştirin.
`fill_horizontal`	Gerekirse nesnenin yatay boyutunu büyüterek kapsayıcıyı tamamen doldurmasını sağlayın.
`center`	Nesneyi hem dikey hem de yatay eksende kapsayıcısının ortasına yerleştirin boyutunu değiştiriyor.
`fill`	Gerekiyorsa nesnenin yatay ve dikey boyutunu büyüterek emin olun. Bu, varsayılan ayardır.
`clip_vertical`	Alt ve/veya alt kenarların kırpılacağı şekilde ayarlanabilecek ek seçenek görebilirsiniz. Klip dikey yer çekimine dayalıdır: Üstteki yer çekimi alt kenar, alt yerçekimi üst kenarı klipslir ve iki kenarın ikisini de klip tutmaz.
`clip_horizontal`	Alt öğenin sol ve/veya sağ kenarlarının kırpılacağı şekilde ayarlanabilecek ek seçenek görebilirsiniz. Klip yatay yer çekimine dayalıdır: sol yer çekimi klipleri sağ kenarını temel alıyorsa, sağ yerçekimi sol kenarı klipslir ve iki kenarın ikisini de klip tutmaz.

android:mipMap

Boole. Mipmap ipucunu etkinleştirir veya devre dışı bırakır. Daha fazla bilgi için setHasMipMap() belgesine göz atın. False varsayılan değerdir.

android:tileMode

Anahtar kelime. Kart modunu tanımlar. Döşeme modu etkinleştirildiğinde bit eşlem tekrarlanır. Kart modu etkinleştirildiğinde yerçekimi yoksayılır.

Aşağıdaki sabit değerlerden biri olmalıdır:

Değer	Açıklama
`disabled`	Bit eşlemi döşeyin. Bu, varsayılan değerdir.
`clamp`	Gölgelendirici orijinal sınırlarının dışına çiziyorsa kenar rengini çoğalt
`repeat`	Gölgelendirici resmini yatay ve dikey olarak tekrarlayın.
`mirror`	Gölgelendirici görüntüsünü yatay ve dikey olarak yineleyin. bitişik resimler her zaman eklidir.

örnek:

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

ayrıca bkz.:

Dokuz Bant

NinePatch, uzatılabilir bölgeler tanımlayabileceğiniz bir PNG resmidir. (görünümdeki içerik normal resim sınırlarını aştığında) Android'in ölçeklendirilmesine olanak tanır. Siz genellikle bu tür bir resmi, en az bir boyutu ayarlanmış bir görünümün arka planı olarak atarız "wrap_content" numaralı telefona.

Görüntü içeriği barındıracak şekilde büyüdüğünde, dokuz noktalı resim görünümün boyutuna uyacak şekilde ölçeklendirilir. Dokuz yamalı bir resmin kullanımına örnek olarak Android'in standart Button widget'ı tarafından kullanılan ve metni (veya resmi) düğmenin içine yerleştirin.

Normal bit eşlemede olduğu gibi, dokuz yama dosyasına doğrudan başvuruda bulunabilirsiniz. veya XML tarafından tanımlanmış bir kaynaktan.

Esnek bölgeleri içeren dokuz yama dosyasının nasıl oluşturulacağıyla ilgili kapsamlı bir tartışma için Yeniden boyutlandırılabilir bit eşlemler oluşturma (9 yama dosyaları) adlı makaleyi inceleyin.

Dokuz yama dosyası

dosya konumu:

res/drawable/filename.9.png
Dosya adı, kaynak kimliğidir

derlenen kaynak veri türü:

Kaynak işaretçisini bir NinePatchDrawable

kaynak referansı:

. Java'da: R.drawable.filename
XML'de: @[package:]drawable/filename

örnek:

res/drawable/myninepatch.9.png konumuna kaydedilen bir resimle, bu düzen XML'i dokuz yamayı bir görünüme uygular:

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

ayrıca bkz.:

XML dokuz yama

XML dokuzlu yama, XML'de tanımlı ve dokuz yama dosyasına işaret eden bir kaynaktır. XML, resimdeki titremeyi belirtin.

dosya konumu:

res/drawable/filename.xml
Dosya adı, kaynak kimliğidir

derlenen kaynak veri türü:

Kaynak işaretçisini bir NinePatchDrawable

kaynak referansı:

. Java'da: R.drawable.filename
XML'de: @[package:]drawable/filename

söz dizimi:

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

öğeler:

örnek:

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

Katman listesi

LayerDrawable, çekilebilir bir nesnedir bir dizi diğer çekilebilir yeri yönetir. Listedeki her çekilebilir kart, liste'ye dokunun. Listedeki son çizilebilir öğe en üste çizilir.

Her çekilebilir, tek bir <layer-list> öğesinin içinde bir <item> öğesiyle temsil edilir.

dosya konumu:

res/drawable/filename.xml
Dosya adı, kaynak kimliğidir

derlenen kaynak veri türü:

Kaynak işaretçisini bir LayerDrawable

kaynak referansı:

. Java'da: R.drawable.filename
XML'de: @[package:]drawable/filename

söz dizimi:

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

öğeler:

örnek:

XML dosyası res/drawable/layers.xml itibarıyla kaydedildi:

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

Bu örnekte, çekilebilir öğeyi tanımlamak için iç içe yerleştirilmiş bir <bitmap> öğesi kullanılmaktadır her öğe için "center" yer çekimine sahip bir kaynaktır. Bu, resimlerin hiçbirinin ofset görüntülerinin neden olduğu yeniden boyutlandırmadan dolayı kapsayıcının boyutuna uyar.

Bu düzen XML'i, çekilebilir öğeyi görünüme uygular:

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

Sonuçta, giderek daha fazla ofsetli resim ortaya çıkar:

ayrıca bkz.:

LayerDrawable

Eyalet listesi

StateListDrawable, XML'de tanımlanan çekilebilir bir nesnedir durumuna bağlı olarak, aynı grafiği temsil eden birden fazla resim kullanan izin verir. Örneğin, bir Button widget'ının durumuna dokunulabilir, odaklanılabilir, ya da hiçbiri; çekilebilir bir durum listesi kullanarak, her öğe için farklı bir arka plan durumu.

Durum listesini bir XML dosyasında açıklarsınız. Her grafik, tek bir <selector> öğesinin içinde bir <item> öğesiyle temsil edilir. Her <item> grafik olarak kullanıldığı durumu açıklayan çeşitli çekilebilir.

Her durum değişikliği sırasında, durum listesi yukarıdan aşağıya ve eşleşmesini ifade eder. Seçim, "en iyi"ye dayalı değildir eşleşiyor" daha çok eyaletin minimum ölçütlerini karşılayan ilk öğe olabilir.

dosya konumu:

res/drawable/filename.xml
Dosya adı, kaynak kimliğidir

derlenen kaynak veri türü:

Kaynak işaretçisini bir StateListDrawable

kaynak referansı:

. Java'da: R.drawable.filename
XML'de: @[package:]drawable/filename

söz dizimi:

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

öğeler:

<selector>

Zorunlu. Bu, kök öğe olmalıdır. Bir veya daha fazla <item> öğesi içerir.

Özellikler:

xmlns:android: Dize. Zorunludur. Şu olması gereken XML ad alanını tanımlar: "http://schemas.android.com/apk/res/android"
android:constantSize: Boole. Çekilebilir öğenin raporlanan dahili boyutu durum olarak sabit kalırsa doğru değerini döndürür değişiklikler (boyut, tüm eyaletlerin maksimum değeridir); boyut durumu değiştirir. Varsayılan değer, false (yanlış) değeridir.
android:dither: Boole. Bit eşlemin aynı piksele sahip olmaması durumunda bit eşlemin titremesini etkinleştirmek için doğru değerini döndürür Ekran yapılandırma. Örneğin, RGB 565 ekranında ARGB 8888 bit eşlemi; yanlış karartmayı devre dışı bırak. Varsayılan değer, doğru değeridir.
android:variablePadding: Boole. Çekilebilir öğenin dolgusu geçerli değere göre değişirse doğru değerini döndürür durumu belirtin. değerine göre, dolgunun aynı kalması gerekiyorsa false (yanlış) değerini alır dolgusu vardır. Bu özelliği etkinleştirmek, genellikle desteklenmez. Varsayılan değer, false (yanlış) değeridir.

<item>

Özellikleri tarafından açıklandığı şekilde, belirli durumlarda kullanılacak bir çekilebilirdi tanımlar. Bir <selector> öğesinin alt öğesidir.

Özellikler:

android:drawable: Çekilebilir kaynak. Zorunludur. Çekilebilir bir kaynağa referans.
android:state_pressed: Boole. Nesneye dokunulduğunda (ör. bir düğmeye basıldığında) bu öğe kullanılırsa doğru değerini döndürür dokunulduğunda; Bu öğe varsayılan, dokunulmamış durumda kullanılırsa false (yanlış) değerini alır.
android:state_focused: Boole. Bu öğe, nesnede giriş odağı olduğunda kullanılırsa doğru değerini döndürür. Örneğin, kullanıcı bir metin girişi seçtiğinde; bu öğe varsayılan olarak kullanılıyorsa false (yanlış) değerini alır. bir durumu anlatır mısınız?” diye soruldu.
android:state_hovered: Boole. İmleç nesnenin üzerine geldiğinde bu öğe kullanılırsa doğru değerini döndürür; Bu öğe varsayılan olarak, fareyle üzerine gelmeden kullanılırsa false (yanlış) değerini alır. Çoğu zaman bu çekilebilir , "odaklanmış" sayfa için kullanılanla aynı çekilebilir olabilir. durumu.
API düzeyi 14'te kullanıma sunuldu.
android:state_selected: Boole. Nesne geçerliyken bu öğe kullanılırsa doğru değerini döndürür listede gezinirken olduğu gibi, yönlü kontrolle gezinirken kullanıcı seçimi D-pad ile; Nesne seçilmediğinde bu öğe kullanılırsa false (yanlış) değerini alır.
android:state_focused yeterli olmadığında seçilen durum kullanılır Örneğin, liste görünümünün odağı varken ve görünümün içindeki bir öğe D-pad ile seçildiğinde.
android:state_checkable: Boole. Nesne seçilebilirken bu öğe kullanılıyorsa doğru değerini döndürür; bu değer yanlışsa öğe, nesne seçilebilir olmadığında kullanılır. Yalnızca nesne şu durumlarda yararlıdır: bir widget'ın üzerine gelin.
android:state_checked: Boole. Nesne seçiliyken bu öğe kullanılırsa doğru değerini döndürür; bu değer yanlışsa nesne seçilmediğinde kullanılır.
android:state_enabled: Boole. Nesne etkinleştirildiğinde bu öğe kullanılırsa doğru değerini döndürür, Dokunma veya tıklama etkinliklerini alabilme özellikli, nesne kullanıldığında kullanılırsa false (yanlış) devre dışı bırakıldı.
android:state_activated: Boole. Nesne etkinleştirildiğinde bu öğe kullanılırsa doğru değerini döndürür: kalıcı seçim, örneğin "vurgulamak" daha önce seçilen liste öğesini kalıcı olarak gezinme görünümü; nesne etkinleştirilmediğinde kullanılırsa false (yanlış) değerini alır.
API düzeyi 11'de kullanıma sunuldu.
android:state_window_focused: Boole. Uygulama penceresi odaklanıldığında bu öğe kullanılırsa doğru değerini döndürür. Yani Uygulama ön plandaysa uygulama sırasında bu öğe kullanılırsa false (yanlış) pencerenin odak noktası yoktur. Örneğin, bildirim gölgesi aşağı çekilirse veya bir iletişim kutusu gösterilir.

Not: Android, durum listesindeki ilk öğeyi uygular. öğesinin mevcut durumuyla eşleşir. Listedeki ilk öğe önceki durum özelliklerinden hiçbiri yoksa her defasında uygulanır. Bu nedenle varsayılan değerin her zaman son olması gerekir.

örnek:

XML dosyası res/drawable/button.xml itibarıyla kaydedildi:

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

Bu düzen XML'i, durum listesini bir düğmeye çizilebilir:

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

ayrıca bkz.:

StateListDrawable

Seviye listesi

Her birine maksimum sayısal değer atanan bir dizi alternatif çekilebilirliği yöneten bir çekilebilir değer. setLevel() ile çekilebilir öğenin seviye değeri ayarlandığında değerden büyük veya değere eşit android:maxLevel değerine sahip seviye listesi yönteme geçirilir.

dosya konumu:

res/drawable/filename.xml
Dosya adı, kaynak kimliğidir

derlenen kaynak veri türü:

Kaynak işaretçisini bir LevelListDrawable

kaynak referansı:

. Java'da: R.drawable.filename
XML'de: @[package:]drawable/filename

söz dizimi:

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

öğeler:

örnek:

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

Bu ayar View için uygulandığında seviye setLevel() veya setImageLevel() ile değiştirilebilir.

ayrıca bkz.:

LevelListDrawable

Geçiş çizimi

TransitionDrawable, çekilebilir bir nesnedir geçiş yapabilirsiniz.

Her çekilebilir, tek bir <transition> öğesinin içinde bir <item> öğesiyle temsil edilir. En fazla iki öğe desteklenir. Geçiş yapmak için şu numarayı arayın: startTransition() Alıcı: işlemini geri almak için reverseTransition() numaralı telefonu arayın.

dosya konumu:

res/drawable/filename.xml
Dosya adı, kaynak kimliğidir

derlenen kaynak veri türü:

Kaynak işaretçisini bir TransitionDrawable

kaynak referansı:

. Java'da: R.drawable.filename
XML'de: @[package:]drawable/filename

söz dizimi:

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

öğeler:

örnek:

XML dosyası res/drawable/transition.xml itibarıyla kaydedildi:

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

Bu düzen XML'i, çekilebilir öğeyi görünüme uygular:

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

Ayrıca, aşağıdaki kod ilk öğeden ikinci öğeye 500 ms'lik bir geçiş yapar:

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);
}

ayrıca bkz.:

TransitionDrawable

Çekilebilir içeriden çekilebilir

XML'de tanımlanan ve belirtilen bir uzaklığa göre başka bir çekilebilir öğe ekleyen bir çekilebilir. Faydalı Görünüm, görünümün gerçek sınırlarından daha küçük bir arka plana ihtiyaç duyduğunda

dosya konumu:

res/drawable/filename.xml
Dosya adı, kaynak kimliğidir

derlenen kaynak veri türü:

Kaynak işaretçisini bir InsetDrawable

kaynak referansı:

. Java'da: R.drawable.filename
XML'de: @[package:]drawable/filename

söz dizimi:

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

öğeler:

örnek:

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

ayrıca bkz.:

InsetDrawable

Çekilebilir klip

XML'de tanımlı olan ve bu çekilebilirliğin mevcut seviyesine göre başka bir çekilebilirliği kırpan bir çekilebilir. Siz düzeye göre alt çekilebilir öğenin genişlik ve yüksekliğinin ne kadar kırpılacağını da kontrol edebilir yerleştirileceği yeri kontrol etmek için bir yerçekimi olarak kullanır. Uygulamada en sık kullanılan ilerleme çubukları gibi sesler var.

dosya konumu:

res/drawable/filename.xml
Dosya adı, kaynak kimliğidir

derlenen kaynak veri türü:

Kaynak işaretçisini bir ClipDrawable

kaynak referansı:

. Java'da: R.drawable.filename
XML'de: @[package:]drawable/filename

söz dizimi:

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

öğeler:

<clip>

Zorunlu. Çekilebilir klibi tanımlar. Bu, kök öğe olmalıdır.

Özellikler:

xmlns:android

Dize. Zorunludur. Şu olması gereken XML ad alanını tanımlar: "http://schemas.android.com/apk/res/android"

android:drawable

Çekilebilir kaynak. Zorunludur. Çekilebilir öğeye referans verme belirli bir kaynak vardır.

android:clipOrientation

Anahtar kelime. Klibin yönü.

Aşağıdaki sabit değerlerden biri olmalıdır:

Değer	Açıklama
`horizontal`	Çekilebilir öğeyi yatay olarak kırpın.
`vertical`	Çekmeceyi dikey olarak kırpın.

android:gravity

Anahtar kelime. Çekmece içinde klip oluşturmak istediğiniz yeri belirtir.

| ile ayrılmış aşağıdaki sabit değerlerden biri veya daha fazlası olmalıdır:

Değer	Açıklama
`top`	Nesneyi, boyutunu değiştirmeden kapsayıcının üst kısmına yerleştirin. `clipOrientation` değeri `"vertical"` olduğunda kırpma, çekilebilir öğenin alt kısmında gerçekleşir.
`bottom`	Nesneyi, boyutunu değiştirmeden kabının alt kısmına yerleştirin. `clipOrientation` değeri `"vertical"` olduğunda kırpma, çekilebilir öğenin üst kısmında gerçekleşir.
`left`	Nesneyi, boyutunu değiştirmeden kapsayıcının sol kenarına yerleştirin. Bu, varsayılandır. `clipOrientation` değeri `"horizontal"` olduğunda kırpma, videonun sağ tarafında gerçekleşir çekilebilir.
`right`	Nesneyi, boyutunu değiştirmeden kapsayıcının sağ kenarına yerleştirin. `clipOrientation` değeri `"horizontal"` olduğunda kırpma, videonun sol tarafında gerçekleşir çekilebilir.
`center_vertical`	Nesneyi, boyutunu değiştirmeden kapsayıcının dikey olarak ortasına yerleştirin. Kırpma davranışı yer çekiminin `"center"` olmasıyla aynıdır.
`fill_vertical`	Gerekirse nesnenin dikey boyutunu büyüterek kapsayıcıyı tamamen doldurmasını sağlayın. `clipOrientation` değeri `"vertical"` olduğunda, çekilebilir öğe dikey boşluk (çekilebilir düzey 0 olmadığı sürece görünür değildir).
`center_horizontal`	Nesneyi, boyutunu değiştirmeden kabının yatay merkezine yerleştirin. Kırpma, yer çekimi `"center"` olduğunda olduğu gibi davranır.
`fill_horizontal`	Gerekirse nesnenin yatay boyutunu büyüterek kapsayıcıyı tamamen doldurmasını sağlayın. Zaman `clipOrientation` `"horizontal"` şeklindedir, çekilebilir öğe yatay alan (çekilebilir düzey 0 değilse görünür değildir).
`center`	Nesneyi hem dikey hem de yatay eksende kapsayıcısının ortasına yerleştirin boyutunu değiştiriyor. `clipOrientation` `"horizontal"` olduğunda kırpma solda ve sağda gerçekleşir. `clipOrientation` `"vertical"` olduğunda, kırpma hem üstte hem de altta gerçekleşir.
`fill`	Gerekiyorsa nesnenin yatay ve dikey boyutunu büyüterek emin olun. Çekilebilir malzeme, resim yüklendikten sonra yatay ve dikey alan (çekilebilir düzey 0 değilse, bu durumda görünür).
`clip_vertical`	Alt ve/veya alt kenarların kırpılacağı şekilde ayarlanabilecek ek seçenek görebilirsiniz. Klip dikey yer çekimine dayalıdır: Üstteki yer çekimi alt kenar, alt yerçekimi üst kenarı klipslir ve iki kenarın ikisini de klip tutmaz.
`clip_horizontal`	Alt öğenin sol ve/veya sağ kenarlarının kırpılacağı şekilde ayarlanabilecek ek seçenek görebilirsiniz. Klip yatay yer çekimine dayalıdır: sol yer çekimi klipleri sağ kenarını temel alıyorsa, sağ yerçekimi sol kenarı klipslir ve iki kenarın ikisini de klip tutmaz.

örnek:

XML dosyası res/drawable/clip.xml itibarıyla kaydedildi:

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

Aşağıdaki düzen XML'i, klibi çekilebilir bir görünüme uygular:

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

Aşağıdaki kod, çekilebilir öğeyi alır ve kırpma miktarını bir şekilde gösterir:

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);
}

Seviyenin artırılması, kırpma miktarını azaltır ve resmi yavaşça ortaya çıkarır. İşte seviyesinde de kullanabilirsiniz:

Not: Varsayılan düzey 0'dır. Bu düzey, resmin tamamen kırpılması için görünür değil. Düzey 10.000 olduğunda resim kırpılmaz ve tamamen görünür olur.

ayrıca bkz.:

ClipDrawable

Çekilebilir ölçek

Şu anki değerine göre başka bir çekilebilir öğenin boyutunu değiştiren, XML'de tanımlı bir çekilebilirlik seviyesinde olmalıdır.

dosya konumu:

res/drawable/filename.xml
Dosya adı, kaynak kimliğidir

derlenen kaynak veri türü:

Kaynak işaretçisini bir ScaleDrawable

kaynak referansı:

. Java'da: R.drawable.filename
XML'de: @[package:]drawable/filename

söz dizimi:

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

öğeler:

<scale>

Zorunlu. Çekilebilir ölçeği tanımlar. Bu, kök öğe olmalıdır.

Özellikler:

xmlns:android

Dize. Zorunludur. Şu olması gereken XML ad alanını tanımlar: "http://schemas.android.com/apk/res/android"

android:drawable

Çekilebilir kaynak. Zorunludur. Çekilebilir öğeye referans verme gösterir.

android:scaleGravity

Anahtar kelime. Ölçeklendirmeden sonraki yer çekimi konumunu belirtir.

| ile ayrılmış aşağıdaki sabit değerlerden biri veya daha fazlası olmalıdır:

Değer	Açıklama
`top`	Nesneyi, boyutunu değiştirmeden kapsayıcının üst kısmına yerleştirin.
`bottom`	Nesneyi, boyutunu değiştirmeden kabının alt kısmına yerleştirin.
`left`	Nesneyi, boyutunu değiştirmeden kapsayıcının sol kenarına yerleştirin. Bu, varsayılandır.
`right`	Nesneyi, boyutunu değiştirmeden kapsayıcının sağ kenarına yerleştirin.
`center_vertical`	Nesneyi, boyutunu değiştirmeden kapsayıcının dikey olarak ortasına yerleştirin.
`fill_vertical`	Gerekirse nesnenin dikey boyutunu büyüterek kapsayıcıyı tamamen doldurmasını sağlayın.
`center_horizontal`	Nesneyi, boyutunu değiştirmeden kabının yatay merkezine yerleştirin.
`fill_horizontal`	Gerekirse nesnenin yatay boyutunu büyüterek kapsayıcıyı tamamen doldurmasını sağlayın.
`center`	Nesneyi hem dikey hem de yatay eksende kapsayıcısının ortasına yerleştirin boyutunu değiştiriyor.
`fill`	Gerekiyorsa nesnenin yatay ve dikey boyutunu büyüterek emin olun.
`clip_vertical`	Alt ve/veya alt kenarların kırpılacağı şekilde ayarlanabilecek ek seçenek görebilirsiniz. Klip dikey yer çekimine dayalıdır: Üstteki yer çekimi alt kenar, alt yerçekimi üst kenarı klipslir ve iki kenarın ikisini de klip tutmaz.
`clip_horizontal`	Alt öğenin sol ve/veya sağ kenarlarının kırpılacağı şekilde ayarlanabilecek ek seçenek görebilirsiniz. Klip yatay yer çekimine dayalıdır: sol yer çekimi klipleri sağ kenarını temel alıyorsa, sağ yerçekimi sol kenarı klipslir ve iki kenarın ikisini de klip tutmaz.

android:scaleHeight

Yüzde. Çekilebilir öğenin yüzdesi olarak ifade edilen ölçek yüksekliği bağlı. Değerin biçimi %XX şeklindedir (ör. %100 veya %12,5).

android:scaleWidth

Yüzde. Çekilebilir öğenin yüzdesi olarak ifade edilen ölçek genişliği bağlı. Değerin biçimi %XX şeklindedir (ör. %100 veya %12,5).

örnek:

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

ayrıca bkz.:

ScaleDrawable

Şekil çekilebilir

Bu, XML'de tanımlanan genel bir şekildir.

dosya konumu:

res/drawable/filename.xml
Dosya adı, kaynak kimliğidir

derlenen kaynak veri türü:

Kaynak işaretçisini bir GradientDrawable

kaynak referansı:

. Java'da: R.drawable.filename
XML'de: @[package:]drawable/filename

söz dizimi:

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

öğeler:

<shape>

Zorunlu. Çekilebilir şekil. Bu, kök öğe olmalıdır.

Özellikler:

xmlns:android

Dize. Zorunludur. Şu olması gereken XML ad alanını tanımlar: "http://schemas.android.com/apk/res/android"

android:shape

Anahtar kelime. Şeklin türünü tanımlar. Geçerli değerler şunlardır:

Değer	Açıklama
`"rectangle"`	Kapsayıcı görünümünü dolduran bir dikdörtgen. Bu, varsayılan şekildir.
`"oval"`	Kapsayıcı görünümün boyutlarına uyan oval şekil.
`"line"`	Kapsayıcı görünümün genişliğini kaplayan yatay çizgi. Bu şeklin genişliğini tanımlamak için `<stroke>` öğesi gerekir satırında görünür.
`"ring"`	Yüzük şekli.

Aşağıdaki özellikler yalnızca android:shape="ring" durumunda kullanılır:

android:innerRadius: Boyut. Yarıçap halkanın iç kısmını (ortadaki delik) bir boyut değeri veya boyut kaynağı olarak kullanın.
android:innerRadiusRatio: Kayan. İç yarıçapın yarıçapı halkanın bir bölümüdür ve halka genişliğinin oranı olarak ifade edilir. Örneğin, android:innerRadiusRatio="5" ise iç yarıçap, halkanın genişliğinin 5'e bölümüne eşittir. Bu değer android:innerRadius tarafından geçersiz kılındı. Varsayılan değer 9'dur.
android:thickness: Boyut. Kapağın kalınlığı Halka, boyut değeri veya boyut kaynağı olarak kullanılır.
android:thicknessRatio: Kayan. Yüzüğün kalınlığı halkanın genişliğinin oranı olarak ifade edilir. Örneğin, android:thicknessRatio="2" ise kalınlık, halka genişliğinin 2'ye bölümüne eşittir. Bu değer, android:innerRadius tarafından geçersiz kılındı. Varsayılan değer 3'tür.
android:useLevel: Boole. Bu ifade şu şekilde kullanılırsa True (doğru) değerine sahiptir: LevelListDrawable. Bu genellikle yanlıştır, Aksi takdirde, şekliniz görünmeyebilir.

<corners>

Şekil için yuvarlatılmış köşeler oluşturur. Yalnızca şekil dikdörtgen olduğunda geçerlidir.

Özellikler:

android:radius: Boyut. Boyut değeri veya boyut kaynağı olarak tüm köşelerin yarıçapı. Bu, her bir kampanya için geçersiz kılınır köşeyi aşağıdaki özelliklere göre ekleyebilirsiniz.
android:topLeftRadius: Boyut. Sol üst köşenin boyut değeri veya boyut kaynağı olarak yarıçapı.
android:topRightRadius: Boyut. Boyut değeri veya boyut kaynağı olarak sağ üst köşenin yarıçapı.
android:bottomLeftRadius: Boyut. Sol alt köşenin boyut değeri veya boyut kaynağı olarak yarıçapı.
android:bottomRightRadius: Boyut. Boyut değeri veya boyut kaynağı olarak sağ alt köşenin yarıçapı.

Not: Başlangıçta her köşeye bir köşe verilmelidir. yarıçapı 1'den büyük olursa köşeler yuvarlanmaz. Belirli köşeleri kullanmak isterseniz yuvarlanmaması için geçici bir çözüm, varsayılan köşeyi ayarlamak üzere android:radius kullanmaktır. ve ardından her köşeyi gerçekten belirlediğiniz değerlerle geçersiz kılın köşelerin yuvarlatılmasını istemediğiniz yerlerde 0 ("0dp") sağlayın.

<gradient>

Şeklin gradyan rengini belirtir.

Özellikler:

android:angle

Tamsayı. Gradyan açısının derece cinsinden değeri. 0 soldan sağa, 90 aşağıdan yukarıya doğru. 45'in katı olmalıdır. Varsayılan değer 0'dır.

android:centerX

Kayan. Gradyanın merkezi için göreli X konumu (0 - 1,0).

android:centerY

Kayan. Gradyanın merkezi için göreli Y konumu (0 - 1,0).

android:centerColor

Renk. Başlangıç ve bitiş renkleri arasında gelen isteğe bağlı renk, onaltılık değer veya renk kaynağı.

android:endColor

Renk. Onaltılık olarak bitiş rengi değer veya renk kaynağı.

android:gradientRadius

Kayan. Renk geçişinin yarıçapı. Yalnızca android:type="radial" tarihinde uygulanır.

android:startColor

Renk. Başlangıç rengi (onaltılık olarak) değer veya renk kaynağı.

android:type

Anahtar kelime. Uygulanacak gradyan kalıbının türü. Geçerli değerler şunlardır:

Değer	Açıklama
`"linear"`	Çizgisel bir gradyan. Bu, varsayılan ayardır.
`"radial"`	Dairesel gradyan. Başlangıç rengi ortanın rengidir.
`"sweep"`	Sürekli çizgi gradyanı.

android:useLevel

Boole. Bu bir LevelListDrawable olarak kullanılıyorsa doğru değerini döndürür.

<padding>

Kapsayıcı görünüm öğesine uygulanacak dolgu. Bu, görünümün yerini alır değil, içeriktir.

Özellikler:

android:left: Boyut. Boyut değeri veya boyut kaynağı olarak sol dolgu.
android:top: Boyut. Boyut değeri veya boyut kaynağı olarak üst dolgu.
android:right: Boyut. Boyut değeri veya boyut kaynağı olarak sağ dolgu.
android:bottom: Boyut. Boyut değeri veya boyut kaynağı olarak alt dolgu.

<size>

Şeklin boyutu.

Özellikler:

android:height: Boyut. Şeklin, boyut değeri veya boyut kaynağı olarak yüksekliği.
android:width: Boyut. Şeklin, boyut değeri veya boyut kaynağı olarak genişliği.

Not: Şekil, varsayılan olarak kapsayıcının boyutuna göre ölçeklendirilir burada tanımlanan boyutlarla orantılı olarak görüntüleyin. Şekli ImageView içinde kullanırken android:scaleType öğesini "center" olarak ayarlayarak ölçeklendirmeyi kısıtlayabilirsiniz.

<solid>

Şekli dolduracak düz renk.

Özellikler:

android:color: Renk. Şekle uygulanacak renk (onaltılı olarak) değer veya renk kaynağı.

<stroke>

Şekil için bir fırça çizgisi.

Özellikler:

android:width: Boyut. Çizginin, boyut değeri veya boyut kaynağı olarak kalınlığı.
android:color: Renk. Çizginin rengi onaltılık değer veya renk kaynağı.
android:dashGap: Boyut. Boyut değeri veya boyut kaynağı olarak çizgi kısa çizgileri arasındaki mesafe. Yalnızca android:dashWidth ayarlanmışsa geçerlidir.
android:dashWidth: Boyut. Her kısa çizginin, boyut değeri veya boyut kaynağı olarak boyutu. Yalnızca android:dashGap ayarlanmışsa geçerlidir.

örnek:

XML dosyası res/drawable/gradient_box.xml itibarıyla kaydedildi:

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

Bu düzen XML'i, şekli bir görünüme uygular:

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

Bu uygulama kodu, çizilebilir şekli alır ve bir görünüme uygular:

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

ayrıca bkz.:

ShapeDrawable

Renk durumu listesi

Düzen