AppWidgetProvider 類別

定義

命名空間:: Android.Appwidget

組件:: Mono.Android.dll

重要

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

一個方便類別，協助實作 AppWidget 提供者。

[Android.Runtime.Register("android/appwidget/AppWidgetProvider", DoNotGenerateAcw=true)]
public class AppWidgetProvider : Android.Content.BroadcastReceiver

[<Android.Runtime.Register("android/appwidget/AppWidgetProvider", DoNotGenerateAcw=true)>]
type AppWidgetProvider = class
    inherit BroadcastReceiver

繼承: Object

JavaObject

Object

BroadcastReceiver
AppWidgetProvider

屬性: RegisterAttribute

備註

一個方便類別，協助實作 AppWidget 提供者。你能用 AppWidgetProvider 做的事，都可以用一般 BroadcastReceiver的 WidgetProvider 來做。 AppWidgetProvider 僅解析在中接收 #onReceive(Context,Intent) onReceive(Context,Intent)的 Intent 中相關欄位，並用收到的額外資料呼叫掛鉤方法。

擴充此類別並覆寫一個或多個 #onUpdate、 #onDeleted或 #onEnabled#onDisabled 方法，以實作您自己的 AppWidget 功能。

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

欲了解更多如何撰寫應用程式小工具提供者的資訊，請參閱 App Widgets 開發者指南。

</div>

Java 文件 android.appwidget.AppWidgetProvider。

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

建構函式

名稱	Description
AppWidgetProvider()	用來初始化 AppWidgetProvider。
AppWidgetProvider(IntPtr, JniHandleOwnership)	用於建立 JNI 物件受管理表示的建構器;由執行時呼叫。

屬性

名稱	Description
AbortBroadcast	回傳該接收器是否應中止當前廣播的旗標。 (繼承來源 BroadcastReceiver)
Class	回傳此 `Object`的執行時類別。 (繼承來源 Object)
DebugUnregister	返回給 `#setDebugUnregister`的最後一個值。 -或- 控制包含針對不匹配呼叫 `Context#registerReceiver(BroadcastReceiver, IntentFilter) Context.registerReceiver()`的除錯協助。 (繼承來源 BroadcastReceiver)
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
IsInitialStickyBroadcast	如果接收器目前正在處理黏性廣播的初始值——也就是最後一次廣播且目前保存在黏性快取中的值，則回傳為真，因此這並非目前廣播的直接結果。 (繼承來源 BroadcastReceiver)
IsOrderedBroadcast	若接收端目前正在處理有序廣播，則回傳為真。 (繼承來源 BroadcastReceiver)
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	一個方便類別，協助實作 AppWidget 提供者。 (繼承來源 JavaObject)
JniPeerMembers	一個方便類別，協助實作 AppWidget 提供者。
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
ResultCode	取回先前接收器設定的當前結果碼。 -或- 更改本次廣播的現行結果代碼;只適用於透過 `Context#sendOrderedBroadcast(Intent, String) Context.sendOrderedBroadcast`的廣播。 (繼承來源 BroadcastReceiver)
ResultData	取回先前接收器設定的當前結果資料。 -或- 更改本次廣播的當前結果資料;只適用於透過 `Context#sendOrderedBroadcast(Intent, String) Context.sendOrderedBroadcast`的廣播。 (繼承來源 BroadcastReceiver)
SentFromPackage	會回傳最初發送此廣播的應用程式的套件名稱。 (繼承來源 BroadcastReceiver)
SentFromUid	會回傳最初發送此廣播的應用程式的 UID。 (繼承來源 BroadcastReceiver)
ThresholdClass	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。
ThresholdType	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。

方法

名稱	Description
ClearAbortBroadcast()	清除旗標，表示接收器應中止當前廣播。 (繼承來源 BroadcastReceiver)
Clone()	建立並回傳此物件的副本。 (繼承來源 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	一個方便類別，協助實作 AppWidget 提供者。 (繼承來源 JavaObject)
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	一個方便類別，協助實作 AppWidget 提供者。 (繼承來源 JavaObject)
Equals(Object)	一個方便類別，協助實作 AppWidget 提供者。 (繼承來源 JavaObject)
Equals(Object)	表示是否有其他物體「等同」於此物。 (繼承來源 Object)
GetHashCode()	回傳物件的雜湊碼值。 (繼承來源 Object)
GetResultExtras(Boolean)	取得先前接收器設定的當前額外結果資料。 (繼承來源 BroadcastReceiver)
GoAsync()	應用程式可以呼叫這個 `#onReceive` 功能，讓它在從該功能返回後仍能保持廣播活動。 (繼承來源 BroadcastReceiver)
InvokeAbortBroadcast()	設定旗標，指示該接收器應中止當前廣播;只適用於透過 `Context#sendOrderedBroadcast(Intent, String) Context.sendOrderedBroadcast`的廣播。 (繼承來源 BroadcastReceiver)
JavaFinalize()	已淘汰. 當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object)
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
OnAppWidgetOptionsChanged(Context, AppWidgetManager, Int32, Bundle)	當此小工具以新大小排列或透過更改`AppWidgetManager#ACTION_APPWIDGET_OPTIONS_CHANGED`選項時，會被呼叫於廣播後`AppWidgetManager#updateAppWidgetOptions`。
OnDeleted(Context, Int32[])	當一個或多個 AppWidget 實例被刪除時，該系統 `AppWidgetManager#ACTION_APPWIDGET_DELETED` 會回應廣播。
OnDisabled(Context)	當該提供者的最後一個 AppWidget 實例被刪除時，會對廣播進行回應 `AppWidgetManager#ACTION_APPWIDGET_DISABLED` 而呼叫。
OnEnabled(Context)	當該提供者的 AppWidget 實例化時，會回應廣播而 `AppWidgetManager#ACTION_APPWIDGET_ENABLED` 呼叫。
OnReceive(Context, Intent)	實作 `BroadcastReceiver#onReceive` 用來派遣呼叫至 AppWidgetProvider 上的其他各種方法。
OnRestored(Context, Int32[], Int32[])	當該 AppWidget 提供者的實例從備份中恢復時，回應廣播而呼叫 `AppWidgetManager#ACTION_APPWIDGET_RESTORED` 。
OnUpdate(Context, AppWidgetManager, Int32[])	當 AppWidget 提供者被要求提供`AppWidgetManager#ACTION_APPWIDGET_UPDATE`一組 AppWidgets 時，會被呼叫`AppWidgetManager#ACTION_APPWIDGET_RESTOREDandroid.widget.RemoteViews RemoteViews`並廣播。
PeekService(Context, Intent)	提供一份已綁定的服務資料夾。 (繼承來源 BroadcastReceiver)
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetOrderedHint(Boolean)	內部使用時，會提示該廣播接收器是否以有序模式運行。 (繼承來源 BroadcastReceiver)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	一個方便類別，協助實作 AppWidget 提供者。 (繼承來源 JavaObject)
SetResult(Result, String, Bundle)	更改所有從此廣播回傳的結果資料;只適用於透過 `Context#sendOrderedBroadcast(Intent, String) Context.sendOrderedBroadcast`的廣播。 (繼承來源 BroadcastReceiver)
SetResultExtras(Bundle)	更改本次轉播的額外內容;只適用於透過 `Context#sendOrderedBroadcast(Intent, String) Context.sendOrderedBroadcast`的廣播。 (繼承來源 BroadcastReceiver)
ToArray<T>()	從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object)
ToString()	回傳物件的字串表示。 (繼承來源 Object)
UnregisterFromRuntime()	將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object)
Wait()	導致目前執行緒等待被喚醒，通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object)
Wait(Int64, Int32)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)
Wait(Int64)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)

明確介面實作

名稱	Description
IJavaPeerable.Disposed()	一個方便類別，協助實作 AppWidget 提供者。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	一個方便類別，協助實作 AppWidget 提供者。 (繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	一個方便類別，協助實作 AppWidget 提供者。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	一個方便類別，協助實作 AppWidget 提供者。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	一個方便類別，協助實作 AppWidget 提供者。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	一個方便類別，協助實作 AppWidget 提供者。 (繼承來源 JavaObject)

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 `self`類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	一個方便類別，協助實作 AppWidget 提供者。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。

適用於