SetValueRequest


public final class SetValueRequest
extends Object implements Parcelable

java.lang.Object
   ↳ android.service.settings.preferences.SetValueRequest


Request parameters to set the current value to a Settings Preference.

This object passed to SettingsPreferenceService.onSetPreferenceValue will result in a SetValueResult.

  • getScreenKey() is a parameter to distinguish the container screen of a preference as a preference key may not be unique within its application.
  • getPreferenceKey() is a parameter to identify the preference for which the value is being requested. These keys will be unique with their Preference Screen, but may not be unique within their application, so it is required to pair this with getScreenKey() to ensure this request matches the intended target.
  • getPreferenceValue() is a parameter to specify the value that this request aims to set. If this value is invalid (malformed or does not match the type of the preference) then this request will fail.

Summary

Nested classes

class SetValueRequest.Builder

Builder to construct SetValueRequest

Inherited constants

Fields

public static final Creator<SetValueRequest> CREATOR

Parcelable Creator for SetValueRequest.

Public methods

int describeContents()

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

String getPreferenceKey()

Returns the key of requested Preference.

SettingsPreferenceValue getPreferenceValue()

Returns the value of requested Preference.

String getScreenKey()

Returns the screen key of requested Preference.

void writeToParcel(Parcel dest, int flags)

Flatten this object in to a Parcel.

Inherited methods

Fields

CREATOR

Added in API level 36
public static final Creator<SetValueRequest> CREATOR

Parcelable Creator for SetValueRequest.

Public methods

describeContents

Added in API level 36
public 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(android.os.Parcel, int), the return value of this method must include the CONTENTS_FILE_DESCRIPTOR bit.

Returns
int a bitmask indicating the set of special object types marshaled by this Parcelable object instance.
Value is either 0 or

getPreferenceKey

Added in API level 36
public String getPreferenceKey ()

Returns the key of requested Preference.

Returns
String

getPreferenceValue

Added in API level 36
public SettingsPreferenceValue getPreferenceValue ()

Returns the value of requested Preference.

Returns
SettingsPreferenceValue

getScreenKey

Added in API level 36
public String getScreenKey ()

Returns the screen key of requested Preference.

Returns
String

writeToParcel

Added in API level 36
public void writeToParcel (Parcel dest, 
                int flags)

Flatten this object in to a Parcel.

Parameters
dest Parcel: The Parcel in which the object should be written.
This value cannot be null.

flags int: Additional flags about how the object should be written. May be 0 or Parcelable.PARCELABLE_WRITE_RETURN_VALUE.
Value is either 0 or a combination of the following: