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.");
}