Most visited

Recently visited

Results for

Added in API level 1
Summary: XML Attrs | Inherited XML Attrs | Inherited Constants | Ctors | Methods | Protected Methods | Inherited Methods | [Expand All]

RingtonePreference

public class RingtonePreference
extends Preference implements PreferenceManager.OnActivityResultListener

java.lang.Object
    android.preference.Preference
      android.preference.RingtonePreference

一个允许用户从设备上选择铃声的Preference 。 所选铃声的URI将作为字符串持续保存。

如果用户选择“默认”项，保存的字符串将是一个DEFAULT_RINGTONE_URI ， DEFAULT_NOTIFICATION_URI ，或DEFAULT_ALARM_ALERT_URI 。 如果用户选择“无声”项目，则保存的字符串将为空字符串。

摘要(Summary)

XML attributes
android:ringtoneType Which ringtone type(s) to show in the picker. 
android:showDefault Whether to show an item for a default sound. 
android:showSilent Whether to show an item for 'Silent'. 

Inherited XML attributes
From class android.preference.Preference

Inherited constants
From class android.preference.Preference

Public constructors
RingtonePreference(Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes)
RingtonePreference(Context context, AttributeSet attrs, int defStyleAttr)
RingtonePreference(Context context, AttributeSet attrs)
RingtonePreference(Context context)

公共方法(Public methods)
int getRingtoneType()

返回选取器中显示的声音类型。
boolean getShowDefault()

返回是否显示默认声音/铃声的项目。
boolean getShowSilent()

返回是否显示“无声”项目。
boolean onActivityResult(int requestCode, int resultCode, Intent data)

请参阅活动的onActivityResult。
void setRingtoneType(int type)

设置选取器中显示的声音类型。
void setShowDefault(boolean showDefault)

设置是否显示默认声音/铃声的项目。
void setShowSilent(boolean showSilent)

设置是否显示“无声”项目。

Protected methods
void onAttachedToHierarchy(PreferenceManager preferenceManager)

当此首选项已附加到首选项层次结构时调用。
void onClick()

处理点击偏好。
Object onGetDefaultValue(TypedArray a, int index)

当首选项被夸大并且需要读取默认值属性时调用。
void onPrepareRingtonePickerIntent(Intent ringtonePickerIntent)

准备启动铃声选择器的意图。
Uri onRestoreRingtone()

当选择器即将显示并且当前铃声应被标记时调用。
void onSaveRingtone(Uri ringtoneUri)

当选择铃声时调用。
void onSetInitialValue(boolean restorePersistedValue, Object defaultValueObj)

执行此操作来设置首选项的初始值。

继承方法(Inherited methods)
From class android.preference.Preference
From class java.lang.Object
From interface java.lang.Comparable
From interface android.preference.PreferenceManager.OnActivityResultListener

XML attributes

android:ringtoneType

在选取器中显示哪种铃声类型。

必须是以下常量值中的一个或多个（用'|'分隔）。

Constant Value 描述
ringtone 1 Ringtones.
notification 2 Notification sounds.
alarm 4 Alarm sounds.
all 7 All available ringtone sounds.

这对应于全局属性资源符号 ringtoneType 。

android:showDefault

是否显示默认声音的项目。

必须是布尔值，可以是“ true ”或“ false ”。

这也可能是对包含此类型值的资源（形式为“ @[package:]type:name ”）或主题属性（形式为“ ?[package:][type:]name ”）的 ?[package:][type:]name 。

这对应于全局属性资源符号 showDefault 。

android:showSilent

是否显示“无声”项目。

必须是布尔值，可以是“ true ”或“ false ”。

这也可能是对包含此类型值的资源（形式为“ @[package:]type:name ”）或主题属性（形式为“ ?[package:][type:]name ”）的 ?[package:][type:]name 。

这对应于全局属性资源符号 showSilent 。

Public constructors

RingtonePreference

Added in API level 21 
RingtonePreference (Context context, 
                AttributeSet attrs, 
                int defStyleAttr, 
                int defStyleRes)

参数(Parameters)
context Context
attrs AttributeSet
defStyleAttr int
defStyleRes int

RingtonePreference

Added in API level 1 
RingtonePreference (Context context, 
                AttributeSet attrs, 
                int defStyleAttr)

参数(Parameters)
context Context
attrs AttributeSet
defStyleAttr int

RingtonePreference

Added in API level 1 
RingtonePreference (Context context, 
                AttributeSet attrs)

参数(Parameters)
context Context
attrs AttributeSet

RingtonePreference

Added in API level 1 
RingtonePreference (Context context)

参数(Parameters)
context Context

公共方法(Public methods)

getRingtoneType

Added in API level 1 
int getRingtoneType ()

返回选取器中显示的声音类型。

返回(Returns)
int The sound type(s) that are shown in the picker.

也可以看看：

getShowDefault

Added in API level 1 
boolean getShowDefault ()

返回是否显示默认声音/铃声的项目。

返回(Returns)
boolean Whether to show an item for the default sound/ringtone.

getShowSilent

Added in API level 1 
boolean getShowSilent ()

返回是否显示“无声”项目。

返回(Returns)
boolean Whether to show an item for 'Silent'.

onActivityResult

Added in API level 1 
boolean onActivityResult (int requestCode, 
                int resultCode, 
                Intent data)

请参阅活动的onActivityResult。

参数(Parameters)
requestCode int
resultCode int
data Intent
返回(Returns)
boolean Whether the request code was handled (in which case subsequent listeners will not be called.

setRingtoneType

Added in API level 1 
void setRingtoneType (int type)

设置选取器中显示的声音类型。

参数(Parameters)
type int: The sound type(s) that are shown in the picker.

也可以看看：

setShowDefault

Added in API level 1 
void setShowDefault (boolean showDefault)

设置是否显示默认声音/铃声的项目。 使用的默认值将从显示的声音类型中推断出来。

参数(Parameters)
showDefault boolean: Whether to show the default or not.

也可以看看：

setShowSilent

Added in API level 1 
void setShowSilent (boolean showSilent)

设置是否显示“无声”项目。

参数(Parameters)
showSilent boolean: Whether to show 'Silent'.

也可以看看：

Protected methods

onAttachedToHierarchy

Added in API level 1 
void onAttachedToHierarchy (PreferenceManager preferenceManager)

当此首选项已附加到首选项层次结构时调用。 确保调用超级实现。

参数(Parameters)
preferenceManager PreferenceManager: The PreferenceManager of the hierarchy.

onClick

Added in API level 1 
void onClick ()

处理点击偏好。 这包括将值保存到SharedPreferences 。 但是，重写的方法应该调用callChangeListener(Object)以确保客户端想要用新值更新首选项的状态。

onGetDefaultValue

Added in API level 1 
Object onGetDefaultValue (TypedArray a, 
                int index)

当首选项被夸大并且需要读取默认值属性时调用。 由于不同的首选项类型具有不同的值类型，因此子类应获取并返回默认值，该默认值将是其值类型。

例如，如果值类型为String，则该方法的主体将代理为 getString(int) 。

参数(Parameters)
a TypedArray: The set of attributes.
index int: The index of the default value attribute.
返回(Returns)
Object The default value of this preference type.

onPrepareRingtonePickerIntent

Added in API level 1 
void onPrepareRingtonePickerIntent (Intent ringtonePickerIntent)

准备启动铃声选择器的意图。 这可以修改，以调整铃声选择器的参数。

参数(Parameters)
ringtonePickerIntent Intent: The ringtone picker intent that can be modified by putting extras.

onRestoreRingtone

Added in API level 1 
Uri onRestoreRingtone ()

当选择器即将显示并且当前铃声应被标记时调用。 可以返回null以不标记任何铃声。

默认情况下，这将恢复永久存储中的以前的铃声URI。

返回(Returns)
Uri The ringtone to be marked as the current ringtone.

onSaveRingtone

Added in API level 1 
void onSaveRingtone (Uri ringtoneUri)

当选择铃声时调用。

默认情况下，这将铃声URI作为字符串保存到永久存储器中。

参数(Parameters)
ringtoneUri Uri: The chosen ringtone's Uri. Can be null.

onSetInitialValue

Added in API level 1 
void onSetInitialValue (boolean restorePersistedValue, 
                Object defaultValueObj)

执行此操作来设置首选项的初始值。

如果restorePersistedValue为true，则应从SharedPreferences恢复首选项值。 如果restorePersistedValue为false，则应将Preference值设置为给定的defaultValue（并且如果shouldPersist()为true，则可能shouldPersist()其存储到SharedPreferences中）。

这可能并不总是被称为。 一个例子是，如果它不应该坚持，但没有给出默认值。

参数(Parameters)
restorePersistedValue boolean: True to restore the persisted value; false to use the given defaultValue.
defaultValueObj Object: The default value for this Preference. Only use this if restorePersistedValue is false.
Android开发手册

Hooray!