| Package | mx.effects |
| Class | public class DefaultTileListEffect |
| Inheritance | DefaultTileListEffect  Parallel CompositeEffect Effect EventDispatcher Object |
You use the itemsChangeEffect style property to apply
this effect to a TileList control. The default value of
the itemsChangeEffect style property is undefined,
meaning it does not use any effect.
You typically set the TileList.offscreenExtraRowsOrColumns property
when applying a data effect. Typically, you set TileList.offscreenExtraRowsOrColumns
to a small even number, such as 2, for a TileList control.
Hide MXML SyntaxThe <mx:DefaultTileListEffect> tag inherits all the members of its parent and adds the following members:
Show MXML Syntax
<DefaultTileListEffect
Properties
color="0xFFFFFF"
fadeInDuration="350"
fadeOutDuration="350"
moveDuration="300"
/>
See also
| Property | Defined By | ||
|---|---|---|---|
 | className : String [read-only]
The name of the effect class, such as "Fade". | Effect | |
| color : Number
Hex value that represents the color used when fading
the added and removed item. | DefaultTileListEffect | ||
| constructor : Object
A reference to the class object or constructor function for a given object instance. | Object | |
| fadeInDuration : Number
The duration in milliseconds
used to fade in renderers for added and removed items. | DefaultTileListEffect | ||
| fadeOutDuration : Number
The duration in milliseconds used to
fade out renderers for removed and replaced items. | DefaultTileListEffect | ||
| hideFocusRing : Boolean
Determines whether the effect should hide the focus ring
when starting the effect. | Effect | |
| instanceClass : Class
An object of type Class that specifies the effect
instance class class for this effect class. | Effect | |
| isPlaying : Boolean [read-only]
A read-only flag which is true if any instances of the effect
are currently playing, and false if none are. | Effect | |
| moveDuration : Number
The duration in milliseconds
applied to renderers for items moved in the control
as part of the effect. | DefaultTileListEffect | ||
| prototype : Object [static]
A reference to the prototype object of a class or function object. | Object | |
| relevantProperties : Array
An Array of property names to use when performing filtering. | Effect | |
| relevantStyles : Array
An Array of style names to use when performing filtering. | Effect | |
| startDelay : int = 0
Amount of time, in milliseconds, to wait before starting the effect. | Effect | |
| suspendBackgroundProcessing : Boolean = false
If true, blocks all background processing
while the effect is playing. | Effect | |
| triggerEvent : Event
The Event object passed to this Effect
by the EffectManager when an effect is triggered,
or null if the effect is not being
played by the EffectManager. | Effect | |
| color | property |
color:NumberHex value that represents the color used when fading the added and removed item.
The default value is 0xFFFFFF.
public function get color():Number public function set color(value:Number):void| fadeInDuration | property |
fadeInDuration:NumberThe duration in milliseconds used to fade in renderers for added and removed items.
The default value is 350.
public function get fadeInDuration():Number public function set fadeInDuration(value:Number):void| fadeOutDuration | property |
fadeOutDuration:NumberThe duration in milliseconds used to fade out renderers for removed and replaced items.
The default value is 350.
public function get fadeOutDuration():Number public function set fadeOutDuration(value:Number):void| moveDuration | property |
moveDuration:NumberThe duration in milliseconds applied to renderers for items moved in the control as part of the effect.
The default value is 300.
public function get moveDuration():Number public function set moveDuration(value:Number):void<?xml version="1.0"?>
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml">
<mx:Script>
<![CDATA[
import mx.effects.DefaultTileListEffect;
import mx.effects.easing.Elastic;
import mx.collections.ArrayCollection;
import mx.effects.Move;
[Bindable]
private var myDP:ArrayCollection = new ArrayCollection(
['A','B','C','D','E','F','G','H','I','J','K','L','M','N','O','P']);
private function deleteItems():void {
// As each item is removed, the index of the other items changes.
// So first get the items to delete, then determine their indices
// as you remove them.
var toRemove:Array = [];
for (var i:int = 0; i < tlist0.selectedItems.length; i++)
toRemove.push(tlist0.selectedItems[i]);
for (i = 0; i < toRemove.length; i++)
myDP.removeItemAt(myDP.getItemIndex(toRemove[i]));
}
private var zcount:int = 0;
private function addItems():void {
myDP.addItemAt("Z"+zcount++,Math.min(2,myDP.length));
}
]]>
</mx:Script>
<!-- Define an instance of the DefaultTileListEffect effect,
and set its moveDuration and color properties. -->
<mx:DefaultTileListEffect id="myDTLE"
moveDuration="100"
color="0x0000ff"/>
<mx:Panel title="DefaultTileListEffect Example" width="75%" height="75%"
paddingTop="10" paddingLeft="10" paddingRight="10" paddingBottom="10">
<mx:TileList id="tlist0"
height="100%" width="100%"
columnCount="4" rowCount="4"
fontSize="18" fontWeight="bold"
direction="horizontal"
dataProvider="{myDP}"
allowMultipleSelection="true"
offscreenExtraRowsOrColumns="2"
itemsChangeEffect="{myDTLE}" />
<mx:Button
label="Delete selected item(s)"
click="deleteItems();"/>
<mx:Button
label="Add item"
click="addItems();"/>
</mx:Panel>
</mx:Application>
