mSystem.chooseFiles()

Windows: Flash 8 or 9 AS2.0 SWF + mProjector

3.0; Windows 98/ME/NT Support: Flash 7 SWF + mProjector

2.0 build 'de';

Usage

Parameters

filter - The descriptions and extensions of the files to browse. Platform Implementation Differences: On Windows the format is description+"|"+*.extention, i.e."Flash Files (*.swf)|*.swf" for a single file type, "Media Files (*.swf;*.flv;*.mp3)|*.swf;*.flv;*.mp3" for multiple file types, or "All Files (*.*)|*.*" for all types. On the Mac the filter format is "extension", i.e. "swf" for a single file type, "swf, flv, mp3" for multiple file types, or "*" for all file types.

defaultExtension - WINDOWS ONLY - The default file extension, in case one is not specified. Platform Implementation Differences: On Windows the format is "extension", i.e. "swf". The default extension is ignored on the Mac, pass an empty string.

Returns

Description

Method; Opens a file dialog box, allowing the user to specify the drive, directory, and name of the file to open. If no file is selected, this function returns "undefined".

Example

The following example enables the user to select JPEG files from the Pictures folder on Mac and the "My Pictures" fodler on Windows..

var chooseFileTitle = "Select JPGs";
var initFileName = "test.jpg";
var initFolderName = mSystem.getSpecialFolder("PICTURES");
var fileFilter:String;
var defaultFileType:String;
var fileMustExist = true;
var saveFile = false;
var selectedFiles:String;

if (mSystem.isMac()) {
	fileFilter = "jpg";
	defaultFileType = "";
} else if (mSystem.isWindows()){
	fileFilter = "JPEG Files (*.jpg)|*.jpg";		
	defaultFileType = "jpg";
}

chooseFiles_btn.onRelease = function() {
	var selectedFilesArray:Array = mSystem.chooseFiles(chooseFileTitle, initFileName, initFolderName, fileFilter, defaultFileType);
	selectedFiles = "";
	for (i=0; i<selectedFilesArray.length; i++) {
		selectedFiles = selectedFiles+selectedFilesArray[i]+newline;
	}
};