Drawable 類別

定義

[Android.Runtime.Register("android/graphics/drawable/Drawable", DoNotGenerateAcw=true)]
public abstract class Drawable : Java.Lang.Object

[<Android.Runtime.Register("android/graphics/drawable/Drawable", DoNotGenerateAcw=true)>]
type Drawable = class
    inherit Object

繼承

Object

JavaObject

Object

Drawable

衍生

Android.Graphics.Drawables.AdaptiveIconDrawable

Android.Graphics.Drawables.AnimatedImageDrawable

Android.Graphics.Drawables.AnimatedVectorDrawable

Android.Graphics.Drawables.BitmapDrawable

Android.Graphics.Drawables.ColorDrawable

更多…

屬性

RegisterAttribute

備註

可繪製物是一種「可以被繪製的東西」的一般抽象概念。 通常你會用 Drawable 作為用來繪製畫面的資源;Drawable 類別提供一個通用的 API，用於處理底層的視覺資源，該資源可能呈現多種形式。 與 不同 android.view.View，繪製物件沒有接收事件或與使用者互動的功能。

除了簡單的繪圖外，Drawable 還提供多種通用機制，讓客戶端能與被繪製的物件互動：

<ul><li >#setBounds< 必須呼叫方法var></var>，以告訴繪製物件它被繪製的位置以及應該大小。 所有可繪圖都應該尊重所要求的尺寸，通常只要縮放影像即可。 客戶端可以透過 和 #getIntrinsicHeight 方法找到某些可繪圖物件#getIntrinsicWidth的首選大小。

<li> 這個 #getPadding 方法可以從某些可繪圖物件中回傳如何將置入其中的內容框定資訊。 例如，一個 Drawable 如果是按鈕小工具的框架，就需要回傳能正確將標籤置入自身內部的填充。

<li> 此 #setState 方法允許用戶端告訴可繪圖物件要繪製的狀態，例如「聚焦」、「選取」等。有些可繪圖物件可能會根據所選狀態修改影像。

<li> 此 #setLevel 方法允許用戶端提供單一連續控制器，以修改顯示的繪製文件，例如電池等級或進度等級。 有些可繪圖程式可能會根據當前關卡調整其影像。

<li> 一個可繪製的程式可以透過介面回調給客戶端 Callback 來執行動畫。 所有用戶端都應該支援這個介面（透過 #setCallback），這樣動畫才能正常運作。 一個簡單的方法是透過系統設施，如 android.view.View#setBackground(Drawable) 和 android.widget.ImageView。 </ul>

雖然通常應用程式看不到，可繪製圖可能有多種形式：

<ul><li><b>Bitmap</b>：最簡單的可繪圖，為 PNG 或 JPEG 圖片。 <li><b>Nine Patch</b>：PNG 格式的擴充功能允許它指定如何拉伸和放置物品的資訊。 <li><b>向量</b>：以XML檔案定義為一組點、線條和曲線及其相關顏色資訊的可繪圖物件。 這種可繪製圖可以縮放而不損失顯示品質。 <li><b>Shape</b>：包含簡單的繪圖指令，取代原始點陣圖，使得在某些情況下能更好地調整大小。 <li><b>Layers</b>：一種複合可繪圖，將多個底層可繪圖層疊加。 <li><b>狀態</b>：一種複合可繪圖，根據一組可繪圖的狀態選擇其中之一。 <li><b>Levels</b>：一種複合繪製物，根據其等級選擇一組可繪圖物。 <li><b>Scale</b>：一種複合繪製圖，僅有一個子繪圖，整體大小會根據當前等級調整。 </ul>

「自訂」><h3>自訂可繪圖/<h3>

所有 Android 版本都允許 Drawable 類別被擴充並在執行時取代框架提供的可繪製類別。 從 開始 android.os.Build.VERSION_CODES#N API 24，自訂繪製類別也可用於 XML 中。

<strong>Note：</strong> 自訂可繪製類別只能從你的應用程式套件中存取。 其他應用程式將無法載入這些檔案。

至少，自訂可繪製類別必須在 Drawable 上實作抽象方法，並應覆蓋繪 Drawable#draw(Canvas) 製內容的方法。

自訂可繪製類別在 XML 中可以多種方式使用： <ul><li> 使用完全限定的類別名稱作為 XML 元素名稱。 此方法中，自訂繪製類別必須是公開的頂層類別。

<com.myapp.MyCustomDrawable xmlns:android="http://schemas.android.com/apk/res/android"
                android:color="#ffff0000" />

</li>li 使用 em drawable</em> 作為 XML 元素名稱，並從 <em>class</em> 屬性指定完全限定的類別名稱。<><> 此方法可用於公開頂層類別與公開靜態內類別。

<drawable xmlns:android="http://schemas.android.com/apk/res/android"
                class="com.myapp.MyTopLevelClass$InnerCustomDrawable"
                android:color="#ffff0000" />

</li></ul>

<div class=“特殊參考”><h3>開發者指南</h3>

想了解更多如何使用 drawables，請閱讀 Canvas 和 Drawables 開發指南。 如需建立可繪製資源（XML 或可載入程式碼的點陣圖檔案）的資訊與範例，請閱讀 可繪製資源 文件。

</div>

Java 文件 android.graphics.drawable.Drawable。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。