Apache Flex 4.16.0 API Reference | All Packages | All Classes | Index | Frames No Frames |
SetStyle

Package | mx.states
Class | public class SetStyle
Inheritance | SetStyle OverrideBase OnDemandEventDispatcher Object

Language Version : | ActionScript 3.0

Product Version : | Flex 3

Runtime Versions : | Flash Player 9, AIR 1.1

The SetStyle class specifies a style that is in effect only during the parent view state. You use this class in the `overrides` property of the State class.

MXML Syntax Show MXML Syntax
Hide MXML Syntax

The `<mx:SetStyle>` tag has the following attributes:

      <mx:SetStyle
       Properties
       name="null"
       target="null"
       value"null"
      />

See also

mx.states.State
mx.states.SetEventHandler
mx.states.SetProperty
mx.effects.SetStyleAction

Public Properties

| Property | Defined By
--- | --- | ---
|  | name : String The name of the style to change. | SetStyle
|  | target : Object The object whose style is being changed. | SetStyle
|  | value : Object The new value for the style. | SetStyle
|  | valueFactory : IDeferredInstance [write-only] An optional write-only property from which to obtain a shared value. | SetStyle

Public Methods
Hide Inherited Public Methods
Show Inherited Public Methods

| Method | Defined By
--- | --- | ---
|  | SetStyle(target:IStyleClient = null, name:String = null, value:Object = null, valueFactory:IDeferredInstance = null) Constructor. | SetStyle
|  | addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void | OnDemandEventDispatcher
|  | apply(parent:UIComponent):void [override] Applies the override. | SetStyle
|  | dispatchEvent(event:Event):Boolean | OnDemandEventDispatcher
|  | hasEventListener(type:String):Boolean | OnDemandEventDispatcher
|  | initialize():void IOverride interface method; this class implements it as an empty method. | OverrideBase
|  | remove(parent:UIComponent):void [override] Removes the override. | SetStyle
|  | removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void | OnDemandEventDispatcher
|  | willTrigger(type:String):Boolean | OnDemandEventDispatcher

Property Detail

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 to change. You must set this property, either in the SetStyle constructor or by setting the property value directly.

target | property |

`public var target:Object`

Language Version : | ActionScript 3.0

Product Version : | Flex 3

Runtime Versions : | Flash Player 9, AIR 1.1

The object whose style is being changed. If the property value is `null`, Flex uses the immediate parent of the State object.

The default value is `null`.

value | property |

`value:Object`

Language Version : | ActionScript 3.0

Product Version : | Flex 3

Runtime Versions : | Flash Player 9, AIR 1.1

The new value for the style.

The default value is `undefined`.

Implementation
`public function get value():Object`
`public function set value(value:Object):void`

valueFactory | property |

`valueFactory:IDeferredInstance` [write-only]

Language Version : | ActionScript 3.0

Product Version : | Flex 4

Runtime Versions : | Flash Player 9, AIR 1.1

An optional write-only property from which to obtain a shared value. This is primarily used when this override's value is shared by multiple states or state groups.

The default value is `undefined`.

Implementation
`public function set valueFactory(value:IDeferredInstance):void`
Constructor Detail

SetStyle | () | Constructor

`public function SetStyle(target:IStyleClient = null, name:String = null, value:Object = null, valueFactory:IDeferredInstance = null)`

Language Version : | ActionScript 3.0

Product Version : | Flex 3

Runtime Versions : | Flash Player 9, AIR 1.1

Constructor.

Parameters

| `target:IStyleClient` (default = `null`)`` — The object whose style is being set. By default, Flex uses the immediate parent of the State object.
| `name:String` (default = `null`)`` — The style to set.
| `value:Object` (default = `null`)`` — The value of the style in the view state.
| `valueFactory:IDeferredInstance` (default = `null`)`` — An optional write-only property from which to obtain a shared value. This is primarily used when this override's value is shared by multiple states or state groups.

Method Detail

apply | () | method

`override public function apply(parent:UIComponent):void`

Language Version : | ActionScript 3.0

Product Version : | Flex 3

Runtime Versions : | Flash Player 9, AIR 1.1

Applies the override. Flex retains the original value, so that it can restore the value later in the `remove()` method.

This method is called automatically when the state is entered. It should not be called directly.

Parameters

| `parent:UIComponent` — The parent of the state object containing this override. The override should use this as its target if an explicit target was not specified.

remove | () | method |

`override public function remove(parent:UIComponent):void`

Language Version : | ActionScript 3.0

Product Version : | Flex 3

Runtime Versions : | Flash Player 9, AIR 1.1

Removes the override. The value remembered in the `apply()` method is restored.

This method is called automatically when the state is entered. It should not be called directly.

Parameters

| `parent:UIComponent` — The parent of the state object containing this override. The override should use this as its target if an explicit target was not specified.

Sun Mar 5 2017, 03:42 PM +11:00