RemoteViews

CREATOR

Creator<RemoteViews> CREATOR

Parcelable.Creator that instantiates RemoteViews objects

RemoteViews

RemoteViews (String packageName, 
                int layoutId)

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

RemoteViews

RemoteViews (RemoteViews landscape, 
                RemoteViews portrait)

Create a new RemoteViews object that will inflate as the specified landspace or portrait RemoteViews, depending on the current configuration.

RemoteViews

RemoteViews (Parcel parcel)

Reads a RemoteViews object from a parcel.

addView

void addView (int viewId, 
                RemoteViews nestedView)

Equivalent to calling addView(View) after inflating the given RemoteViews. This allows users to build "nested" RemoteViews. In cases where consumers of RemoteViews may recycle layouts, use removeAllViews(int) to clear any existing children.

apply

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

clone

RemoteViews clone ()

Creates and returns a copy of this object. The precise meaning of "copy" may depend on the class of the object. The general intent is that, for any object x, the expression:

 x.clone() != x

 x.clone().getClass() == x.getClass()

 x.clone().equals(x)

By convention, the returned object should be obtained by calling super.clone. If a class and all of its superclasses (except Object) obey this convention, it will be the case that x.clone().getClass() == x.getClass().

By convention, the object returned by this method should be independent of this object (which is being cloned). To achieve this independence, it may be necessary to modify one or more fields of the object returned by super.clone before returning it. Typically, this means copying any mutable objects that comprise the internal "deep structure" of the object being cloned and replacing the references to these objects with references to the copies. If a class contains only primitive fields or references to immutable objects, then it is usually the case that no fields in the object returned by super.clone need to be modified.

The method clone for class Object performs a specific cloning operation. First, if the class of this object does not implement the interface Cloneable, then a CloneNotSupportedException is thrown. Note that all arrays are considered to implement the interface Cloneable and that the return type of the clone method of an array type T[] is T[] where T is any reference or primitive type. Otherwise, this method creates a new instance of the class of this object and initializes all its fields with exactly the contents of the corresponding fields of this object, as if by assignment; the contents of the fields are not themselves cloned. Thus, this method performs a "shallow copy" of this object, not a "deep copy" operation.

The class Object does not itself implement the interface Cloneable, so calling the clone method on an object whose class is Object will result in throwing an exception at run time.

describeContents

int describeContents ()

Describe the kinds of special objects contained in this Parcelable instance's marshaled representation. For example, if the object will include a file descriptor in the output of writeToParcel(Parcel, int), the return value of this method must include the CONTENTS_FILE_DESCRIPTOR bit.

getLayoutId

int getLayoutId ()

Returns the layout id of the root layout associated with this RemoteViews. In the case that the RemoteViews has both a landscape and portrait root, this will return the layout id associated with the portrait layout.

getPackage

String getPackage ()

onLoadClass

boolean onLoadClass (Class clazz)

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

reapply

void reapply (Context context, 
                View v)

Applies all of the actions to the provided view.

Caller beware: this may throw

removeAllViews

void removeAllViews (int viewId)

Equivalent to calling removeAllViews().

setAccessibilityTraversalAfter

void setAccessibilityTraversalAfter (int viewId, 
                int nextId)

Equivalent to calling setAccessibilityTraversalAfter(int).

setAccessibilityTraversalBefore

void setAccessibilityTraversalBefore (int viewId, 
                int nextId)

Equivalent to calling setAccessibilityTraversalBefore(int).

setBitmap

void setBitmap (int viewId, 
                String methodName, 
                Bitmap value)

Call a method taking one Bitmap on a view in the layout for this RemoteViews.

setBoolean

void setBoolean (int viewId, 
                String methodName, 
                boolean value)

Call a method taking one boolean on a view in the layout for this RemoteViews.

setBundle

void setBundle (int viewId, 
                String methodName, 
                Bundle value)

Call a method taking one Bundle on a view in the layout for this RemoteViews.

setByte

void setByte (int viewId, 
                String methodName, 
                byte value)

Call a method taking one byte on a view in the layout for this RemoteViews.

setChar

void setChar (int viewId, 
                String methodName, 
                char value)

Call a method taking one char on a view in the layout for this RemoteViews.

setCharSequence

void setCharSequence (int viewId, 
                String methodName, 
                CharSequence value)

Call a method taking one CharSequence on a view in the layout for this RemoteViews.

setChronometer

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

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

setChronometerCountDown

void setChronometerCountDown (int viewId, 
                boolean isCountDown)

Equivalent to calling Chronometer.setCountDown on the chronometer with the given viewId.

setContentDescription

void setContentDescription (int viewId, 
                CharSequence contentDescription)

Equivalent to calling View.setContentDescription(CharSequence).

setDisplayedChild

void setDisplayedChild (int viewId, 
                int childIndex)

Equivalent to calling setDisplayedChild(int)

setDouble

void setDouble (int viewId, 
                String methodName, 
                double value)

Call a method taking one double on a view in the layout for this RemoteViews.

setEmptyView

void setEmptyView (int viewId, 
                int emptyViewId)

Equivalent to calling AdapterView.setEmptyView

setFloat

void setFloat (int viewId, 
                String methodName, 
                float value)

Call a method taking one float on a view in the layout for this RemoteViews.

setIcon

void setIcon (int viewId, 
                String methodName, 
                Icon value)

Call a method taking one Icon on a view in the layout for this RemoteViews.

setImageViewBitmap

void setImageViewBitmap (int viewId, 
                Bitmap bitmap)

Equivalent to calling ImageView.setImageBitmap

setImageViewIcon

void setImageViewIcon (int viewId, 
                Icon icon)

Equivalent to calling ImageView.setImageIcon

setImageViewResource

void setImageViewResource (int viewId, 
                int srcId)

Equivalent to calling ImageView.setImageResource

setImageViewUri

void setImageViewUri (int viewId, 
                Uri uri)

Equivalent to calling ImageView.setImageURI

setInt

void setInt (int viewId, 
                String methodName, 
                int value)

Call a method taking one int on a view in the layout for this RemoteViews.

setIntent

void setIntent (int viewId, 
                String methodName, 
                Intent value)

Call a method taking one Intent on a view in the layout for this RemoteViews.

setLabelFor

void setLabelFor (int viewId, 
                int labeledId)

Equivalent to calling View.setLabelFor(int).

setLong

void setLong (int viewId, 
                String methodName, 
                long value)

Call a method taking one long on a view in the layout for this RemoteViews.

setOnClickFillInIntent

void setOnClickFillInIntent (int viewId, 
                Intent fillInIntent)

When using collections (eg. ListView, StackView etc.) in widgets, it is very costly to set PendingIntents on the individual items, and is hence not permitted. Instead a single PendingIntent template can be set on the collection, see setPendingIntentTemplate(int, PendingIntent), and the individual on-click action of a given item can be distinguished by setting a fillInIntent on that item. The fillInIntent is then combined with the PendingIntent template in order to determine the final intent which will be executed when the item is clicked. This works as follows: any fields which are left blank in the PendingIntent template, but are provided by the fillInIntent will be overwritten, and the resulting PendingIntent will be used. of the PendingIntent template will then be filled in with the associated fields that are set in fillInIntent. See fillIn(Intent, int) for more details.

setOnClickPendingIntent

void setOnClickPendingIntent (int viewId, 
                PendingIntent pendingIntent)

Equivalent to calling setOnClickListener(android.view.View.OnClickListener) to launch the provided PendingIntent. When setting the on-click action of items within collections (eg. ListView, StackView etc.), this method will not work. Instead, use {@link RemoteViews#setPendingIntentTemplate(int, PendingIntent) in conjunction with RemoteViews#setOnClickFillInIntent(int, Intent).

setPendingIntentTemplate

void setPendingIntentTemplate (int viewId, 
                PendingIntent pendingIntentTemplate)

When using collections (eg. ListView, StackView etc.) in widgets, it is very costly to set PendingIntents on the individual items, and is hence not permitted. Instead this method should be used to set a single PendingIntent template on the collection, and individual items can differentiate their on-click behavior using setOnClickFillInIntent(int, Intent).

setProgressBar

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

Equivalent to calling ProgressBar.setMax, ProgressBar.setProgress, and ProgressBar.setIndeterminate If indeterminate is true, then the values for max and progress are ignored.

setRelativeScrollPosition

void setRelativeScrollPosition (int viewId, 
                int offset)

Equivalent to calling smoothScrollToPosition(int, int).

setRemoteAdapter

void setRemoteAdapter (int appWidgetId, 
                int viewId, 
                Intent intent)

This method was deprecated in API level 14.
This method has been deprecated. See setRemoteAdapter(int, Intent)

Equivalent to calling setRemoteViewsAdapter(Intent).

setRemoteAdapter

void setRemoteAdapter (int viewId, 
                Intent intent)

Equivalent to calling setRemoteViewsAdapter(Intent). Can only be used for App Widgets.

setScrollPosition

void setScrollPosition (int viewId, 
                int position)

Equivalent to calling smoothScrollToPosition(int, int).

setShort

void setShort (int viewId, 
                String methodName, 
                short value)

Call a method taking one short on a view in the layout for this RemoteViews.

setString

void setString (int viewId, 
                String methodName, 
                String value)

Call a method taking one String on a view in the layout for this RemoteViews.

setTextColor

void setTextColor (int viewId, 
                int color)

Equivalent to calling setTextColor(int).

setTextViewCompoundDrawables

void setTextViewCompoundDrawables (int viewId, 
                int left, 
                int top, 
                int right, 
                int bottom)

Equivalent to calling setCompoundDrawablesWithIntrinsicBounds(int, int, int, int).

setTextViewCompoundDrawablesRelative

void setTextViewCompoundDrawablesRelative (int viewId, 
                int start, 
                int top, 
                int end, 
                int bottom)

Equivalent to calling setCompoundDrawablesRelativeWithIntrinsicBounds(int, int, int, int).

setTextViewText

void setTextViewText (int viewId, 
                CharSequence text)

Equivalent to calling TextView.setText

setTextViewTextSize

void setTextViewTextSize (int viewId, 
                int units, 
                float size)

Equivalent to calling setTextSize(int, float)

setUri

void setUri (int viewId, 
                String methodName, 
                Uri value)

Call a method taking one Uri on a view in the layout for this RemoteViews.

setViewPadding

void setViewPadding (int viewId, 
                int left, 
                int top, 
                int right, 
                int bottom)

Equivalent to calling setPadding(int, int, int, int).

setViewVisibility

void setViewVisibility (int viewId, 
                int visibility)

Equivalent to calling View.setVisibility

showNext

void showNext (int viewId)

Equivalent to calling showNext()

showPrevious

void showPrevious (int viewId)

Equivalent to calling showPrevious()

writeToParcel

void writeToParcel (Parcel dest, 
                int flags)

Flatten this object in to a Parcel.