Most visited

Recently visited

Results for

Added in API level 1

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

`android:defaultValue`	The default value for the preference, which will be set either if persistence is off or persistence is on and the preference is not found in the persistent storage.
`android:dependency`	The key of another Preference that this Preference will depend on.
`android:enabled`	Whether the Preference is enabled.
`android:fragment`	When used inside of a modern PreferenceActivity, this declares a new PreferenceFragment to be shown when the user selects this item.
`android:icon`	The optional icon for the preference 必须是另一个资源的引用，其形式为“ `@[+][package:]type:name` ”，或者其形式为“一个主题属性 `?[package:][type:]name` ”。
`android:key`	The key to store the Preference value.
`android:layout`	The layout for the Preference in a PreferenceActivity screen.
`android:order`	The order for the Preference (lower values are to be ordered first).
`android:persistent`	Whether the Preference stores its value to the shared preferences.
`android:selectable`	Whether the Preference is selectable.
`android:shouldDisableView`	Whether the view of this Preference should be disabled when this Preference is disabled.
`android:summary`	The summary for the Preference in a PreferenceActivity screen.
`android:title`	The title for the Preference in a PreferenceActivity screen.
`android:widgetLayout`	The layout for the controllable widget portion of a 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.

也可以看看：

setRingtoneType(int)

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.

也可以看看：

EXTRA_RINGTONE_TYPE

setShowDefault

Added in API level 1

void setShowDefault (boolean showDefault)

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

Parameters
`showDefault`	`boolean`: Whether to show the default or not.

也可以看看：

EXTRA_RINGTONE_SHOW_DEFAULT

setShowSilent

Added in API level 1

void setShowSilent (boolean showSilent)

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

Parameters
`showSilent`	`boolean`: Whether to show 'Silent'.

也可以看看：

EXTRA_RINGTONE_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.

Interfaces

Classes

Most visited

Recently visited

Results for

RingtonePreference

Summary

XML attributes

Inherited XML attributes

Inherited constants

Public constructors

Public methods

Protected methods

Inherited methods

XML attributes

android:ringtoneType

android:showDefault

android:showSilent

Public constructors

RingtonePreference

RingtonePreference

RingtonePreference

RingtonePreference

Public methods

getRingtoneType

getShowDefault

getShowSilent

onActivityResult

setRingtoneType

setShowDefault

setShowSilent

Protected methods

onAttachedToHierarchy

onClick

onGetDefaultValue

onPrepareRingtonePickerIntent

onRestoreRingtone

onSaveRingtone

onSetInitialValue