STF.getSpecialFolder()

Availability

Usage

STF.getSpecialFolder(folderName:String) : String

Parameters

folderName - Name of the folder path to retrieve - one of the following values.

"USER_APPLICATIONS" - Depending on the OS, this returns the path to the user's Applications (Mac) or Programs (Windows) folder.

"COMMON_APPLICATIONS" - Depending on the OS, this returns the path to the common Applications (Mac) or Programs (Windows) folder.

"CACHES" - Mac ONLY - Returns the path to the user's Cache folder.

"DESKTOP" - Returns the path to the user's Desktop folder.

"DOCUMENTS" - Depending on the OS, this returns the path to the user's Documents (Mac) or "My Documents" (Windows) folder.

"HOME" - Mac ONLY - Local returns the location where applications store data by default.

"LIBRARY" - Mac ONLY - Returns the path to the user's Library folder.

"MYAPP" - Returns the path to the folder containing the application or in this case the screen saver.

"MYDOCUMENTS" - Depending on the OS, this returns the path to the user's Documents (Mac) or "My Documents" (Windows) folder.

"MYPICTURES" - Depending on the OS, this returns the path to the user's Pictures (Mac) or "My Pictures" (Windows) folder.

"PICTURES" - Depending on the OS, this returns the path to the user's Pictures (Mac) or "My Pictures" (Windows) folder.

"PREFERENCES" - Mac ONLY - Returns the path to the user's Preferences folder.

"PROGRAMS" - Depending on the OS, this returns the path to the user's Applications (Mac) or Programs (Windows) folder.

"ROOTSWF" - Returns the path to the main SWF. On the Mac this location is inside the application bundle. The values "WORKING" and "ROOTSWF" return the same path..

"SCREENSAVERS" - Mac ONLY - Returns the path to the user's screen savers folder.

"STARTMENU" - Windows ONLY - Returns the path of the Start Menu folder. To add an application to the Windows Start menu, add a shortcut to this directory. .

"STARTUP" - Windows ONLY - Returns the path of the Startup folder. Placing a shortcut to your application in this folder will cause Windows to it launch when the user reboots the computer.

"SYSTEM" - Windows ONLY - Returns the location of the Windows root system directory.

"WINDOWS" - Windows ONLY - Returns the path to the Windows folder.

"WORKING" - Returns the path to the folder containing the included external files and the main SWF. On the Mac this location is inside the application bundle. The values "WORKING" and "ROOTSWF" return the same path.

"COMMON_APPDATA" - Windows ONLY - Returns the path to the Common Application Data folder. This defaults to the following path: \Documents and Settings\All Users\Application Data. For more information see http://support.microsoft.com/kb/310294.

"USER_APPDATA" - Windows ONLY - Returns the path to the User's Application Data folder. This defaults to the following path: \Documents and Settings\<User Name>\Application Data. For more information see http://support.microsoft.com/kb/310294.

Returns

A string.; ; This value is returned as a parameter to the registered callback. See the example below or STF.registerCallBack() for more information on return variable handling.

Description

Method; Retrieves the path of a special folder.

Example

The following example returns the path to the user's Documents (Mac) or "My Documents" (Windows) folder.

var programsPath = mSystem.getProgramsFolder();

var myName = "cool application";
var myPath = mApplication.getFolder() + myName;
var system_str = System.capabilities.os.toLowerCase();
if (system_str.indexOf("win")>=0) {
	myPath += myPath + ".exe";
} else if (system_str.indexOf("mac")>=0) {
	myPath += myPath + ".app";
} 

mFile.createShortcut(myPath,"",programsPath+"/ScreenTime/File.lnk","File","",0);