语言

RemoteViews 类

定义

描述可在另一个进程中显示的视图层次结构的类。

[Android.Runtime.Register("android/widget/RemoteViews", DoNotGenerateAcw=true)]
public class RemoteViews : Java.Lang.Object, Android.OS.IParcelable, Android.Views.LayoutInflater.IFilter, IDisposable
[<Android.Runtime.Register("android/widget/RemoteViews", DoNotGenerateAcw=true)>]
type RemoteViews = class
    inherit Object
    interface IParcelable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface LayoutInflater.IFilter
继承
RemoteViews
特性
实现

注解

描述可在另一个进程中显示的视图层次结构的类。 层次结构是从布局资源文件中膨胀的,此类提供了一些基本操作来修改膨胀层次结构的内容。

RemoteViews 仅限于支持以下布局:

<ul><li><android.widget.AdapterViewFlipper/li>>android.widget.GridView<<>>android.widget.FrameLayoutandroid.widget.GridLayout<<>><</li><>android.widget.LinearLayout</li/<android.widget.ListView><>liandroid.widget.RelativeLayout>><</<>>android.widget.StackViewandroid.widget.ViewFlipper><><<li></ul>

以及以下小组件:

<ul><li>android.widget.AnalogClock</li/li<android.widget.Button<>>/>><android.widget.Chronometer<li/li>android.widget.ImageButton><</li/li>android.widget.ImageView<></li/><<>android.widget.ProgressBarli/li/li/li<><>android.widget.TextClock/li/li/liandroid.widget.TextView<<>>/li></ul>

从 API 31 开始,也可以使用以下小组件和布局:

<ul><li>android.widget.CheckBox</li><>android.widget.RadioButton</li><>android.widget.RadioGroup</li/li><>android.widget.Switch</li/li></ul>

不支持这些类的后代。

Java文档android.widget.RemoteViews。

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

构造函数

名称 说明
RemoteViews(IDictionary<SizeF,RemoteViews>)

创建一个新的 RemoteViews 对象,该对象将使用最接近的大小规范来扩充布局。

RemoteViews(IntPtr, JniHandleOwnership)

创建 JNI 对象的托管表示形式时使用的构造函数;由运行时调用。

RemoteViews(Parcel)

从包裹中读取 RemoteViews 对象。

RemoteViews(RemoteViews, RemoteViews)

创建一个新的 RemoteViews 对象,该对象将膨胀为指定的陆地空间或纵向 RemoteViews,具体取决于当前配置。

RemoteViews(RemoteViews)

创建另一个 RemoteViews 的副本。

RemoteViews(RemoteViews+DrawInstructions)

从绘图说明创建一个 RemoteViews 。

RemoteViews(String, Int32, Int32)

创建一个新的 RemoteViews 对象,该对象将显示指定布局文件中包含的视图,并将根视图的 ID 更改为指定的视图。

RemoteViews(String, Int32)

创建一个新的 RemoteViews 对象,该对象将显示指定布局文件中包含的视图。

字段

名称 说明
ExtraChecked

对于当前检查状态已更改的视图是否已更改的视图,意向是额外的。

ExtraSharedElementBounds

包含所有共享元素边界的额外意向。

MarginBottom
已过时.

该值将应用于 marginBottom。

MarginEnd
已过时.

该值将应用于 marginEnd。

MarginLeft
已过时.

该值将应用于 marginLeft。

MarginRight
已过时.

该值将应用于 marginRight。

MarginStart
已过时.

该值将应用于 marginStart。

MarginTop
已过时.

该值将应用于 marginTop。

属性

名称 说明
Class

返回此 Object的运行时类。

(继承自 Object)
Creator

可包裹。

Handle

基础 Android 实例的句柄。

(继承自 Object)
JniIdentityHashCode

获取互操作运行时分配给此Java对等的标识哈希代码。

(继承自 Object)
JniManagedPeerState

获取运行时上次分配的状态标志。

(继承自 JavaObject)
JniPeerMembers

获取此托管绑定类型的 JNI 对等成员元数据。

LayoutId

返回与此 RemoteViews 关联的根布局的布局 ID。

Package

获取包。

PeerReference

获取此Java对等方的 JNI 对象引用。

(继承自 Object)
ThresholdClass

此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。

ThresholdType

此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。

ViewId

使用 获取 XML 布局的顶级视图的 ID(如果已设置 RemoteViews#RemoteViews(String, int, int))。

方法

名称 说明
AddStableView(Int32, RemoteViews, Int32)

等效于在膨胀给定ViewGroup#addView(View)后调用RemoteViews。

AddView(Int32, RemoteViews)

等效于在膨胀给定ViewGroup#addView(View)后调用RemoteViews。

Apply(Context, ViewGroup)

膨胀此对象表示的视图层次结构,并应用所有操作。

Clone()

返回 RemoteViews 对象的深层副本。

Construct(JniObjectReference, JniObjectReferenceOptions)

将此对等方的构造委托给运行时的值管理器。

(继承自 JavaObject)
DescribeContents()

描述此 Parcelable 封送表示形式中包含的特殊对象类型。

Dispose()

释放此Java对等方持有的资源。

(继承自 Object)
Dispose(Boolean)

释放此Java对等方持有的资源。

(继承自 Object)
DisposeUnlessReferenced()

要求值管理器释放此对等方,除非其映射保留此相同的托管实例。

(继承自 JavaObject)
Equals(Object)

测试另一个托管对等方是否引用同一Java对象。

(继承自 JavaObject)
Equals(Object)

指示其他对象是否“等于”此对象。

(继承自 Object)
GetDrawInstructions()

返回与此 RemoteViews 关联的 DrawInstructions(如果有)。

GetHashCode()

返回对象的哈希代码值。

(继承自 Object)
JavaFinalize()
已过时.

当垃圾回收确定不再引用该对象时,由对象上的垃圾回收器调用。

(继承自 Object)
Notify()

唤醒正在等待此对象的监视器的单个线程。

(继承自 Object)
NotifyAll()

唤醒正在等待此对象的监视器的所有线程。

(继承自 Object)
OnLoadClass(Class)

用于限制可膨胀的视图

Reapply(Context, View)

将所有操作应用于提供的视图。

RemoveAllViews(Int32)

等效于调用 ViewGroup#removeAllViews()。

SetAccessibilityTraversalAfter(Int32, Int32)

等效于调用 android.view.View#setAccessibilityTraversalAfter(int)。

SetAccessibilityTraversalBefore(Int32, Int32)

等效于调用 android.view.View#setAccessibilityTraversalBefore(int)。

SetAppWidgetEventTag(Int32, Int32)

设置视图标记,将视图与要用于小组件交互使用事件的 ID 相关联(AppWidgetEvent)。

SetBitmap(Int32, String, Bitmap)

在此 RemoteViews 的布局中,调用在视图中采用一个位图的方法。

SetBlendMode(Int32, String, BlendMode)

在此 RemoteViews 的布局中,调用对视图采用一个 BlendMode 的方法。

SetBoolean(Int32, String, Boolean)

在此 RemoteViews 的布局中,调用对视图采用一个布尔值的方法。

SetBundle(Int32, String, Bundle)

在此 RemoteViews 的布局中,调用在视图中采用一个捆绑包的方法。

SetByte(Int32, String, SByte)

在此 RemoteViews 的布局中,调用对视图采用一个字节的方法。

SetChar(Int32, String, Char)

在此 RemoteViews 的布局中,调用对视图采用一个字符的方法。

SetCharSequence(Int32, String, ICharSequence)

在此 RemoteViews 的布局中,调用对视图采用一个 CharSequence 的方法。

SetCharSequence(Int32, String, Int32)

在此 RemoteViews 的布局中,调用对视图采用一个 CharSequence 的方法。

SetCharSequence(Int32, String, String)

在此 RemoteViews 的布局中,调用对视图采用一个 CharSequence 的方法。

SetCharSequenceAttr(Int32, String, Int32)

在此 RemoteViews 的布局中,调用对视图采用一个 CharSequence 的方法。

SetChronometer(Int32, Int64, String, Boolean)

等效于调用 Chronometer#setBase Chronometer.setBase、 Chronometer#setFormat Chronometer.setFormat或 Chronometer#start Chronometer.start()Chronometer#stop Chronometer.stop()。

SetChronometerCountDown(Int32, Boolean)

等效于 Chronometer#setCountDown(boolean) Chronometer.setCountDown 使用给定 viewId 调用计时表。

SetColor(Int32, String, Int32)

在此 RemoteViews 的布局中,调用采用一个 int(颜色)的方法。

SetColorAttr(Int32, String, Int32)

在此 RemoteViews 的布局中,调用采用一个 int(颜色)的方法。

SetColorInt(Int32, String, Int32, Int32)

在此 RemoteViews 的布局中,调用采用一个 int(颜色)的方法。

SetColorStateList(Int32, String, ColorStateList, ColorStateList)

在此 RemoteViews 的布局中,调用对视图采用一个 ColorStateList 的方法。

SetColorStateList(Int32, String, ColorStateList)

在此 RemoteViews 的布局中,调用对视图采用一个 ColorStateList 的方法。

SetColorStateList(Int32, String, Int32)

在此 RemoteViews 的布局中,调用对视图采用一个 ColorStateList 的方法。

SetColorStateListAttr(Int32, String, Int32)

在此 RemoteViews 的布局中,调用对视图采用一个 ColorStateList 的方法。

SetCompoundButtonChecked(Int32, Boolean)

等效于调用 android.widget.CompoundButton#setChecked(boolean)。

SetContentDescription(Int32, ICharSequence)

等效于调用视图。

SetContentDescription(Int32, String)

等效于调用视图。

SetDisplayedChild(Int32, Int32)

等效于调用 AdapterViewAnimator#setDisplayedChild(int)

SetDouble(Int32, String, Double)

在此 RemoteViews 的布局中,调用对视图执行一个双倍的方法。

SetEmptyView(Int32, Int32)

等效于调用 AdapterView#setEmptyView(View)

SetFloat(Int32, String, Single)

在此 RemoteViews 的布局中,调用采用视图上的浮点数的方法。

SetFloatDimen(Int32, String, Int32)

在此 RemoteViews 的布局中,调用采用一个浮点数(以像素为单位)的方法。

SetFloatDimen(Int32, String, Single, Int32)

在此 RemoteViews 的布局中,调用采用一个浮点数(以像素为单位)的方法。

SetFloatDimenAttr(Int32, String, Int32)

在此 RemoteViews 的布局中,调用采用一个浮点数(以像素为单位)的方法。

SetHandle(IntPtr, JniHandleOwnership)

设置 Handle 属性。

(继承自 Object)
SetIcon(Int32, String, Icon, Icon)

在此 RemoteViews 的布局中,调用采用一个图标的方法。

SetIcon(Int32, String, Icon)

在此 RemoteViews 的布局中,调用采用一个图标的方法。

SetImageViewBitmap(Int32, Bitmap)

等效于调用 ImageView#setImageBitmap(Bitmap)

SetImageViewIcon(Int32, Icon)

等效于调用 ImageView#setImageIcon(Icon)

SetImageViewResource(Int32, Int32)

等效于调用 ImageView#setImageResource(int)

SetImageViewUri(Int32, Uri)

等效于调用 ImageView#setImageURI(Uri)

SetInt(Int32, String, Int32)

在此 RemoteViews 的布局中,调用对视图采用一个 int 的方法。

SetIntDimen(Int32, String, Int32)

在此 RemoteViews 的布局中,调用采用一个 int(以像素为单位)的方法。

SetIntDimen(Int32, String, Single, Int32)

在此 RemoteViews 的布局中,调用采用一个 int(以像素为单位)的方法。

SetIntDimenAttr(Int32, String, Int32)

在此 RemoteViews 的布局中,调用采用一个 int(以像素为单位)的方法。

SetIntent(Int32, String, Intent)

调用采用此 RemoteViews 布局中视图的一个意向的方法。

SetLabelFor(Int32, Int32)

等效于调用 View#setLabelFor(int)。

SetLightBackgroundLayoutId(Int32)

提供一个备用布局 ID,可用于扩充此视图。

SetLong(Int32, String, Int64)

在此 RemoteViews 的布局中调用一个方法,该视图的视图耗时一长。

SetOnCheckedChangeResponse(Int32, RemoteViews+RemoteResponse)

等效于调用 android.widget.CompoundButton#setOnCheckedChangeListener( android.widget.CompoundButton.OnCheckedChangeListener) 以启动提供的 RemoteResponse。

SetOnClickFillInIntent(Int32, Intent)

使用集合时(例如

SetOnClickPendingIntent(Int32, PendingIntent)

等效于调用 android.view.View#setOnClickListener(android.view.View.OnClickListener) 以启动提供的 PendingIntent。

SetOnClickResponse(Int32, RemoteViews+RemoteResponse)

等效调用 android.view.View#setOnClickListener(android.view.View.OnClickListener) 以启动提供的 RemoteResponse。

SetOnStylusHandwritingPendingIntent(Int32, PendingIntent)

等效于调用 View.setHandwritingDelegatorCallback(Runnable)以发送提供的 PendingIntent。

SetPeerReference(JniObjectReference, JniObjectReferenceOptions)

在不创建 JNI 引用副本的情况下,将引用值存储在控制块中。

(继承自 JavaObject)
SetPendingIntentTemplate(Int32, PendingIntent)

使用集合时(例如

SetProgressBar(Int32, Int32, Int32, Boolean)

等效于调用 ProgressBar#setMax ProgressBar.setMax、 ProgressBar#setProgress ProgressBar.setProgress和 ProgressBar#setIndeterminate ProgressBar.setIndeterminate

        If indeterminate is true, then the values for max and progress are ignored.
SetRadioGroupChecked(Int32, Int32)

等效于调用 android.widget.RadioGroup#check(int)。

SetRelativeScrollPosition(Int32, Int32)

等效于调用 ListView#smoothScrollByOffset(int)。

SetRemoteAdapter(Int32, Int32, Intent)
已过时.

等效于调用 android.widget.AbsListView#setRemoteViewsAdapter(Intent)。

SetRemoteAdapter(Int32, Intent)

等效于调用 android.widget.AbsListView#setRemoteViewsAdapter(Intent)。

SetRemoteAdapter(Int32, RemoteViews+RemoteCollectionItems)

等效于调用 android.widget.AbsListView#setRemoteViewsAdapter(Intent)。

SetScrollPosition(Int32, Int32)

等效于调用 ListView#smoothScrollToPosition(int)。

SetShort(Int32, String, Int16)

在此 RemoteViews 的布局中调用采用一个短视图的方法。

SetString(Int32, String, String)

在此 RemoteViews 的布局中,调用在视图中采用一个 String 的方法。

SetTextColor(Int32, Color)

等效于调用 android.widget.TextView#setTextColor(int)。

SetTextViewCompoundDrawables(Int32, Int32, Int32, Int32, Int32)

等效于调用 TextView#setCompoundDrawablesWithIntrinsicBounds(int, int, int, int)。

SetTextViewCompoundDrawablesRelative(Int32, Int32, Int32, Int32, Int32)

等效于调用 TextView#setCompoundDrawablesRelativeWithIntrinsicBounds(int, int, int, int)。

SetTextViewText(Int32, ICharSequence)

等效于调用 TextView#setText(CharSequence)

SetTextViewText(Int32, String)

等效于调用 TextView#setText(CharSequence)

SetTextViewTextSize(Int32, Int32, Single)

等效于调用 TextView#setTextSize(int, float)

SetUri(Int32, String, Uri)

在此 RemoteViews 的布局中,调用对视图采用一个 URI 的方法。

SetViewLayoutHeight(Int32, Single, Int32)

等效于设置 android.view.ViewGroup.LayoutParams#height ,只不过你可以在任何维度单位中提供该值。

SetViewLayoutHeightAttr(Int32, Int32)

等效于在当前主题中设置 android.view.ViewGroup.LayoutParams#height 给定属性的值。

SetViewLayoutHeightDimen(Int32, Int32)

等效于使用 . 的结果android.view.ViewGroup.LayoutParams#height进行设置Resources#getDimensionPixelSize(int)。

SetViewLayoutMargin(Int32, Int32, Single, Int32)

等效于调用 MarginLayoutParams#setMarginEnd。

SetViewLayoutMarginAttr(Int32, Int32, Int32)

等效于调用 MarginLayoutParams#setMarginEnd。

SetViewLayoutMarginDimen(Int32, Int32, Int32)

等效于调用 MarginLayoutParams#setMarginEnd。

SetViewLayoutWidth(Int32, Single, Int32)

等效于设置 android.view.ViewGroup.LayoutParams#width ,只不过你可以在任何维度单位中提供该值。

SetViewLayoutWidthAttr(Int32, Int32)

等效于在当前主题中设置 android.view.ViewGroup.LayoutParams#width 给定属性的值。

SetViewLayoutWidthDimen(Int32, Int32)

等效于使用 . 的结果android.view.ViewGroup.LayoutParams#width进行设置Resources#getDimensionPixelSize(int)。

SetViewOutlinePreferredRadius(Int32, Single, Int32)

在视图上设置一个 OutlineProvider,该视图的角半径是使用计算的 TypedValue#applyDimension(int, float, DisplayMetrics)维度。

SetViewOutlinePreferredRadiusAttr(Int32, Int32)

在视图上设置一个 OutlineProvider,其角半径是一个维度属性。attrId

SetViewOutlinePreferredRadiusDimen(Int32, Int32)

在视图上设置一个 OutlineProvider,该视图的角半径是维度资源。resId

SetViewPadding(Int32, Int32, Int32, Int32, Int32)

等效于调用 android.view.View#setPadding(int, int, int, int)。

SetViewPadding(Int32, Single, Single, Single, Single, Int32)

等效于调用 View.setPadding(int、int、int、int、int)。

SetViewVisibility(Int32, ViewStates)

等效于调用 View#setVisibility(int)

ShowNext(Int32)

等效于调用 AdapterViewAnimator#showNext()

ShowPrevious(Int32)

等效于调用 AdapterViewAnimator#showPrevious()

ToArray<T>()

从此Java数组包装器创建托管数组。

(继承自 Object)
ToString()

返回对象的字符串表示形式。

(继承自 Object)
UnregisterFromRuntime()

从互操作运行时取消注册此Java对等。

(继承自 Object)
Wait()

使当前线程等待,直到唤醒它,通常是通过 em 通知/em< 或 >em<interrupted>/em<。><>

(继承自 Object)
Wait(Int64, Int32)

使当前线程等待直到唤醒,通常是通过 <em>通知</em> 或 <em interrupted>/em<>,或直到经过一定数量的实时。

(继承自 Object)
Wait(Int64)

使当前线程等待直到唤醒,通常是通过 <em>通知</em> 或 <em interrupted>/em<>,或直到经过一定数量的实时。

(继承自 Object)
WriteToParcel(Parcel, ParcelableWriteFlags)

将此对象平展到一个地块。

显式接口实现

名称 说明
IJavaPeerable.Disposed()

将此对等方标记为已释放,并将disposing调用Dispose设置为 true.

(继承自 JavaObject)
IJavaPeerable.Finalized()

将此对等方标记为已释放,并将disposing调用Dispose设置为 false.

(继承自 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock

获取此对等方使用的本机控制块指针。

(继承自 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)

存储运行时提供的标识哈希代码。

(继承自 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

替换存储的托管对等状态标志。

(继承自 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)

更新对等引用,并在引用无效时释放已释放的对等方控制块。

(继承自 JavaObject)
IJavaPeerable.UnregisterFromRuntime()

从运行时的Java对象查找中删除此实例。

扩展方法

名称 说明
GetJniTypeName(IJavaPeerable)

获取实例 self类型的 JNI 名称。

JavaAs<TResult>(IJavaPeerable)

尝试强制self键入TResult,检查强制是否在Java端有效。

JavaCast<TResult>(IJavaObject)

执行 Android 运行时检查的类型转换。

JavaCast<TResult>(IJavaObject)

重复使用兼容的托管对等,或获取请求类型的包装器。

TryJavaCast<TResult>(IJavaPeerable, TResult)

尝试强制self键入TResult,检查强制是否在Java端有效。

适用于