User Guide

592 FLVPlayback Component (Flash Professional Only)
FLVPlayback.findNextCuePointWithName()
Availability
Flash Player 8.
Edition
Flash Professional 8.
Usage
my_FLVplybk.findNextCuePointWithName(my_cuePoint:Object)
Parameters
my_cuePoint A cue point object that has been returned by either the findCuePoint()
method, the
findNearestCuePoint() method, or a previous call to this method.
Returns
An object that is a copy of the found cue point object with the following additional
properties:
array The array of cue points searched. Treat this array as read-only because adding,
removing or editing objects within it can cause cue points to malfunction.
index The index into the array for the returned cue point.
Returns
null if no match was found.
Description
Method; finds the next cue point in my_cuePoint.array that has the same name as
my_cuePoint.name. The my_cuePoint object must be a cue point object that has been
returned by the
findCuePoint() method, the findNearestCuePoint() method, or a
previous call to this method. This method uses the
array property that these methods add to
the cue point object.
The method includes disabled cue points in the search. Use the
isFLVCuePointEnabled()
method to determine if a cue point is disabled.
Returns
null if there are no more cue points in the array with a matching name.
Example
The following example creates three ActionScript cue points with the name "transition".
When the
ready event occurs, the event handler calls the findCuePoint() method to find
the first cue point with this name. If it finds a match, it calls the
findNextName() function,
which calls the
findNextCuePointWithName() method, passing the returned cue point
object (
rtn_obj), to find any additional cue points with the same name.