System properties

The table below contains the File API system properties that return the localized names of common directories and the URLs to the most common directories. Several Strings are only supported in either S60 or Series 40. Refer to the individual tables for each implementation.

Table 24: File API system properties in S60

String

Description

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.private.name

Localized name for the private work directory, for example "scratch".

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:/".

fileconn.dir.private

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

S60 3rd Ed. FP 2

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 nonlocalized (logical) name is returned in the property for this root. Root names returned through this property cannot contain the semicolon (;) character.

Example for S60:

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

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

Table 25: File API system properties in Series 40

String

Description

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.themes.name

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

fileconn.dir.photos

The URL of the default storage directory for photos captured with the integrated camera and other images. "file:///C:/predefgallery/predefphotos".

fileconn.dir.videos

The URL of the default storage directory for video clips captured with the integrated camera or downloaded and saved. "file:///C:/predefgallery/predefvideos".

fileconn.dir.graphics

The URL of the default storage directory for clip art graphics (caller group icons, background pictures, and other similar items). "file:///C:/predefgallery/predefgraphics".

fileconn.dir.tones

The URL of the default storage directory for ring tones and other related audio files. "file:///C:/predefgallery/predeftones".

Fileconn.dir.music

The URL of the default storage directory for music files (MP3, AAC, and others). "file:///C:/predefgallery/predefmusic".

fileconn.dir.recordings

The URL of the default storage directory for voice recordings made with the device. "file:///C:/predefgallery/predefrecordings".

fileconn.dir.themes

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

fileconn.dir.memorycard

Root directory of memory card. "file:///e:/".

Example for Series 40:

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

The Content of the URL is file:///C:/predefgallery/predefphotos/myimage.jpg