document.changeFilterOrder()

Availability

Flash 8.

Usage

document.changeFilterOrder(oldIndex, newIndex)

Parameters

oldIndex An integer that represents the current zero-based index position of the filter you want to reposition in the Filters list.

newIndex An integer that represents the new index position of the filter in the list.

Returns

Nothing.

Description

Method; changes the index of the filter in the Filter list. Any filters above or below newIndex are shifted up or down accordingly. For example, using the filters shown below, if you issue the command fl.getDocumentDOM().changeFilterOrder(3, 0), the filters are rearranged as follows:

Before: blurFilter, dropShadowFilter, glowFilter, gradientBevelFilter

After: gradientBevelFilter, blurFilter, dropShadowFilter, glowFilter

If you then issue the command fl.getDocumentDOM().changeFilterOrder(0, 2), the filters are rearranged as follows:

Before: gradientBevelFilter, blurFilter, dropShadowFilter, glowFilter

After: blurFilter, dropShadowFilter, gradientBevelFilter, glowFilter

Example

The following example moves the filter that is currently in the second position in the Filter list to the first position:

fl.getDocumentDOM().changeFilterOrder(1,0);