Android
android.widget
public class

android.widget.RemoteViews

java.lang.Object
android.widget.RemoteViews Parcelable LayoutInflater.Filter

A class that describes a view hierarchy that can be displayed in another process. The hierarchy is inflated from a layout resource file, and this class provides some basic operations for modifying the content of the inflated hierarchy.

Nested Classes
RemoteViews.ActionException Exception to send when something goes wrong executing an action  
RemoteViews.RemoteView This annotation indicates that a subclass of View is alllowed to be used with the RemoteViews mechanism. 

Summary

Constants

      Value  
Creator<RemoteViews CREATOR  Parcelable.Creator that instantiates RemoteViews objects      
Constants inherited from interface android.os.Parcelable

Public Constructors

            RemoteViews(String packageName, int layoutId)
Create a new RemoteViews object that will display the views contained in the specified layout file.
            RemoteViews(Parcel parcel)
Reads a RemoteViews object from a parcel.

Public Methods

          View  apply(Context context, ViewGroup parent)
Inflates the view hierarchy represented by this object and applies all of the actions.
          int  describeContents()
Describe the kinds of special objects contained in this Parcelable's marshalled representation.
          int  getLayoutId()
          String  getPackage()
          boolean  onLoadClass(Class clazz)
Hook to allow clients of the LayoutInflater to restrict the set of Views that are allowed to be inflated.
          void  reapply(Context context, View v)
Applies all of the actions to the provided view.
          void  setChronometer(int viewId, long base, String format, boolean running)
Equivalent to calling Chronometer.setBase, Chronometer.setFormat, and Chronometer.start() or Chronometer.stop().
          void  setImageViewResource(int viewId, int srcId)
Equivalent to calling ImageView.setImageResource
          void  setImageViewUri(int viewId, Uri uri)
Equivalent to calling ImageView.setImageURI
          void  setProgressBar(int viewId, int max, int progress, boolean indeterminate)
Equivalent to calling ProgressBar.setMax, ProgressBar.setProgress, and ProgressBar.setIndeterminate
          void  setTextViewText(int viewId, CharSequence text)
Equivalent to calling TextView.setText
          void  setViewVisibility(int viewId, int visibility)
Equivalent to calling View.setVisibility
          void  writeToParcel(Parcel dest, int flags)
Flatten this object in to a Parcel.
Methods inherited from class java.lang.Object
Methods inherited from interface android.os.Parcelable
Methods inherited from interface android.view.LayoutInflater.Filter

Details

Constants

public static final Creator<RemoteViews> CREATOR

Parcelable.Creator that instantiates RemoteViews objects

Public Constructors

public RemoteViews(String packageName, int layoutId)

Create a new RemoteViews object that will display the views contained in the specified layout file.

Parameters

packageName Name of the package that contains the layout resource
layoutId The id of the layout resource

public RemoteViews(Parcel parcel)

Reads a RemoteViews object from a parcel.

Public Methods

public View apply(Context context, ViewGroup parent)

Inflates the view hierarchy represented by this object and applies all of the actions.

Caller beware: this may throw

Parameters

context Default context to use
parent Parent that the resulting view hierarchy will be attached to. This method does not attach the hierarchy. The caller should do so when appropriate.

Returns

  • The inflated view hierarchy

public int describeContents()

Describe the kinds of special objects contained in this Parcelable's marshalled representation.

public int getLayoutId()

public String getPackage()

public boolean onLoadClass(Class clazz)

Hook to allow clients of the LayoutInflater to restrict the set of Views that are allowed to be inflated.

public void reapply(Context context, View v)

Applies all of the actions to the provided view.

Caller beware: this may throw

Parameters

v The view to apply the actions to. This should be the result of the apply(Context, ViewGroup) call.

public void setChronometer(int viewId, long base, String format, boolean running)

Equivalent to calling Chronometer.setBase, Chronometer.setFormat, and Chronometer.start() or Chronometer.stop().

Parameters

viewId The id of the view whose text should change
base The time at which the timer would have read 0:00. This time should be based off of SystemClock.elapsedRealtime().
format The Chronometer format string, or null to simply display the timer value.
running True if you want the clock to be running, false if not.

public void setImageViewResource(int viewId, int srcId)

Equivalent to calling ImageView.setImageResource

Parameters

viewId The id of the view whose drawable should change
srcId The new resource id for the drawable

public void setImageViewUri(int viewId, Uri uri)

Equivalent to calling ImageView.setImageURI

Parameters

viewId The id of the view whose drawable should change
uri The Uri for the image

public void setProgressBar(int viewId, int max, int progress, boolean indeterminate)

Equivalent to calling ProgressBar.setMax, ProgressBar.setProgress, and ProgressBar.setIndeterminate

Parameters

viewId The id of the view whose text should change
max The 100% value for the progress bar
progress The current value of the progress bar.
indeterminate True if the progress bar is indeterminate, false if not.

public void setTextViewText(int viewId, CharSequence text)

Equivalent to calling TextView.setText

Parameters

viewId The id of the view whose text should change
text The new text for the view

public void setViewVisibility(int viewId, int visibility)

Equivalent to calling View.setVisibility

Parameters

viewId The id of the view whose visibility should change
visibility The new visibility for the view

public void writeToParcel(Parcel dest, int flags)

Flatten this object in to a Parcel.
Copyright 2007 Google Inc. Build 0.9_r1-98467 - 14 Aug 2008 18:48