System.IOUtils.TPath.GetRingtonesPath
Delphi
class function GetRingtonesPath: string; static;
C++
static System::UnicodeString __fastcall GetRingtonesPath();
Properties
| Type | Visibility | Source | Unit | Parent |
|---|---|---|---|---|
| function | public | System.IOUtils.pas System.IOUtils.hpp |
System.IOUtils | TPath |
Description
Returns the path to the directory where user ring tones are stored.
If the system running your application does not support the requested folder, or if the requested folder does not exist in the system, this function returns an empty string instead.
This function works the same as GetMusicPath except for the Android platform, where it returns the path to the folder where Android stores ring tones.
- On Windows and OS X, it points to a user-specific, application-agnostic directory.
- Note: On OS X, for Sand-box mode, to access this path you have to add com.apple.security.assets.music.read-only or com.apple.security.assets.music.read-write to the Entitlement List.
- On iOS Device, it returns an empty string as this directory is currently not supported.
- On iOS Simulator and Android, it points to a user-specific, application-specific directory.
| Platform | Sample path | Path ID |
|---|---|---|
| Windows XP | C:\Documents and Settings\<username>\My Documents\My Music | CSIDL_MYMUSIC |
| Windows Vista or later | C:\Users\<username>\Music | FOLDERID_Music |
| OS X | /Users/<username>/Music | NSMusicDirectory |
| iOS Device | ||
| iOS Simulator | /Users/<username>/Library/Developer/CoreSimulator/Devices/<Device ID>/data/Containers/Data/Application/<application ID>/Music | NSMusicDirectory |
| Android | /storage/emulated/0/Android/data/<application ID>/files/Ringtones |