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

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.

Inherited methods

Fields

CREATOR

public static final Creator<SetValueRequest> CREATOR

Parcelable Creator for SetValueRequest.

Public methods

getPreferenceKey

public String getPreferenceKey ()

Returns the key of requested Preference.

Returns
String

getPreferenceValue

public SettingsPreferenceValue getPreferenceValue ()

Returns the value of requested Preference.

Returns
SettingsPreferenceValue

getScreenKey

public String getScreenKey ()

Returns the screen key of requested Preference.

Returns
String