RingtonePreference Class
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
A Preference that allows the user to choose a ringtone from those on the device.
[Android.Runtime.Register("android/preference/RingtonePreference", DoNotGenerateAcw=true)]
public class RingtonePreference : Android.Preferences.Preference, Android.Preferences.PreferenceManager.IOnActivityResultListener, IDisposable, Java.Interop.IJavaPeerable[<Android.Runtime.Register("android/preference/RingtonePreference", DoNotGenerateAcw=true)>]
type RingtonePreference = class
inherit Preference
interface PreferenceManager.IOnActivityResultListener
interface IJavaObject
interface IDisposable
interface IJavaPeerable- Inheritance
- Attributes
- Implements
Remarks
A Preference that allows the user to choose a ringtone from those on the device. The chosen ringtone's URI will be persisted as a string.
If the user chooses the "Default" item, the saved string will be one of System#DEFAULT_RINGTONE_URI, System#DEFAULT_NOTIFICATION_URI, or System#DEFAULT_ALARM_ALERT_URI. If the user chooses the "Silent" item, the saved string will be an empty string.
This member is deprecated. Use the AndroidX Preference Library for consistent behavior across all devices. For more information on using the AndroidX Preference Library see Settings.
Java documentation for android.preference.RingtonePreference.
Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.
Constructors
| RingtonePreference(Context, IAttributeSet, Int32, Int32) | |
| RingtonePreference(Context, IAttributeSet, Int32) | |
| RingtonePreference(Context, IAttributeSet) | |
| RingtonePreference(Context) | |
| RingtonePreference(IntPtr, JniHandleOwnership) |
A constructor used when creating managed representations of JNI objects; called by the runtime. |
Fields
| DefaultOrder |
Specify for |
Properties
| Class |
Returns the runtime class of this |
| Context |
Returns the |
| Dependency |
Returns the key of the dependency on this Preference. -or- Sets the key of a Preference that this Preference will depend on. (Inherited from Preference) |
| Editor |
Returns an |
| Enabled |
Checks whether this Preference should be enabled in the list. -or- Sets whether this Preference is enabled. (Inherited from Preference) |
| Extras |
Return the extras Bundle object associated with this preference, creating a new Bundle if there currently isn't one. (Inherited from Preference) |
| Fragment |
Return the fragment class name associated with this Preference. -or- Sets the class name of a fragment to be shown when this Preference is clicked. (Inherited from Preference) |
| Handle |
The handle to the underlying Android instance. (Inherited from Object) |
| HasKey |
Checks whether this Preference has a valid key. (Inherited from Preference) |
| Icon |
Returns the icon of this Preference. -or- Sets the icon for this Preference with a Drawable. (Inherited from Preference) |
| IconSpaceReserved |
Gets whether the space this preference icon view is reserved. -or- Sets whether to reserve the space of this Preference icon view when no icon is provided. (Inherited from Preference) |
| Intent |
Return the |
| JniIdentityHashCode | (Inherited from Object) |
| JniPeerMembers | |
| Key |
Gets the key for this Preference, which is also the key used for storing values into
|
| LayoutResource |
Gets the layout resource that will be shown as the |
| OnPreferenceChangeListener |
Returns the callback to be invoked when this Preference is changed by the user (but before the internal state has been updated). -or- Sets the callback to be invoked when this Preference is changed by the user (but before the internal state has been updated). (Inherited from Preference) |
| OnPreferenceClickListener |
Returns the callback to be invoked when this Preference is clicked. -or- Sets the callback to be invoked when this Preference is clicked. (Inherited from Preference) |
| Order |
Gets the order of this Preference with respect to other Preference objects on the same level. -or- Sets the order of this Preference with respect to other Preference objects on the same level. (Inherited from Preference) |
| Parent |
Returns the |
| PeerReference | (Inherited from Object) |
| Persistent |
Checks whether this Preference is persistent. -or- Sets whether this Preference is persistent. (Inherited from Preference) |
| PreferenceDataStore |
Returns |
| PreferenceManager |
Gets the |
| RecycleEnabled |
Checks whether this Preference has enabled to have its view recycled when used in the list view. -or- Sets whether this Preference has enabled to have its view recycled when used in the list view. (Inherited from Preference) |
| RingtoneType |
Returns the sound type(s) that are shown in the picker. -or- Sets the sound type(s) that are shown in the picker. |
| Selectable |
Checks whether this Preference should be selectable in the list. -or- Sets whether this Preference is selectable. (Inherited from Preference) |
| SharedPreferences |
Returns the |
| ShouldDisableView |
Checks whether this Preference should disable its view when it's action is disabled. -or- Sets whether this Preference should disable its view when it gets disabled. (Inherited from Preference) |
| ShowDefault |
Returns whether to a show an item for the default sound/ringtone. -or- Sets whether to show an item for the default sound/ringtone. |
| ShowSilent |
Returns whether to a show an item for 'Silent'. -or- Sets whether to show an item for 'Silent'. |
| SingleLineTitle |
Gets whether the title of this preference is constrained to a single line. -or- Sets whether to constrain the title of this Preference to a single line instead of letting it wrap onto multiple lines. (Inherited from Preference) |
| Summary | (Inherited from Preference) |
| SummaryFormatted |
Returns the summary of this Preference. -or- Sets the summary for this Preference with a CharSequence. (Inherited from Preference) |
| ThresholdClass |
This API supports the Mono for Android infrastructure and is not intended to be used directly from your code. |
| ThresholdType |
This API supports the Mono for Android infrastructure and is not intended to be used directly from your code. |
| Title | (Inherited from Preference) |
| TitleFormatted |
Returns the title of this Preference. -or- Sets the title for this Preference with a CharSequence. (Inherited from Preference) |
| TitleRes |
Returns the title resource ID of this Preference. (Inherited from Preference) |
| WidgetLayoutResource |
Gets the layout resource for the controllable widget portion of this Preference. -or- Sets the layout for the controllable widget portion of this Preference. (Inherited from Preference) |
Methods
| CallChangeListener(Object) |
Call this method after the user changes the preference, but before the internal state is set. (Inherited from Preference) |
| Clone() |
Creates and returns a copy of this object. (Inherited from Object) |
| CompareTo(Preference) |
Compares Preference objects based on order (if set), otherwise alphabetically on the titles. (Inherited from Preference) |
| Dispose() | (Inherited from Object) |
| Dispose(Boolean) | (Inherited from Object) |
| Equals(Object) |
Indicates whether some other object is "equal to" this one. (Inherited from Object) |
| FindPreferenceInHierarchy(String) |
Finds a Preference in this hierarchy (the whole thing,
even above/below your |
| GetHashCode() |
Returns a hash code value for the object. (Inherited from Object) |
| GetPersistedBoolean(Boolean) |
Attempts to get a persisted boolean if this Preference is persistent. (Inherited from Preference) |
| GetPersistedFloat(Single) |
Attempts to get a persisted float if this Preference is persistent. (Inherited from Preference) |
| GetPersistedInt(Int32) |
Attempts to get a persisted int if this Preference is persistent. (Inherited from Preference) |
| GetPersistedLong(Int64) |
Attempts to get a persisted long if this Preference is persistent. (Inherited from Preference) |
| GetPersistedString(String) |
Attempts to get a persisted String if this Preference is persistent. (Inherited from Preference) |
| GetPersistedStringSet(ICollection<String>) |
Attempts to get a persisted set of Strings if this Preference is persistent. (Inherited from Preference) |
| GetView(View, ViewGroup) |
Gets the View that will be shown in the |
| JavaFinalize() |
Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. (Inherited from Object) |
| Notify() |
Wakes up a single thread that is waiting on this object's monitor. (Inherited from Object) |
| NotifyAll() |
Wakes up all threads that are waiting on this object's monitor. (Inherited from Object) |
| NotifyChanged() |
Should be called when the data of this |
| NotifyDependencyChange(Boolean) |
Notifies any listening dependents of a change that affects the dependency. (Inherited from Preference) |
| NotifyHierarchyChanged() |
Should be called when a Preference has been added/removed from this group, or the ordering should be re-evaluated. (Inherited from Preference) |
| OnActivityResult(Int32, Result, Intent) |
See Activity's onActivityResult. |
| OnAttachedToActivity() |
Called when the Preference hierarchy has been attached to the
|
| OnAttachedToHierarchy(PreferenceManager) |
Called when this Preference has been attached to a Preference hierarchy. (Inherited from Preference) |
| OnBindView(View) |
Binds the created View to the data for this Preference. (Inherited from Preference) |
| OnClick() |
Processes a click on the preference. (Inherited from Preference) |
| OnCreateView(ViewGroup) |
Creates the View to be shown for this Preference in the
|
| OnDependencyChanged(Preference, Boolean) |
Called when the dependency changes. (Inherited from Preference) |
| OnGetDefaultValue(TypedArray, Int32) |
Called when a Preference is being inflated and the default value attribute needs to be read. (Inherited from Preference) |
| OnParentChanged(Preference, Boolean) |
Called when the implicit parent dependency changes. (Inherited from Preference) |
| OnPrepareForRemoval() |
Called when this Preference is being removed from the hierarchy. (Inherited from Preference) |
| OnPrepareRingtonePickerIntent(Intent) |
Prepares the intent to launch the ringtone picker. |
| OnRestoreInstanceState(IParcelable) |
Hook allowing a Preference to re-apply a representation of its internal state that had
previously been generated by |
| OnRestoreRingtone() |
Called when the chooser is about to be shown and the current ringtone should be marked. |
| OnSaveInstanceState() |
Hook allowing a Preference to generate a representation of its internal state that can later be used to create a new instance with that same state. (Inherited from Preference) |
| OnSaveRingtone(Uri) |
Called when a ringtone is chosen. |
| OnSetInitialValue(Boolean, Object) |
Implement this to set the initial value of the Preference. (Inherited from Preference) |
| PeekExtras() |
Return the extras Bundle object associated with this preference, returning |
| PersistBoolean(Boolean) |
Attempts to persist a boolean if this Preference is persistent. (Inherited from Preference) |
| PersistFloat(Single) |
Attempts to persist a long if this Preference is persistent. (Inherited from Preference) |
| PersistInt(Int32) |
Attempts to persist an int if this Preference is persistent. (Inherited from Preference) |
| PersistLong(Int64) |
Attempts to persist a long if this Preference is persistent. (Inherited from Preference) |
| PersistString(String) |
Attempts to persist a String if this Preference is persistent. (Inherited from Preference) |
| PersistStringSet(ICollection<String>) |
Attempts to persist a set of Strings if this Preference is persistent. (Inherited from Preference) |
| RestoreHierarchyState(Bundle) |
Restore this Preference hierarchy's previously saved state from the given container. (Inherited from Preference) |
| SaveHierarchyState(Bundle) |
Store this Preference hierarchy's frozen state into the given container. (Inherited from Preference) |
| SetDefaultValue(Object) |
Sets the default value for this Preference, which will be set either if persistence is off or persistence is on and the preference is not found in the persistent storage. (Inherited from Preference) |
| SetHandle(IntPtr, JniHandleOwnership) |
Sets the Handle property. (Inherited from Object) |
| SetIcon(Int32) |
Sets the icon for this Preference with a resource ID. (Inherited from Preference) |
| SetSummary(Int32) |
Sets the summary for this Preference with a resource ID. (Inherited from Preference) |
| SetTitle(Int32) |
Sets the title for this Preference with a resource ID. (Inherited from Preference) |
| ShouldCommit() |
Returns whether the |
| ShouldDisableDependents() |
Checks whether this preference's dependents should currently be disabled. (Inherited from Preference) |
| ShouldPersist() |
Checks whether, at the given time this method is called, this Preference should store/restore
its value(s) into the |
| ToArray<T>() | (Inherited from Object) |
| ToString() |
Returns a string representation of the object. (Inherited from Object) |
| UnregisterFromRuntime() | (Inherited from Object) |
| Wait() |
Causes the current thread to wait until it is awakened, typically by being <em>notified</em> or <em>interrupted</em>. (Inherited from Object) |
| Wait(Int64, Int32) |
Causes the current thread to wait until it is awakened, typically by being <em>notified</em> or <em>interrupted</em>, or until a certain amount of real time has elapsed. (Inherited from Object) |
| Wait(Int64) |
Causes the current thread to wait until it is awakened, typically by being <em>notified</em> or <em>interrupted</em>, or until a certain amount of real time has elapsed. (Inherited from Object) |
Events
| PreferenceChange | (Inherited from Preference) |
| PreferenceClick | (Inherited from Preference) |
Explicit Interface Implementations
| IComparable.CompareTo(Object) | (Inherited from Preference) |
| IJavaPeerable.Disposed() | (Inherited from Object) |
| IJavaPeerable.DisposeUnlessReferenced() | (Inherited from Object) |
| IJavaPeerable.Finalized() | (Inherited from Object) |
| IJavaPeerable.JniManagedPeerState | (Inherited from Object) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) | (Inherited from Object) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) | (Inherited from Object) |
| IJavaPeerable.SetPeerReference(JniObjectReference) | (Inherited from Object) |
Extension Methods
| JavaCast<TResult>(IJavaObject) |
Performs an Android runtime-checked type conversion. |
| JavaCast<TResult>(IJavaObject) | |
| GetJniTypeName(IJavaPeerable) | |