setPref()
537
Description
Flash sprite command; invokes the Flash Settings dialog box to the specified panel index. This is
the same dialog box that can be opened by right-clicking (Windows) or Control-clicking
(Macintosh) on a Flash movie playing in a browser.
The Settings dialog box will not be displayed if the Flash sprite’s rectangle is not large enough to
accommodate it.
If you want to emulate the Flash Player by invoking the Settings dialog box when a user right-
clicks (Windows) or Control-clicks (Macintosh), you can use this command in a
mouseDown
handler that tests for the
rightMouseDown
property or the
controlDown
property.
In order to emulate the Flash Player by enabling the Settings dialog box in a Director movie
running in a browser, you must first disable the Shockwave Player context menu that is available
by right-clicking (Windows) or Control-clicking (Macintosh) on a movie with Shockwave
content playing in a browser. For information on how to disable this menu, see the Using
Director topics in the Director Help Panel.
Parameters
integerPanelIndex
Optional. Specifies which panel to activate when the dialog box is opened.
Valid values are 0, 1, 2, or 3. A value of 0 opens the dialog box showing the Privacy tab, a value of
1 opens it showing the Local Storage tab, a value of 2 opens it showing the Microphone tab, and
a value of 3 opens it showing the Camera tab. The default panel index is 0.
Example
This statement opens the Flash Settings panel with the Local Storage tab active:
-- Lingo syntax
sprite(3).settingsPanel(1)
// JavaScript syntax
sprite(3).settingsPanel(1);
See also
on mouseDown (event handler)
,
rightMouseDown
,
controlDown
setPref()
Usage
-- Lingo syntax
_player.setPref(
stringPrefName
,
prefString
)
// JavaScript syntax
_player.setPref(
stringPrefName
,
prefString
);
Description
Player method; writes the string specified by
prefString
in the file specified by
stringPrefName
on the computer’s local disk.
The
stringPrefName
argument must be a valid filename. To make sure the filename is valid on
all platforms, use no more than eight alphanumeric characters for the file name.
After the
setPref()
method runs, if the movie is playing in a browser, a folder named Prefs is
created in the Plug-In Support folder. The
setPref()
method can write only to that folder.
Summary of Contents for DIRECTOR MX 2004
Page 1: ...DIRECTOR MX 2004 Director Scripting Reference...
Page 48: ...48 Chapter 2 Director Scripting Essentials...
Page 100: ...100 Chapter 4 Debugging Scripts in Director...
Page 118: ...118 Chapter 5 Director Core Objects...
Page 594: ...594 Chapter 12 Methods...
Page 684: ...684 Chapter 14 Properties See also DVD...
Page 702: ...702 Chapter 14 Properties See also face vertices vertices flat...
Page 856: ...856 Chapter 14 Properties JavaScript syntax sprite 15 member member 3 4...
Page 1102: ...1102 Chapter 14 Properties...