Most visited

Recently visited

Added in API level 3

AppWidgetHostView

public class AppWidgetHostView
extends FrameLayout

java.lang.Object
   ↳ android.view.View
     ↳ android.view.ViewGroup
       ↳ android.widget.FrameLayout
         ↳ android.appwidget.AppWidgetHostView


提供粘贴以显示AppWidget视图。 此课程在更新之间提供自动动画,并会尝试为每个传入的RemoteViews回收旧视图。

Summary

Inherited XML attributes

From class android.widget.FrameLayout
From class android.view.ViewGroup
From class android.view.View

Inherited constants

From class android.view.ViewGroup
From class android.view.View

Inherited fields

From class android.view.View

Public constructors

AppWidgetHostView(Context context)

创建一个主机视图。

AppWidgetHostView(Context context, int animationIn, int animationOut)

创建一个主机视图。

Public methods

FrameLayout.LayoutParams generateLayoutParams(AttributeSet attrs)

根据提供的属性集返回一组新的布局参数。

int getAppWidgetId()
AppWidgetProviderInfo getAppWidgetInfo()
static Rect getDefaultPaddingForWidget(Context context, ComponentName component, Rect padding)

从ICE_CREAM_SANDWICH开始,我们将自动添加填充到面向ICE_CREAM_SANDWICH和更高级别的窗口小部件。

void setAppWidget(int appWidgetId, AppWidgetProviderInfo info)

设置将由此视图显示的AppWidget。

void updateAppWidget(RemoteViews remoteViews)

处理一组 RemoteViews作为来自AppWidget提供程序的更新。

void updateAppWidgetOptions(Bundle options)

为小部件提供者指定一些额外的信息。

void updateAppWidgetSize(Bundle newOptions, int minWidth, int minHeight, int maxWidth, int maxHeight)

向AppWidgetManager提供有关此小部件大小的指导。

Protected methods

void dispatchRestoreInstanceState(SparseArray<Parcelable> container)

restoreHierarchyState(android.util.SparseArray)调用以检索此视图及其子项的状态。

void dispatchSaveInstanceState(SparseArray<Parcelable> container)

saveHierarchyState(android.util.SparseArray)调用以存储此视图及其子项的状态。

boolean drawChild(Canvas canvas, View child, long drawingTime)

绘制这个视图组的一个孩子。

View getDefaultView()

膨胀并返回AppWidget提供者请求的默认布局。

View getErrorView()

膨胀并返回代表错误状态的视图。

void onLayout(boolean changed, int left, int top, int right, int bottom)

当这个视图为每个孩子分配一个大小和位置时,从布局调用。

void prepareView(View view)

准备要显示的给定视图。

Inherited methods

From class android.widget.FrameLayout
From class android.view.ViewGroup
From class android.view.View
From class java.lang.Object
From interface android.view.ViewParent
From interface android.view.ViewManager
From interface android.graphics.drawable.Drawable.Callback
From interface android.view.KeyEvent.Callback
From interface android.view.accessibility.AccessibilityEventSource

Public constructors

AppWidgetHostView

Added in API level 3
AppWidgetHostView (Context context)

创建一个主机视图。 使用默认的淡入淡出动画。

Parameters
context Context

AppWidgetHostView

Added in API level 3
AppWidgetHostView (Context context, 
                int animationIn, 
                int animationOut)

创建一个主机视图。 updateAppWidget(RemoteViews)时使用指定的动画。

Parameters
context Context
animationIn int: Resource ID of in animation to use
animationOut int: Resource ID of out animation to use

Public methods

generateLayoutParams

Added in API level 3
FrameLayout.LayoutParams generateLayoutParams (AttributeSet attrs)

根据提供的属性集返回一组新的布局参数。

Parameters
attrs AttributeSet: the attributes to build the layout parameters from
Returns
FrameLayout.LayoutParams an instance of ViewGroup.LayoutParams or one of its descendants

getAppWidgetId

Added in API level 3
int getAppWidgetId ()

Returns
int

getAppWidgetInfo

Added in API level 3
AppWidgetProviderInfo getAppWidgetInfo ()

Returns
AppWidgetProviderInfo

getDefaultPaddingForWidget

Added in API level 15
Rect getDefaultPaddingForWidget (Context context, 
                ComponentName component, 
                Rect padding)

从ICE_CREAM_SANDWICH开始,我们将自动添加填充到面向ICE_CREAM_SANDWICH和更高级别的窗口小部件。 新的小部件设计指南强烈建议小部件开发人员不要向其小部件添加额外的填充。 这将有助于实现小部件之间的一致性。 注意:只有AppWidgetHosts的开发人员需要此方法。 提供此方法是为了使AppWidgetHost在计算要分配给特定窗口小部件的单元数时自动填充自动填充。

Parameters
context Context: the current context
component ComponentName: the component name of the widget
padding Rect: Rect in which to place the output, if null, a new Rect will be allocated and returned
Returns
Rect default padding for this widget, in pixels

setAppWidget

Added in API level 3
void setAppWidget (int appWidgetId, 
                AppWidgetProviderInfo info)

设置将由此视图显示的AppWidget。 此方法还将默认填充添加到窗口小部件,如getDefaultPaddingForWidget(Context, ComponentName, Rect)所述,并且可以重写以添加自定义填充。

Parameters
appWidgetId int
info AppWidgetProviderInfo

updateAppWidget

Added in API level 3
void updateAppWidget (RemoteViews remoteViews)

处理一组RemoteViews作为来自AppWidget提供程序的更新。 将根据需要动画进入这些新视图

Parameters
remoteViews RemoteViews

updateAppWidgetOptions

Added in API level 16
void updateAppWidgetOptions (Bundle options)

为小部件提供者指定一些额外的信息。 导致对AppWidgetProvider的回调。

Parameters
options Bundle: The bundle of options information.

也可以看看:

updateAppWidgetSize

Added in API level 16
void updateAppWidgetSize (Bundle newOptions, 
                int minWidth, 
                int minHeight, 
                int maxWidth, 
                int maxHeight)

向AppWidgetManager提供有关此小部件大小的指导。 宽度和高度应该与AppWidgetHostView的完整区域相对应。 框架添加的填充将自动计入。 这些信息嵌入到AppWidget选项中,并导致对AppWidgetProvider的回调。

Parameters
newOptions Bundle: The bundle of options, in addition to the size information, can be null.
minWidth int: The minimum width in dips that the widget will be displayed at.
minHeight int: The maximum height in dips that the widget will be displayed at.
maxWidth int: The maximum width in dips that the widget will be displayed at.
maxHeight int: The maximum height in dips that the widget will be displayed at.

也可以看看:

Protected methods

dispatchRestoreInstanceState

Added in API level 3
void dispatchRestoreInstanceState (SparseArray<Parcelable> container)

restoreHierarchyState(android.util.SparseArray)调用以检索此视图及其子项的状态。 可能会被覆盖以修改对视图的子项进行恢复的方式; 例如,一些视图可能不想为他们的孩子存储状态。

Parameters
container SparseArray: The SparseArray which holds previously saved state.

dispatchSaveInstanceState

Added in API level 3
void dispatchSaveInstanceState (SparseArray<Parcelable> container)

saveHierarchyState(android.util.SparseArray)调用以存储此视图及其子项的状态。 可能会被忽略,以修改视图的孩子发生冻结的情况; 例如,一些视图可能不想为他们的孩子存储状态。

Parameters
container SparseArray: The SparseArray in which to save the view's state.

drawChild

Added in API level 3
boolean drawChild (Canvas canvas, 
                View child, 
                long drawingTime)

绘制这个视图组的一个孩子。 这个方法负责让画布处于正确的状态。 这包括剪裁,翻译,以便孩子的滚动起点在0,0,并应用任何动画转换。

Parameters
canvas Canvas: The canvas on which to draw the child
child View: Who to draw
drawingTime long: The time at which draw is occurring
Returns
boolean True if an invalidate() was issued

getDefaultView

Added in API level 3
View getDefaultView ()

膨胀并返回AppWidget提供者请求的默认布局。

Returns
View

getErrorView

Added in API level 3
View getErrorView ()

膨胀并返回代表错误状态的视图。

Returns
View

onLayout

Added in API level 3
void onLayout (boolean changed, 
                int left, 
                int top, 
                int right, 
                int bottom)

当这个视图为每个孩子分配一个大小和位置时,从布局调用。 带孩子的派生类应该覆盖这个方法,并调用他们每个孩子的布局。

Parameters
changed boolean: This is a new size or position for this view
left int: Left position, relative to parent
top int: Top position, relative to parent
right int: Right position, relative to parent
bottom int: Bottom position, relative to parent

prepareView

Added in API level 3
void prepareView (View view)

准备要显示的给定视图。 这可能包括在插入前调整FrameLayout.LayoutParams

Parameters
view View

Hooray!