E-merald web-engineering Flash components
E-merald web-engineering Contact Site map
 
Home Components Support Purchase
Components

ActionScript Documentation

InheritanceMovieClip > ScreenBannerRotator class

Methods unique to the ScreenBannerRotator class

The following table lists methods of the ScreenBannerRotator class.

Method Description
ScreenBannerRotator.gotoImageAt() Navigates to the image with the specified index.
ScreenBannerRotator.gotoNextImage() Navigates to the next image in the gallery.
ScreenBannerRotator.gotoPreviousImage() Navigates to the previous image in the gallery.

Properties unique to the ScreenBannerRotator class

The following table lists properties of the ScreenBannerRotator class.

Property Description
ScreenBannerRotator.autoPlay Specifies whether or not the banner should start rotating images automatically.
ScreenBannerRotator.controlsAutoHide Determines whether to show (hide) the controls automatically when the mouse is over (out of) the banner.
ScreenBannerRotator.controlsOrder Specifies which navigation buttons to show in the controls, and defines the order in which the buttons are displayed.
ScreenBannerRotator.delayTime Amount of delay between images, in seconds.
ScreenBannerRotator.pauseOnMouseOver Specifies whether or not the banner should pause rotating images when the mouse is over its area.
ScreenBannerRotator.randomImages Determines whether to display images in sequential or random order.
ScreenBannerRotator.randomTransitions Determines whether to apply transition types in sequential or random order.
ScreenBannerRotator.repeatMode Defines the banner behavior when it reaches the last image.
ScreenBannerRotator.showControls Determines if the controls are visible.
ScreenBannerRotator.showControlsScreen Determines whether or not to show the background (screen) of the controls.
ScreenBannerRotator.showDescription Determines if the description area is visible.
ScreenBannerRotator.showNumberButtons Determines whether or not to show the number buttons in the controls.
ScreenBannerRotator.transitionType The type of transition to be applied when rotating images.
ScreenBannerRotator.xmlFileURL The path to the XML file.

ScreenBannerRotator.autoPlay

Usage

my_banner.autoPlay

Description

Property; specifies whether the banner should start rotating images automatically ("true") or not ("false"). The default value is "false".

Example

The following example sets the autoPlay property to "true":

my_banner.autoPlay = true;


ScreenBannerRotator.controlsAutoHide

Usage

my_banner.controlsAutoHide

Description

Property; determines whether to show (hide) the controls automatically when the mouse is over (out of) the banner. The default value is "false".

Example

The following example sets the controlsAutoHide property to "true":

my_banner.controlsAutoHide = true;


ScreenBannerRotator.controlsOrder

Usage

my_banner.controlsOrder

Description

Property; specifies which navigation buttons to show in the controls, and defines the order in which the buttons are displayed (separated by commas). This property can be any combination of the following values: "playpause", "previous", "next", "timer". The default value is undefined.

Example

The following example sets the controlsOrder property to "playpause,timer":

my_banner.controlsOrder = "playpause,timer";


ScreenBannerRotator.delayTime

Usage

my_banner.delayTime

Description

Property; amount of delay between images, in seconds. This property can be any positive number or 0. The default value is 5.

Example

The following example sets the delayTime property to 3:

my_banner.delayTime = 3;


ScreenBannerRotator.gotoImageAt()

Usage

my_banner.gotoImageAt(index)

Parameters

index   An integer indicating the index of the image in the gallery. This is a zero-based index, so 0 retrieves the first image, 1 retrieves the second image, and so on.

Returns

Nothing.

Description

Method; navigates to the image with the specified index.

Example

The following example demonstrates how to navigate to the image with index 5:

my_banner.gotoImageAt(5);


ScreenBannerRotator.gotoNextImage()

Usage

my_banner.gotoNextImage()

Returns

Nothing.

Description

Method; navigates to the next image in the gallery.

Example

The following example demonstrates how to navigate to the next image in the gallery:

my_banner.gotoNextImage();


ScreenBannerRotator.gotoPreviousImage()

Usage

my_banner.gotoPreviousImage()

Returns

Nothing.

Description

Method; navigates to the previous image in the gallery.

Example

The following example demonstrates how to navigate to the previous image in the gallery:

my_banner.gotoPreviousImage();


ScreenBannerRotator.pauseOnMouseOver

Usage

my_banner.pauseOnMouseOver

Description

Property; specifies whether the banner should pause rotating images when the mouse is over its area ("true") or not ("false"). The default value is "false".

Example

The following example sets the pauseOnMouseOver property to "true":

my_banner.pauseOnMouseOver = true;


ScreenBannerRotator.randomImages

Usage

my_banner.randomImages

Description

Property; determines whether to display images in sequential ("false") or random ("true") order. The default value is "false".

Example

The following example sets the randomImages property to "true":

my_banner.randomImages = true;


ScreenBannerRotator.randomTransitions

Usage

my_banner.randomTransitions

Description

Property; determines whether to apply transition types (if multiple values are selected) in sequential ("false") or random ("true") order. The default value is "true".

Example

The following example sets the randomTransitions property to "false":

my_banner.randomTransitions = false;


ScreenBannerRotator.repeatMode

Usage

my_banner.repeatMode

Description

Property; defines the banner behavior when it reaches the last image. This property can be either "true" or "false". The default value is "true".

Example

The following example sets the repeatMode property to "false":

my_banner.repeatMode = false;


ScreenBannerRotator.showControls

Usage

my_banner.showControls

Description

Property; determines if the controls are visible. The default value is "true".

Example

The following example sets the showControls property to "false":

my_banner.showControls = false;


ScreenBannerRotator.showControlsScreen

Usage

my_banner.showControlsScreen

Description

Property; determines whether to show the background (screen) of the controls ("true") or not ("false"). The default value is "true".

Example

The following example sets the showControlsScreen property to "false":

my_banner.showControlsScreen = false;


ScreenBannerRotator.showDescription

Usage

my_banner.showDescription

Description

Property; determines if the description area is visible. The default value is "true".

Example

The following example sets the showDescription property to "false":

my_banner.showDescription = false;


ScreenBannerRotator.showNumberButtons

Usage

my_banner.showNumberButtons

Description

Property; determines whether to show the number buttons in the controls ("true") or not ("false"). The default value is "true".

Example

The following example sets the showNumberButtons property to "false":

my_banner.showNumberButtons = false;


ScreenBannerRotator.transitionType

Usage

my_banner.transitionType

Description

Property; specifies the type of transition to be applied when rotating images. Multiple values should be separated by commas, without blank space after commas. This property can be any combination of the following values: "fade", "blinds", "windows". The default value is "fade,blinds,windows".

Example

The following example sets the transitionType property to "fade,blinds":

my_banner.transitionType = "fade,blinds";


ScreenBannerRotator.xmlFileURL

Usage

my_banner.xmlFileURL

Description

Property; the path to the XML file. The default value is "settings.xml".

Example

The following example sets the xmlFileURL property to "data/banner.xml":

my_banner.xmlFileURL = "data/banner.xml";


© E-MERALD. All rights reserved.
© Designed by Fox.net.ua.