mProjectorDocumentation	Previous | Next

mApplication.createWindow()

Availability

Windows: Flash 8 or 9 AS2.0 SWF + mProjector 3.0; Windows 98/ME/NT Support: Flash 7 SWF + mProjector 2.0;

Macintosh: Flash 8 or 9 AS2.0 SWF + mProjector 2.0;

Usage

mApplication.createWindow(flashFileName:String, x:Number, y:Number, parameter:String, title:String, type:String, backgroundColor:String, ownedByMainWindow:Boolean[, intialAlpha:Number][, resizeable:Boolean][, hasShadow:Boolean][, shapeFilename:String]) : Object

Parameters

flashFileName - Path to the .swf file used to initialize the window.

x - Window x position.

y - Window y position.

parameter - Context parameter. Use this parameter to store coded information about the window. For example if the window represents an IM chat, this param could contain the userid of the chat.

title - Window title.

type - one of the following string values:

• "STANDARD" - Standard window with a drag bar, frame, and caption.
• "RECTANGULAR" - Rectangular window with no frame or caption.
• "WINDOWLESS" - Dynamic Flash-shaped, irregularly shaped window with transparency.

On the Mac the "WINDOWLESS" window shape is created by punching out regions of the window matching the background color of Flash swf. Choose the background color so that it doesn't appear in gradients in the Flash content.

Flash alpha channels and anti-aliasing in windowless type windows is not currently supported on the Macintosh. As a workaround we have added the ability to set a global alpha level to Mac windows using mWindow.setAlpha(). This command can be used to create a semi-tranparent window or to fade a window in and out.

Windowless performance on the Mac can be an issue. We are working to improve performance. Review the Performance topic for ideas on optimizing your application's performance.

Another way to create shaped windows on the Mac is to apply a TIFF mask to a "RECTANGULAR" type window. The window is constructed by playing the Flash content in an opaque rectangle centered over the TIF file. The window is transparent in regions outside of the Flash rectangle where the TIF is transparent. See Using mProjector Macintosh for more information.

backgroundColor - WINDOWS Only - A number representing an RGB color (not applicable in windowless mode).

ownedByMainWindow - True or false. If the value is true, the child window will have the same zOrder class as the main window.

intialAlpha - MAC ONLY - the initial alpha level of the window (0 to 100; where 0=transparent and 100=opaque). If no value is specified, a value of 100 is used. This vaule can be used to create a semi-tranparent window or to fade a window in and out. You can change the window's alpha level using mWindow.setAlpha(level).

resizeable - MAC ONLY. If no value is provided, resizable=true.Adds the resizeable contros to the "STANDARD" window frame.

hasShadow - MAC ONLY - use Mac OS provided drop shadow. If no value is provided, hasShadow=true.

shapeFilename - MAC ONLY - name of the TIFF to be used as a window mask.

If your window type selection is "RECTANGULAR", mProjector will play your swf in a rectangle the size of the movie. It will underlay the TIFF you choose as the shape, around the outside of the this rectangle. This is another to create simple anti-aliased shaped windows on the Mac. See Using mProjector Macintosh for more information.

Returns

An object.; ; Returns a window object.

Description

Method; Creates a new window. The returned window object has the same methods as the main mWindow object. The context parameter passed to this function can be retrieved by the created window's ActionScript using the mWindow.getParameter() function.

Example

The following example creates a window and calls one of its methods.

var win = mApplication.createWindow("popup.swf",100,100,"hello","popup","RECTANGULAR",0,true);
if (win)
{
    win.setZOrder("NORMAL");
}

See Also

mWindow.getParameter()

Code Examples

Creating and Controlling Multiple Windows, Window to Window Communications

Questions or Feedback?	Previous | Next