System properties

The table below contains the FileConnection API system properties that return the localized names of common directories and the URLs to the most common directories.

Note: For information about the Nokia-specific com.nokia.dir.name:xxxx system property supported on Series 40 devices, see section Nokia-specific system properties.

Table: FileConnection API system properties in the Symbian platform and Series 40

String

Description

microedition.io.file.FileConnection.version

Returns the version of FileConnection API supported by the device.

fileconn.dir.photos.name

Localized name for the photo directory, for example "Images".

fileconn.dir.videos.name

Localized name for the video directory, for example "Video clips".

fileconn.dir.graphics.name

Localized name for the graphic directory, for example "Graphic clips".

fileconn.dir.tones.name

Localized name for the sounds directory, for example "Sound clips".

fileconn.dir.music.name

Localized name for the music directory, for example "Music clips".

fileconn.dir.recordings.name

Localized name for the recordings directory, for example "Recorded clips".

fileconn.dir.memorycard.name

Localized UI name for the memory card of directory, for example "Memory card".

fileconn.dir.photos

The URL of the default storage directory for photos captured with the integrated camera and other images. For example, "file:///c:/My files/Images/".

fileconn.dir.videos

The URL of the default storage directory for video clips captured with the integrated camera or downloaded and saved. For example, "file:///c:/My files/Video clips/".

fileconn.dir.graphics

The URL of the default storage directory for clip art graphics (caller group icons, background pictures, and other similar items). For example, "file:///c:/My files/Graphic clips/".

fileconn.dir.tones

The URL of the default storage directory for ring tones and other related audio files. For example, "file:///c:/My files/Sound clips/".

fileconn.dir.music

The URL of the default storage directory for music files (MP3, AAC, and others). For example, "file:///c:/My files/Music clips/".

fileconn.dir.recordings

The URL of the default storage directory for voice recordings made with the device. For example, "file:///c:/My files/Recorded clips/".

fileconn.dir.memorycard

Root directory of memory card. For example, "file:///e:/".

file.separator

Character used for separating directories in strings representing file and folder paths (as shown to the user).

On S60 5th Edition and earlier Symbian devices, the separator character is "/". From Symbian^3 onwards, the separator character is "\".

Note: Do not use the file.separator value to construct URIs, since this can result in invalid URIs. For valid URIs, the only allowed separator character is "/".

fileconn.dir.private.name

Localized name for the private work directory. For example, when the device language set to English:

  • On Series 40 devices: "Private"

  • On Symbian devices: "Private"

fileconn.dir.private

Private work directory of MIDlet suite. For example, "file:///c:/private/102033e6/midlets/[1015b77b]/scratch".

fileconn.dir.roots.names

Localized names corresponding to roots returned by the FileSystemRegistry.listRoots() method. One localized name corresponds to each root returned by the method. Localized names are in the same order as returned by the method and are separated by a semicolon (;) character. If no localized name exists for the root, the non-localized (logical) name is returned in the property for this root. Root names returned through this property cannot contain the semicolon (;) character.

Note: The localized names returned are meant to be shown to the user, not used in the File URIs.

fileconn.dir.themes.name

(Only in Series 40)

Localized name for the themes directory, for example "Themes".

fileconn.dir.themes

(Only in Series 40)

The URL of the default storage directory for themes. "file:///C:/predefgallery/predefthemes"

Example:

String url = System.getProperty("fileconn.dir.photos") + "myImage.jpg";

The content of the URL is file:///c:/data/Images/myImage.jpg