Dialogs.BrowseFile.showAsync() This page was last modified over 30 day(s) ago and has 0 comment(s)


Back to Dialogs.BrowseFile Class Summary

Availability
Windows, Mac OSX, Linux

Usage
mdm.Dialogs.BrowseFile.showAsync():void

Parameters
None

Returns
Nothing

Description
Displays a BrowseFile dialog which allows the user to select any file from their system. This is asynchronous method - so when the user has selected file, the full path to the file is returned via event dispatched to registered listener or called via assigned handler (see below for details).

If the user selects CANCEL the onCancel event will be called. If there is selection done by user then onSelect or onSelectMultiple event will be dispatched/called depending if dialog configuration allows multiple selection

Notes
There are two ways to listen for events in 4.0:
#1
using "onEventNameFunction" - callback based handlers introduced in {mdm} 2.0
#2
using IEventListener model based on Events introduced in 4.0.

No matter what implementation you would use either callback and listener handler would have to use single-argument defintion as in below sample:
// callback based handlers
mdm.Appllication.onAppChangeFocus = function(event:Event):void
{
// proceed with event
};

// handlers based on IEventListener model
function onAppChangeFocusHandler(event:Event):void
{
// proceed with event
};

Example Code
// callback version
mdm.Dialogs.BrowseFile.onCancel = function(event:Event):void
{
// dialog is dismissed/cancelled
};
//
mdm.Dialogs.BrowseFile.onSelect = function(event:mdm.Event):void
{
// path is contained in "result" property of data, see
var path:String = event.data.result;
};
mdm.Dialogs.BrowseFile.onSelectMultiple = function(event:mdm.Event):void
{
// "result" property is now an Array containing paths of selected content
var paths:Array = event.data.result;
};
//
mdm.Dialogs.BrowseFile.showAsync();


// event-listener model
function onCancelHandler(event:Event):void
{
// dialog is dismissed/cancelled
};
//
function onSelectHandler(event:mdm.Event):void
{
// path is hosted in "result" property of data, see
var path:String = event.data.result;
};
function onSelectMultipleHandler(event:mdm.Event):void
{
// "result" property is now an Array containing paths of selected content
var paths:Array = event.data.result;
};
//
mdm.Dialogs.BrowseFile.addEventListener("onCancel", onCancelHandler);
mdm.Dialogs.BrowseFile.addEventListener("onSelect", onSelectHandler);
mdm.Dialogs.BrowseFIle.addEventListener("onSelectMultiple", onSelectMultipleHandler);
//
mdm.Dialogs.BrowseFile.showAsync();

mdm.Dialogs.BrowseFile Class Example Downloads
No Example Downloads Available


Registered Users must be logged in to 'MyAccount' to add a Comment - Log In Here
  After Logging In, Click Here to Refresh This Page