| Package | mx.effects |
| Class | public class SetStyleAction |
| Inheritance | SetStyleAction Effect EventDispatcher Object |
| Language Version: | ActionScript 3.0 |
| Product Version: | Flex 3 |
| Runtime Versions: | Flash Player 9, AIR 1.1 |
SetStyle property occurs during the transition.
MXML Syntax
Hide MXML SyntaxThe <mx:SetStyleAction> tag
inherits all of the tag attributes of its superclass,
and adds the following tag attributes:
<mx:SetStyleAction
Properties
id="ID"
style=""
value=""
/>
Learn more
Related API Elements
| Property | Defined By | ||
|---|---|---|---|
![]() | className : String [read-only]
The name of the effect class, such as "Fade". | Effect | |
![]() | constructor : Object
A reference to the class object or constructor function for a given object instance. | Object | |
![]() | customFilter : mx.effects:EffectTargetFilter
Specifies a custom filter object, of type EffectTargetFilter,
used by the effect to determine the targets
on which to play the effect. | Effect | |
![]() | effectTargetHost : mx.effects:IEffectTargetHost
A property that lets you access the target list-based control
of a data effect. | Effect | |
![]() | filter : String
Specifies an algorithm for filtering targets for an effect. | Effect | |
![]() | 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 | |
| name : String
The name of the style property being changed. | SetStyleAction | ||
![]() | perElementOffset : Number
Additional delay, in milliseconds, for effect targets
after the first target of the effect. | Effect | |
![]() | playheadTime : Number
Current time position of the effect. | Effect | |
![]() | 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 [override]
Contains the style properties modified by this effect. | SetStyleAction | ||
![]() | repeatCount : int = 1
Number of times to repeat the effect. | Effect | |
![]() | repeatDelay : int = 0
Amount of time, in milliseconds, to wait before repeating the effect. | 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 | |
![]() | target : Object
The object to which this effect is applied. | Effect | |
![]() | targets : Array
An Array of objects that are targets for the effect. | 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 | |
| value : *
The new value for the style property. | SetStyleAction | ||
| Method | Defined By | ||
|---|---|---|---|
SetStyleAction(target:Object = null)
Constructor. | SetStyleAction | ||
![]() | addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registers an event listener object with an EventDispatcher object so that the listener
receives notification of an event. | EventDispatcher | |
![]() |
Captures the current values of the relevant properties
on the effect's targets and saves them as end values. | Effect | |
![]() |
Captures the current values of the relevant properties
of an additional set of targets
Flex uses this function when a data change
effect is run.
| Effect | |
![]() |
Captures the current values of the relevant properties
on the effect's targets. | Effect | |
![]() |
Creates a single effect instance and initializes it. | Effect | |
![]() |
Takes an Array of target objects and invokes the
createInstance() method on each target. | Effect | |
![]() |
Removes event listeners from an instance
and removes it from the list of instances. | Effect | |
![]() |
Dispatches an event into the event flow. | EventDispatcher | |
![]() |
Interrupts an effect that is currently playing,
and jumps immediately to the end of the effect. | Effect | |
![]() |
Returns an Array of Strings, where each String is the name
of a property changed by this effect. | Effect | |
![]() |
Checks whether the EventDispatcher object has any listeners registered for a specific type
of event. | EventDispatcher | |
![]() |
Indicates whether an object has a specified property defined. | Object | |
![]() |
Indicates whether an instance of the Object class is in the prototype chain of the object specified
as the parameter. | Object | |
![]() |
Pauses the effect until you call the resume() method. | Effect | |
![]() |
Begins playing the effect. | Effect | |
![]() |
Indicates whether the specified property exists and is enumerable. | Object | |
![]() |
Removes a listener from the EventDispatcher object. | EventDispatcher | |
![]() |
Resumes the effect after it has been paused
by a call to the pause() method. | Effect | |
![]() |
Plays the effect in reverse, if the effect is currently playing,
starting from the current position of the effect. | Effect | |
![]() |
Sets the availability of a dynamic property for loop operations. | Object | |
![]() |
Stops the effect, leaving the effect targets in their current state. | Effect | |
![]() |
Returns the string representation of this object, formatted according to locale-specific conventions. | Object | |
![]() |
Returns the string representation of the specified object. | Object | |
![]() |
Returns the primitive value of the specified object. | Object | |
![]() |
Checks whether an event listener is registered with this EventDispatcher object or any of
its ancestors for the specified event type. | EventDispatcher | |
name | property |
public var name:String| Language Version: | ActionScript 3.0 |
| Product Version: | Flex 3 |
| Runtime Versions: | Flash Player 9, AIR 1.1 |
The name of the style property being changed.
By default, Flex determines this value from the SetStyle
property definition in the view state definition.
relevantStyles | property |
relevantStyles:Array[override] | Language Version: | ActionScript 3.0 |
| Product Version: | Flex 3 |
| Runtime Versions: | Flash Player 9, AIR 1.1 |
Contains the style properties modified by this effect. This getter method overrides the superclass method.
If you create a subclass of this class to create a custom effect, you must override this method and return an Array that contains a list of the style properties modified by your subclass.
Implementation
override public function get relevantStyles():Array override public function set relevantStyles(value:Array):voidRelated API Elements
value | property |
public var value:*| Language Version: | ActionScript 3.0 |
| Product Version: | Flex 3 |
| Runtime Versions: | Flash Player 9, AIR 1.1 |
The new value for the style property.
By default, Flex determines this value from the SetStyle
property definition in the view state definition.
SetStyleAction | () | Constructor |
<?xml version="1.0" ?>
<!-- Simple example to demonstrate the Transition class. -->
<s:Application xmlns:fx="http://ns.adobe.com/mxml/2009"
xmlns:s="library://ns.adobe.com/flex/spark"
xmlns:mx="library://ns.adobe.com/flex/mx" currentState="Login">
<!-- Define the view states -->
<s:states>
<s:State name="Login" />
<s:State name="Register" />
</s:states>
<s:transitions>
<!-- Define the transition from the base state to the Register state.-->
<s:Transition id="toRegister" fromState="*" toState="Register">
<s:Sequence targets="{[loginPanel, registerLink, confirm, loginLink]}">
<s:RemoveAction />
<s:Fade />
<s:SetAction target="{loginPanel}" property="title" />
<s:SetAction target="{loginButton}" property="label" />
<s:SetAction target="{loginButton}" property="color" />
<s:Resize target="{loginPanel}"/>
<s:AddAction />
<s:Fade />
</s:Sequence>
</s:Transition>
<!-- Define the transition from the Register state to the base state.-->
<s:Transition id="toDefault" fromState="Register" toState="*">
<s:Sequence targets="{[loginPanel, registerLink,
confirm, loginLink]}">
<s:RemoveAction/>
<s:SetAction target="{loginPanel}" property="title"/>
<s:SetAction target="{loginButton}" property="label"/>
<s:SetAction target="{loginButton}" property="color"/>
<s:Resize target="{loginPanel}"/>
<s:AddAction/>
</s:Sequence>
</s:Transition>
</s:transitions>
<!-- Define a Panel container that defines the login form. The title of the Panel
changes depending on the state. -->
<s:Panel title="Login" title.Register="Register" id="loginPanel"
width="75%" horizontalCenter="0" verticalCenter="0">
<s:controlBarLayout >
<s:BasicLayout />
</s:controlBarLayout>
<s:layout>
<s:VerticalLayout paddingTop="10" paddingBottom="10" paddingRight="10" paddingLeft="10" />
</s:layout>
<s:Label color="blue" width="100%"
text="Click the 'Need to Register?' link to change state. Click the 'Return to Login' link to return to the base state."/>
<!-- The following form has two TextInputs in the Login state and three TextInputs
in the Register state. -->
<s:Form id="loginForm" >
<s:FormItem label="Username:">
<s:TextInput/>
</s:FormItem>
<s:FormItem label="Password:">
<s:TextInput/>
</s:FormItem>
<s:FormItem id="confirm" label="Confirm:" includeIn="Register" includeInLayout="false" includeInLayout.Register="true">
<s:TextInput/>
</s:FormItem>
</s:Form>
<!-- The controlBar includes two visible items in each state. Which LinkButton is visible is determined
by the state -->
<s:controlBarContent>
<mx:LinkButton id="registerLink" label="Need to Register?" top="10" bottom="10"
click="currentState='Register'" left="10" includeIn="Login" />
<mx:LinkButton id="loginLink" label="Return to Login" click="currentState=''" includeIn="Register" left="10" top="10" bottom="10"/>
<s:Button label="Login" label.Register="Register" id="loginButton" right="10" color.Register="0x0000FF" top="10" bottom="10"/>
</s:controlBarContent>
</s:Panel>
</s:Application>
Mon Nov 28 2011, 06:48 AM -08:00
Show MXML Syntax