AppWidgetManager 類別

定義

命名空間:

Android.Appwidget

組件:

Mono.Android.dll

更新 AppWidget 狀態;取得已安裝的 AppWidget 提供者及其他 AppWidget 相關狀態資訊。

[Android.Runtime.Register("android/appwidget/AppWidgetManager", DoNotGenerateAcw=true)]
public class AppWidgetManager : Java.Lang.Object

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

繼承

Object

JavaObject

Object

AppWidgetManager

屬性

RegisterAttribute

備註

更新 AppWidget 狀態;取得已安裝的 AppWidget 提供者及其他 AppWidget 相關狀態資訊。

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

想了解更多關於建立應用程式小工具的資訊，請閱讀 App Widgets 開發者指南。

</div>

Java 文件 android.appwidget.AppWidgetManager。

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

建構函式

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

欄位

名稱	Description
ActionAppwidgetBind	當你想將 AppWidget 綁定為顯示並綁定 AppWidgetIdIdIfAllowed 時，從你的 AppWidgetHost 活動啟動的活動動作會回傳 false。
ActionAppwidgetConfigure	在設定 AppWidget 並加入主機時發送。
ActionAppwidgetDeleted	當 AppWidget 的實例從主機上刪除時會發送。
ActionAppwidgetDisabled	當該服務提供者的最後一個 AppWidget 從最後一台主機移除時，會傳送。
ActionAppwidgetEnabled	當 AppWidget 的實例首次被加入主機時會傳送。
ActionAppwidgetHostRestored	在與主機相關的 AppWidget 狀態從備份中恢復後，才會傳送給 widget 主機。
ActionAppwidgetOptionsChanged	當 AppWidget 的自訂額外內容變更時會發送。
ActionAppwidgetPick	活動動作，當你想選擇 AppWidget 顯示時，從你的 AppWidgetHost 活動中啟動。
ActionAppwidgetRestored	在該供應商從備份還原後，傳送到 AppWidgetProvider 與 AppWidget 相關的狀態。
ActionAppwidgetUpdate	更新你的 AppWidget 時會發送。
ExtraAppwidgetId	一個包含一個 appWidgetId 的意圖額外（int）。
ExtraAppwidgetIds	一個包含多個 appWidgetIds 的意圖額外內容。
ExtraAppwidgetOldIds	一個包含多個 appWidgetIds 的意圖額外內容。
ExtraAppwidgetOptions	一個指向特定元件 ID 額外資訊束的意圖額外。
ExtraAppwidgetPreview	一個可以傳遞給 #requestPinAppWidget(ComponentName, Bundle, PendingIntent)的額外。
ExtraAppwidgetProvider	一個包含 AppWidget 提供者元件名稱的意圖額外。
ExtraAppwidgetProviderProfile	一個意圖額外，包含註冊 AppWidget 提供者的個人帳號使用者帳號。
ExtraCustomExtras	一個意圖額外內容，傳送給 AppWidget 選擇器，包含 java.util.List 一組 android.os.Bundle 物件，用以混合到已安裝的 AppWidgets 清單中。
ExtraCustomInfo	一個意圖額外內容，傳送給 AppWidget 選擇器，包含 java.util.List 一組 AppWidgetProviderInfo 物件，用以混合到已安裝的 AppWidgets 清單中。
ExtraHostId	一個附帶在廣播上的 #ACTION_APPWIDGET_HOST_RESTORED 意圖額外內容，顯示剛恢復小工具的主機的整數 ID。
InvalidAppwidgetId	一個 AppWidget 管理器永遠不會以 appWidgetID 回傳的哨兵值。
MetaDataAppwidgetProvider	欄位用於清單元資料標籤。
OptionAppwidgetDisplayId	一個組合額外（int），用來表示該小工具目前正在哪個顯示器上顯示。
OptionAppwidgetHostCategory	一個附加內容，暗示 AppWidgetProvider 擁有該 widget 的主機類別。
OptionAppwidgetMaxHeight	一個包含元件實例當前寬度（凹位）的束額外（int）。
OptionAppwidgetMaxWidth	一個包含元件實例當前寬度（凹位）的束額外（int）。
OptionAppwidgetMinHeight	一個包含元件實例當前高度下界（凹位）的束額外（int）。
OptionAppwidgetMinWidth	一個包含元件實例當前寬度下界（以凹位計）的束額外（int）。
OptionAppwidgetRestoreCompleted	一個包含應用程式是否完成還原小工具的附加包（布林值）。
OptionAppwidgetSizes	一個包含可能大小列表的 bundle extraList<SizeF>（），以 dips 表示，widget 實例可取。

屬性

名稱	Description
Class	回傳此 Object的執行時類別。 (繼承來源 Object)
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
InstalledProviders	回傳目前已安裝的 AppWidget 提供者清單。
IsRequestPinAppWidgetSupported	true如果預設啟動器支援 #requestPinAppWidget(ComponentName, Bundle, PendingIntent)。
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	更新 AppWidget 狀態;取得已安裝的 AppWidget 提供者及其他 AppWidget 相關狀態資訊。 (繼承來源 JavaObject)
JniPeerMembers	更新 AppWidget 狀態;取得已安裝的 AppWidget 提供者及其他 AppWidget 相關狀態資訊。
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
ThresholdClass	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。
ThresholdType	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。

方法

名稱	Description
BindAppWidgetId(Int32, ComponentName)	設定給定 appWidgetID 的元件。
BindAppWidgetIdIfAllowed(Int32, ComponentName, Bundle)	設定給定 appWidgetID 的元件。
BindAppWidgetIdIfAllowed(Int32, ComponentName)	設定給定 appWidgetID 的元件。
BindAppWidgetIdIfAllowed(Int32, UserHandle, ComponentName, Bundle)	如果呼叫者有權限，請設定該 appWidgetID 的提供者。
Clone()	建立並回傳此物件的副本。 (繼承來源 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	更新 AppWidget 狀態;取得已安裝的 AppWidget 提供者及其他 AppWidget 相關狀態資訊。 (繼承來源 JavaObject)
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	更新 AppWidget 狀態;取得已安裝的 AppWidget 提供者及其他 AppWidget 相關狀態資訊。 (繼承來源 JavaObject)
Equals(Object)	更新 AppWidget 狀態;取得已安裝的 AppWidget 提供者及其他 AppWidget 相關狀態資訊。 (繼承來源 JavaObject)
Equals(Object)	表示是否有其他物體「等同」於此物。 (繼承來源 Object)
GetAppWidgetIds(ComponentName)	取得綁定到指定 AppWidget 提供者的 appWidgetIds 清單。
GetAppWidgetInfo(Int32)	回傳 AppWidgetProviderInfo 指定的 AppWidget。
GetAppWidgetOptions(Int32)	取得與特定小工具實例相關的額外內容。
GetHashCode()	回傳物件的雜湊碼值。 (繼承來源 Object)
GetInstalledProvidersForPackage(String, UserHandle)	取得該套件的 AppWidget 提供者及使用者設定檔。
GetInstalledProvidersForProfile(UserHandle)	取得該用戶資料的 AppWidget 供應商。
GetInstance(Context)	取得 AppWidgetManager 實例來執行所提供 android.content.Context Context 物件。
GetWidgetPreview(ComponentName, UserHandle, AppWidgetCategory)	取得此小工具的 RemoteViews 預覽。
JavaFinalize()	已淘汰. 當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object)
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
NotifyAppWidgetViewDataChanged(Int32, Int32)	通知指定 AppWidget 實例中指定的集合檢視，使其資料失效。
NotifyAppWidgetViewDataChanged(Int32[], Int32)	通知所有指定 AppWidget 實例中的集合檢視，使其資料失效。
PartiallyUpdateAppWidget(Int32, RemoteViews)	對由 appWidgetID 指定的元件執行增量更新或指令。
PartiallyUpdateAppWidget(Int32[], RemoteViews)	對 appWidgetID 指定的元件執行增量更新或指令。
QueryAppWidgetEvents(Int64, Int64)	查詢在指定時間範圍內的應用程式小工具互動事件。
RemoveWidgetPreview(ComponentName, AppWidgetCategory)	移除此提供者對指定元件類別的預覽功能。
RequestPinAppWidget(ComponentName, Bundle, PendingIntent)	請求將應用程式小工具釘選到目前啟動器上。
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	更新 AppWidget 狀態;取得已安裝的 AppWidget 提供者及其他 AppWidget 相關狀態資訊。 (繼承來源 JavaObject)
SetWidgetPreview(ComponentName, AppWidgetCategory, RemoteViews)	為此小工具設定預覽。
ToArray<T>()	從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object)
ToString()	回傳物件的字串表示。 (繼承來源 Object)
UnregisterFromRuntime()	將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object)
UpdateAppWidget(ComponentName, RemoteViews)	將 RemoteViews 設定為所有 AppWidget 實例的 AppWidget 提供者使用。
UpdateAppWidget(Int32, RemoteViews)	將 RemoteViews 設定為用於指定的 appWidgetId。
UpdateAppWidget(Int32[], RemoteViews)	將 RemoteViews 設定為用於指定的 appWidgetIds。
UpdateAppWidgetOptions(Int32, Bundle)	更新某個小工具實例的額外內容。
UpdateAppWidgetProviderInfo(ComponentName, String)	更新所提供的 AppWidget 提供者資訊。
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 狀態;取得已安裝的 AppWidget 提供者及其他 AppWidget 相關狀態資訊。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	更新 AppWidget 狀態;取得已安裝的 AppWidget 提供者及其他 AppWidget 相關狀態資訊。 (繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	更新 AppWidget 狀態;取得已安裝的 AppWidget 提供者及其他 AppWidget 相關狀態資訊。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	更新 AppWidget 狀態;取得已安裝的 AppWidget 提供者及其他 AppWidget 相關狀態資訊。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	更新 AppWidget 狀態;取得已安裝的 AppWidget 提供者及其他 AppWidget 相關狀態資訊。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	更新 AppWidget 狀態;取得已安裝的 AppWidget 提供者及其他 AppWidget 相關狀態資訊。 (繼承來源 JavaObject)

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 self類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制self輸入 TResult，檢查 強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	更新 AppWidget 狀態;取得已安裝的 AppWidget 提供者及其他 AppWidget 相關狀態資訊。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制self輸入 TResult，檢查 強制在 Java 端是否有效。