ssDefaults.loadFilesFromLayout

Global flag indicating that all Flash load commands will load files from the SWF Studio layout by default.


Availability:

First available in version 3.2 build 136.


Notes:

Property; You can set this property at any point, and even bracket calls by setting it before a call and then resetting it after a call.

By default, issuing a MovieClip.loadMovie command with a relative path will cause the specified file to be loaded from the base path set in SWF Studio. For more information on setting the base path see the Movie Tab, Default Base Path. By default the base path is the same location as the EXE. If the file does not exist in the base path, the layout will be checked for the specified file and loaded from the layout if it exists. If it does not exist the call will fail silently.

Setting this property to true changes the default behaviour of some of Flash's load commands so that files are loaded from the layout. If the file does not exist in the layout an attempt will be made to load the file from the base path. For more information see Flash Load Behaviour in SWF Studio.

Note: If the option to use the secure loader for the main movie IS NOT enabled (default), only files that have been extracted from the layout will be loaded. The secure loader is NOT used if the secure loader option was not enabled, unless you explicitly use one of the secure methods or the secure:// moniker. Files in the layout will not be extracted for you unless you set the files to auto-extract.

If the option to use the secure loader for the main movie IS enabled, files will be loaded using the secure loader and do not have to be extracted first.

Affected methods include:


Examples:

Example 1
In this example we want to load a SWF file named "file.swf", that we've included in the SWF Studio Files tab (layout), into a movieclip called "myClip". If the file does not exist in the layout the call will fail silently.

ssDefaults.loadFilesFromLayout = true;

myClip.loadMovie('file.swf');

Example 2
In this example we want to load a SWF file named "file.swf", that exists next to our EXE, into a movieclip called "myClip". If the file does not exist in the base path, the layout is checked. If it does not exist in the layout, the call fails silently.

// This line is optional here since this is the default setting.
ssDefaults.loadFilesFromLayout = false;

myClip.loadMovie('file.swf');

Example 3
You can also specify a full path or use a moniker, which will ignore the ssDefaults.loadFilesFromLayout value, since the full path is specified. If the files do not exist where specified, no further attempts are made to load the files.

myClip.loadMovie('startdir://file.swf'); // Loads a file that exists next to the EXE
myClip.loadMovie('secure://file.swf'); // Loads a file that exists in the layout via the secure loader