document.allowScreens()

Availability

Flash MX 2004.

Usage

document.allowScreens()

Parameters

None.

Returns

A Boolean value: true if document.screenOutline can be used safely; false otherwise.

Description

Method; use before using the document.screenOutline property. If this method returns the value true, you can safely access document.screenOutline; Flash displays an error if you access document.screenOutline in a document without screens.

Example

The following example determines whether screens methods can be used in the current document:

if(fl.getDocumentDOM().allowScreens()) { 
    fl.trace("screen outline is available."); 
}  
else { 
    fl.trace("whoops, no screens."); 
}

See also

document.screenOutline