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

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 當作擷取的資源類型來處理，以便將專案繪製到螢幕;Drawable 類別提供一般 API 來處理可能採用各種形式的基礎視覺資源。 android.view.View不同於 ，Drawable 沒有接收事件或與用戶互動的任何功能。

除了簡單的繪圖之外，Drawable 還提供一些泛型機制，讓其用戶端與正在繪製的內容互動：

<ul>li 呼叫#setBounds方法 <var>必須</var>，才能告訴 Drawable 繪製的位置，以及它應該有多大。>< 所有 Drawables 都應該遵守要求的大小，通常只要調整其影像即可。 用戶端可以使用 和 #getIntrinsicWidth 方法來尋找某些 Drawables 的慣用#getIntrinsicHeight大小。

<li> 方法 #getPadding 可以傳回一些 Drawables 資訊，說明如何框出放置在其中的內容。 例如，要成為按鈕小工具框架的 Drawable，必須傳回正確放置標籤本身的邊框間距。

<li> 方法 #setState 可讓用戶端告訴要繪製的 Drawable，例如「焦點」、「已選取」等。某些可繪製專案可能會根據選取的狀態修改其影像。

<li> 方法 #setLevel 可讓用戶端提供可修改 Drawable 的單一連續控制器，例如電池電量或進度等級。 某些可繪製專案可能會根據目前的層級修改其影像。

<li> A Drawable 可以透過 Callback 介面回呼至其客戶端來執行動畫。 所有客戶端都應該支援此介面（透過 #setCallback），讓動畫能夠運作。 執行這項操作的簡單方式是透過和 android.widget.ImageView等android.view.View#setBackground(Drawable)系統設施。 </ul>

雖然應用程式通常看不到，但 Drawables 可能採用各種形式：

<ul><li><b>Bitmap</b>：最簡單的可繪製、PNG 或 JPEG 影像。 <li><b>Nine Patch</b>:P NG 格式的延伸模組可讓它指定如何伸展和將東西放在其中的資訊。 <li><b>Vector</b>：XML 檔案中定義為一組點、線條和曲線的可繪製專案，以及其相關聯的色彩資訊。 這種類型的可繪製可調整，而不會遺失顯示器品質。 <li><b>Shape</b>：包含簡單的繪圖命令，而不是原始點陣圖，以便在某些情況下更妥善地調整大小。 <li><b>圖層</b>：復合可繪製，它會在彼此頂端繪製多個基礎可繪製。 <li><b>States</b>：根據其狀態選取一組可繪製的複合可繪製專案。 <li><b>層級</b>：復合可繪製，可根據其層級選取一組可繪製的其中一個。 <li><b>Scale</b>：具有單一子系可繪製的複合繪製單位，其整體大小會根據目前的層級進行修改。 </ul>

“Custom”><h3>自定義可繪製專案</h3>

所有版本的 Android 都允許擴充 Drawable 類別，並在運行時間使用，以取代架構提供的可繪製類別。 android.os.Build.VERSION_CODES#N API 24從 開始，自定義可繪製類別也可用於 XML。

<strong>Note：</strong> Custom 可繪製類別只能從您的應用程式套件記憶體取。 其他應用程式將無法載入它們。

自定義可繪製類別至少必須在 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> 類別</em> 屬性指定完整類別名稱。< 這個方法可用於公用最上層類別和公用靜態內部類別。

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

</li></ul>

<div class=“special reference”><h3>Developer Guides</h3>

如需如何使用可繪製專案的詳細資訊，請參閱 Canvas 和 Drawables 開發人員指南。 如需建立可繪製資源的資訊和範例（可在程式代碼中載入的 XML 或點陣圖檔案），請閱讀 可繪製的資源 檔。

</div>

的 android.graphics.drawable.DrawableJava 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。

建構函式

屬性

方法

明確介面實作

擴充方法

適用於