Stage.showMenu Property

ActionScript for Flash MX: The Definitive Guide, 2nd Edition
By Colin Moock
Chapter 18.  ActionScript Language Reference
Stage.showMenu Property Flash 6; available through fscommand( ) since Flash 3

Boolean; determines the items displayed in the Flash Player's contextual menu read/write
Stage.showMenu

Description

The Boolean showMenu property indicates whether the Flash Player's contextual menu contains a full list of items (true) or a minimal list of items (false). It defaults to true but is often set to false to prevent users from manipulating the movie in undesirable ways, such as stopping it, rewinding it, or zooming it. The contextual menu is accessed using right-click under Windows or Ctrl-click on the Macintosh.

In Flash 6, the following menu items are available when showMenu is true:

Zoom In
Zoom Out
100%
Show All
Quality
Play
Loop
Rewind
Forward
Back
Settings...
Print...
About Macromedia Flash Player 6

The following items are available when showMenu is false:

Settings...
About Macromedia Flash Player 6

In both cases, the Settings option leads to the Settings dialog box, where the user can set the SharedObject disk space limit and configure her camera and microphone.

There is no built-in way to disable the Flash Player's contextual menu entirely. However, several third-party tools can remove the menu from the Standalone Player. See:

http://www.flashjester.com/software/jugglor/ and http://www.northcode.com/studio/

When a movie is embedded in a web page, the OBJECT or EMBED tag can also set the value of showMenu; any assignment in ActionScript overrides the HTML setting.

Usage

In Flash versions 3 through 5, showMenu must be set via fscommand( ), such as fscommand ("showMenu", "false").

Example

// Reduces the contextual menu to minimal items Stage.showMenu = false;


    ActionScript for Flash MX. The Definitive Guide
    ActionScript for Flash MX: The Definitive Guide, Second Edition
    ISBN: 059600396X
    EAN: 2147483647
    Year: 2002
    Pages: 780
    Authors: Colin Moock

    flylib.com © 2008-2017.
    If you may any questions please contact us: flylib@qtcs.net