RippleDrawable 類別

定義

命名空間:: Android.Graphics.Drawables

組件:: Mono.Android.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

可繪製的可繪圖物件會根據狀態變化產生漣漪效應。

[Android.Runtime.Register("android/graphics/drawable/RippleDrawable", DoNotGenerateAcw=true)]
public class RippleDrawable : Android.Graphics.Drawables.LayerDrawable

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

繼承: Object

JavaObject

Object

Drawable

LayerDrawable
RippleDrawable

屬性: RegisterAttribute

備註

可繪製的可繪圖物件會根據狀態變化產生漣漪效應。波紋在特定狀態下的錨定位置，可以透過呼叫 #setHotspot(float, float) 對應的狀態屬性識別碼來指定。

觸控反饋繪製圖可能包含多個子圖層，包括一個未繪製到螢幕上的特殊遮罩圖層。可將單一層設定為 XML 遮罩android:idandroid.R.id#mask。執行時，可以設定單一層作為遮罩 setId(..., android.R.id.mask) ，或用 setDrawableByLayerId(android.R.id.mask, ...)取代現有遮罩層。

<code>&lt;!-- A red ripple masked against an opaque rectangle. -->
            &lt;ripple android:color="#ffff0000">
              &lt;item android:id="@android:id/mask"
                    android:drawable="@android:color/white" />
            &lt;/ripple></code>

如果設定了遮罩圖層，波紋效應會在該圖層上遮罩，然後再繪製在剩餘子圖層的合成圖層上。

若未設定遮罩圖層，波紋效應會與子圖層的合成部分遮罩。

<code>&lt;!-- A green ripple drawn atop a black rectangle. -->
            &lt;ripple android:color="#ff00ff00">
              &lt;item android:drawable="@android:color/black" />
            &lt;/ripple>

            &lt;!-- A blue ripple drawn atop a drawable resource. -->
            &lt;ripple android:color="#ff0000ff">
              &lt;item android:drawable="@drawable/my_drawable" />
            &lt;/ripple></code>

若未指定子圖層或遮罩，且波紋設定為檢視背景，波紋將繪製在視圖階層中第一個可用的父背景上。此時繪製區域可能超出可繪製範圍。

<code>&lt;!-- An unbounded red ripple. -->
            &lt;ripple android:color="#ffff0000" /></code>

Java 文件 android.graphics.drawable.RippleDrawable。

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

建構函式

名稱	Description
RippleDrawable(ColorStateList, Drawable, Drawable)	建立一個新的波紋繪製物，並附有指定的波紋顏色及可選的內容與遮罩繪製物。
RippleDrawable(IntPtr, JniHandleOwnership)	用於建立 JNI 物件受管理表示的建構器;由執行時呼叫。

欄位

名稱	Description
InsetUndefined	用於未定義的起始與結束集的值。 (繼承來源 LayerDrawable)
PaddingModeNest	已淘汰. 填充模式用來將每層嵌套在前一層的填充中。 (繼承來源 LayerDrawable)
PaddingModeStack	已淘汰. 填充模式過去會將每層直接堆疊在前一層之上。 (繼承來源 LayerDrawable)
RadiusAuto	指定波動半徑的半徑值應根據波動容器的大小計算。

屬性

名稱	Description
Alpha	取得繪製物目前的 alpha 值。 (繼承來源 Drawable)
AutoMirrored	當該繪製物件的版面方向為 RTL 從右到左時，是否會自動鏡像。 -或- 設定當該繪製圖的佈局方向為 RTL（右至左）時，是否會自動鏡像。 (繼承來源 Drawable)
BottomPadding	回傳底部填充物（像素單位）。 (繼承來源 LayerDrawable)
Bounds	返回可繪製物的界限，Rect。 -或- 指定繪製的邊界矩形。 (繼承來源 Drawable)
Callback	回傳附加於此繪製物件的目前 `Callback` 實作。 (繼承來源 Drawable)
ChangingConfigurations	回傳一個設定參數的遮罩，該可繪製參數可能因此改變，需重新建立。 -或- 設定一個設定參數遮罩，使此可繪製參數可能改變，需重新建立。 (繼承來源 Drawable)
Class	回傳此 `Object`的執行時類別。 (繼承來源 Object)
ColorFilter	回傳目前的色彩濾鏡，或者 `null` 如果沒有設定，則回傳。 (繼承來源 Drawable)
Current	(繼承來源 Drawable)
DirtyBounds	把可繪圖的髒邊界還回去，Rect。 (繼承來源 Drawable)
EffectColor	設定漣漪效應的顏色。
EndPadding	回傳端部填充（像素數）。 (繼承來源 LayerDrawable)
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
HasFocusStateSpecified	表示此繪製文件是否至少有一個狀態規範明確指定 `android.R.attr#state_focused`。 (繼承來源 Drawable)
IntrinsicHeight	回傳繪製圖本身的高度。 (繼承來源 Drawable)
IntrinsicWidth	回傳可繪圖的內在寬度。 (繼承來源 Drawable)
IsFilterBitmap	可繪製的可繪圖物件會根據狀態變化產生漣漪效應。 (繼承來源 Drawable)
IsProjected	這個可繪製的可繪製物件是否要求投影。 (繼承來源 Drawable)
IsStateful	表示此可繪圖是否會根據狀態改變外觀。 (繼承來源 Drawable)
IsVisible	(繼承來源 Drawable)
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	可繪製的可繪圖物件會根據狀態變化產生漣漪效應。 (繼承來源 JavaObject)
JniPeerMembers	可繪製的可繪圖物件會根據狀態變化產生漣漪效應。
LayoutDirection	回傳此繪製物件的解析版面方向。 (繼承來源 Drawable)
LeftPadding	回傳左側填充（像素數）。 (繼承來源 LayerDrawable)
Level	取回當前關卡。 (繼承來源 Drawable)
MinimumHeight	回傳此繪製圖所示的最低高度。 (繼承來源 Drawable)
MinimumWidth	回傳此可繪圖物建議的最小寬度。 (繼承來源 Drawable)
NumberOfLayers	回傳該層內可繪製的圖層數量。 (繼承來源 LayerDrawable)
Opacity	還清這個可繪圖的透明度/透明度。 (繼承來源 LayerDrawable)
OpticalInsets	在插圖中回傳此可繪圖工具建議的佈局插圖，用於排版時的對齊操作。 (繼承來源 Drawable)
PaddingMode	規定圖層填充應如何影響後續圖層的界限。 (繼承來源 LayerDrawable)
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
Radius	設定完全展開波紋的半徑（以像素為單位）。
RightPadding	回傳正確的填充（像素數）。 (繼承來源 LayerDrawable)
StartPadding	回傳起始填充（以像素為單位）。 (繼承來源 LayerDrawable)
ThresholdClass	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。
ThresholdType	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。
TopPadding	回傳頂部填充（像素數）。 (繼承來源 LayerDrawable)
TransparentRegion	回傳一個區域，代表繪製物中完全透明的部分。 (繼承來源 Drawable)

方法

名稱	Description
AddLayer(Drawable)	在圖層清單末尾新增包含該圖 `drawable` 的圖層，並回傳其索引。 (繼承來源 LayerDrawable)
ApplyTheme(Resources+Theme)	將指定的主題套用到這個可繪圖物及其子體上。 (繼承來源 Drawable)
CanApplyTheme()	(繼承來源 Drawable)
ClearColorFilter()	移除了這個可繪製物的色彩濾鏡。 (繼承來源 Drawable)
Clone()	建立並回傳此物件的副本。 (繼承來源 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	可繪製的可繪圖物件會根據狀態變化產生漣漪效應。 (繼承來源 JavaObject)
CopyBounds()	在新的 Rect 中回傳可繪製範圍的副本。 (繼承來源 Drawable)
CopyBounds(Rect)	回傳指定 Rect（由呼叫者分配）中可繪製物件的界限副本。 (繼承來源 Drawable)
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	可繪製的可繪圖物件會根據狀態變化產生漣漪效應。 (繼承來源 JavaObject)
Draw(Canvas)	在可選效果（如 alpha（由 setAlpha 設定）和色彩濾鏡（透過 setColorFilter 設定）內繪製其界限。 (繼承來源 LayerDrawable)
Equals(Object)	可繪製的可繪圖物件會根據狀態變化產生漣漪效應。 (繼承來源 JavaObject)
Equals(Object)	表示是否有其他物體「等同」於此物。 (繼承來源 Object)
FindDrawableByLayerId(Int32)	尋找具有相同 ID 的圖層並回傳 `Drawable`。 (繼承來源 LayerDrawable)
FindIndexByLayerId(Int32)	回傳帶有指定 `id`的層。 (繼承來源 LayerDrawable)
GetConstantState()	回傳 `ConstantState` 一個持有此可繪圖（Drawable）共享狀態的實例。 (繼承來源 Drawable)
GetDrawable(Int32)	回傳該層在指定索引處的可繪圖物件。 (繼承來源 LayerDrawable)
GetHashCode()	回傳物件的雜湊碼值。 (繼承來源 Object)
GetHotspotBounds(Rect)	充滿 `outRect` 熱點範圍。 (繼承來源 Drawable)
GetId(Int32)	回傳指定層的 ID。 (繼承來源 LayerDrawable)
GetLayerGravity(Int32)	可繪製的可繪圖物件會根據狀態變化產生漣漪效應。 (繼承來源 LayerDrawable)
GetLayerHeight(Int32)	可繪製的可繪圖物件會根據狀態變化產生漣漪效應。 (繼承來源 LayerDrawable)
GetLayerInsetBottom(Int32)	可繪製的可繪圖物件會根據狀態變化產生漣漪效應。 (繼承來源 LayerDrawable)
GetLayerInsetEnd(Int32)	可繪製的可繪圖物件會根據狀態變化產生漣漪效應。 (繼承來源 LayerDrawable)
GetLayerInsetLeft(Int32)	可繪製的可繪圖物件會根據狀態變化產生漣漪效應。 (繼承來源 LayerDrawable)
GetLayerInsetRight(Int32)	可繪製的可繪圖物件會根據狀態變化產生漣漪效應。 (繼承來源 LayerDrawable)
GetLayerInsetStart(Int32)	可繪製的可繪圖物件會根據狀態變化產生漣漪效應。 (繼承來源 LayerDrawable)
GetLayerInsetTop(Int32)	可繪製的可繪圖物件會根據狀態變化產生漣漪效應。 (繼承來源 LayerDrawable)
GetLayerWidth(Int32)	可繪製的可繪圖物件會根據狀態變化產生漣漪效應。 (繼承來源 LayerDrawable)
GetOutline(Outline)	被呼叫來取得可繪圖物件，以填充定義其繪製區域的輪廓。 (繼承來源 Drawable)
GetPadding(Rect)	在填充中回傳此可繪圖工具建議的插入點，用於將內容置於可繪圖物件的範圍內。 (繼承來源 Drawable)
GetState()	描述當前狀態，作為原始狀態的聯集，例如 `android.R.attr#state_focused`、 `android.R.attr#state_selected`、等。 (繼承來源 Drawable)
Inflate(Resources, XmlReader, IAttributeSet, Resources+Theme)	從 XML 資源中膨脹這個可繪製物件。 (繼承來源 Drawable)
Inflate(Resources, XmlReader, IAttributeSet)	從 XML 資源中膨脹這個可繪製物件。 (繼承來源 Drawable)
InflateAsync(Resources, XmlReader, IAttributeSet, Resources+Theme)	可繪製的可繪圖物件會根據狀態變化產生漣漪效應。 (繼承來源 Drawable)
InflateAsync(Resources, XmlReader, IAttributeSet)	可繪製的可繪圖物件會根據狀態變化產生漣漪效應。 (繼承來源 Drawable)
InvalidateDrawable(Drawable)	當需要重新繪製可繪圖時會被呼叫。 (繼承來源 LayerDrawable)
InvalidateSelf()	用目前 `Callback` 的實作重新繪製這個可繪製圖。 (繼承來源 Drawable)
JavaFinalize()	已淘汰. 當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object)
JumpToCurrentState()	如果這個可繪製程式會在狀態間轉換動畫，請立即跳到當前狀態並跳過所有正在進行的動畫。 (繼承來源 Drawable)
Mutate()	讓這個可繪製的可變空間。 (繼承來源 Drawable)
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
OnBoundsChange(Rect)	如果你根據界限變化，可以在子職業中覆蓋這個設定，改變外觀。 (繼承來源 Drawable)
OnLayoutDirectionChanged(Int32)	當可繪圖的解析版面方向改變時呼叫。 (繼承來源 Drawable)
OnLevelChange(Int32)	在你的子職業中，如果等級不同，可以改變外觀。 (繼承來源 Drawable)
OnStateChange(Int32[])	如果你認出指定的狀態，可以覆寫你的子職業來改變外觀。 (繼承來源 Drawable)
ScheduleDrawable(Drawable, Action, Int64)	可繪製的可繪圖物件會根據狀態變化產生漣漪效應。 (繼承來源 LayerDrawable)
ScheduleDrawable(Drawable, IRunnable, Int64)	可繪製物件可以呼叫此參數來排程下一幀動畫。 (繼承來源 LayerDrawable)
ScheduleSelf(Action, Int64)	可繪製的可繪圖物件會根據狀態變化產生漣漪效應。 (繼承來源 Drawable)
ScheduleSelf(IRunnable, Int64)	使用目前 `Callback` 的實作來排程這個可繪製物件。 (繼承來源 Drawable)
SetAlpha(Int32)	指定可繪圖的 alpha 值。 0代表完全透明，255代表完全不透明。 (繼承來源 LayerDrawable)
SetBounds(Int32, Int32, Int32, Int32)	指定一個可繪製的邊界矩形。 (繼承來源 Drawable)
SetCallback(Drawable+ICallback)	把一個 `Callback` 物件綁定到這個可繪製物件上。 (繼承來源 Drawable)
SetColor(ColorStateList)	設定波紋顏色。
SetColorFilter(Color, PorterDuff+Mode)	指定一個顏色，並 Porter-Duff 模式作為這個可繪圖的色彩濾鏡。 (繼承來源 Drawable)
SetColorFilter(ColorFilter)	為可繪圖物件指定一個可選的色彩濾鏡。 (繼承來源 LayerDrawable)
SetDither(Boolean)	設為 true，使可繪製的顏色在繪製到每個色彩元件少於 8 位元的裝置時抖動其顏色。 (繼承來源 Drawable)
SetDrawable(Int32, Drawable)	將該圖層的繪製值設在指定的索引。 (繼承來源 LayerDrawable)
SetDrawableByLayerId(Int32, Drawable)	用給定的 ID 替換該圖層的。`Drawable` (繼承來源 LayerDrawable)
SetFilterBitmap(Boolean)	設為 true，讓可繪製的位圖在縮放或旋轉時會用雙線性取樣過濾。 (繼承來源 Drawable)
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetHotspot(Single, Single)	指定熱點在可繪圖中的位置。 (繼承來源 Drawable)
SetHotspotBounds(Int32, Int32, Int32, Int32)	設定熱點的限制範圍，若與可繪製的界限不同。 (繼承來源 Drawable)
SetId(Int32, Int32)	設定圖層的 ID。 (繼承來源 LayerDrawable)
SetLayerGravity(Int32, GravityFlags)	設定用於定位或拉伸指定層的重力。 (繼承來源 LayerDrawable)
SetLayerHeight(Int32, Int32)	可繪製的可繪圖物件會根據狀態變化產生漣漪效應。 (繼承來源 LayerDrawable)
SetLayerInset(Int32, Int32, Int32, Int32, Int32)	指定繪製可繪圖索引處的像素內嵌。 (繼承來源 LayerDrawable)
SetLayerInsetBottom(Int32, Int32)	可繪製的可繪圖物件會根據狀態變化產生漣漪效應。 (繼承來源 LayerDrawable)
SetLayerInsetEnd(Int32, Int32)	可繪製的可繪圖物件會根據狀態變化產生漣漪效應。 (繼承來源 LayerDrawable)
SetLayerInsetLeft(Int32, Int32)	可繪製的可繪圖物件會根據狀態變化產生漣漪效應。 (繼承來源 LayerDrawable)
SetLayerInsetRelative(Int32, Int32, Int32, Int32, Int32)	指定在指定索引處可繪製物件的相對像素內嵌。 (繼承來源 LayerDrawable)
SetLayerInsetRight(Int32, Int32)	可繪製的可繪圖物件會根據狀態變化產生漣漪效應。 (繼承來源 LayerDrawable)
SetLayerInsetStart(Int32, Int32)	可繪製的可繪圖物件會根據狀態變化產生漣漪效應。 (繼承來源 LayerDrawable)
SetLayerInsetTop(Int32, Int32)	可繪製的可繪圖物件會根據狀態變化產生漣漪效應。 (繼承來源 LayerDrawable)
SetLayerSize(Int32, Int32, Int32)	為指定層設定明確大小。 (繼承來源 LayerDrawable)
SetLayerWidth(Int32, Int32)	可繪製的可繪圖物件會根據狀態變化產生漣漪效應。 (繼承來源 LayerDrawable)
SetLayoutDirection(LayoutDirection)	設定這個繪製圖的版面方向。 (繼承來源 Drawable)
SetLevel(Int32)	指定可繪製物的等級。 (繼承來源 Drawable)
SetOpacity(Int32)	直接設定可繪圖物件的不透明度，而不是從圖層中收集狀態。 (繼承來源 LayerDrawable)
SetPadding(Int32, Int32, Int32, Int32)	設定絕對的緩衝。 (繼承來源 LayerDrawable)
SetPaddingRelative(Int32, Int32, Int32, Int32)	設定相對填充。 (繼承來源 LayerDrawable)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	可繪製的可繪圖物件會根據狀態變化產生漣漪效應。 (繼承來源 JavaObject)
SetState(Int32[])	指定一組可繪製的狀態。 (繼承來源 Drawable)
SetTint(Int32)	指定此繪圖的色調顏色。 (繼承來源 Drawable)
SetTintBlendMode(BlendMode)	指定此繪製物件的色調混合模式。 (繼承來源 Drawable)
SetTintList(ColorStateList)	指定此繪製物件的色調顏色，作為色彩狀態清單。 (繼承來源 Drawable)
SetTintMode(PorterDuff+Mode)	指定此繪製物件的色調混合模式。 (繼承來源 Drawable)
SetVisible(Boolean, Boolean)	設定這個可繪製物件是否可見。 (繼承來源 Drawable)
ToArray<T>()	從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object)
ToString()	回傳物件的字串表示。 (繼承來源 Object)
UnregisterFromRuntime()	將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object)
UnscheduleDrawable(Drawable, Action)	可繪製的可繪圖物件會根據狀態變化產生漣漪效應。 (繼承來源 LayerDrawable)
UnscheduleDrawable(Drawable, IRunnable)	可繪製者可以呼叫此來取消先前排程的行動。Drawable.ICallback (繼承來源 LayerDrawable)
UnscheduleSelf(Action)	可繪製的可繪圖物件會根據狀態變化產生漣漪效應。 (繼承來源 Drawable)
UnscheduleSelf(IRunnable)	使用目前 `Callback` 的實作，讓這個可繪製圖（Drawable）成為非排程。 (繼承來源 Drawable)
Wait()	導致目前執行緒等待被喚醒，通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object)
Wait(Int64, Int32)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)
Wait(Int64)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)

明確介面實作

名稱	Description
IJavaPeerable.Disposed()	可繪製的可繪圖物件會根據狀態變化產生漣漪效應。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	可繪製的可繪圖物件會根據狀態變化產生漣漪效應。 (繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	可繪製的可繪圖物件會根據狀態變化產生漣漪效應。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	可繪製的可繪圖物件會根據狀態變化產生漣漪效應。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	可繪製的可繪圖物件會根據狀態變化產生漣漪效應。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	可繪製的可繪圖物件會根據狀態變化產生漣漪效應。 (繼承來源 JavaObject)
IJavaPeerable.UnregisterFromRuntime()	可繪製的可繪圖物件會根據狀態變化產生漣漪效應。 (繼承來源 LayerDrawable)

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 `self`類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	可繪製的可繪圖物件會根據狀態變化產生漣漪效應。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。

適用於