Packagemx.core
Interfacepublic interface IInvalidating
Implementors GraphicElement, UIComponent, UITextField

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

The IInvalidating interface defines the interface for components that use invalidation to do delayed -- rather than immediate -- property commitment, measurement, drawing, and layout.



Public Methods
 MethodDefined By
  
Calling this method results in a call to the component's validateDisplayList() method before the display list is rendered.
IInvalidating
  
Calling this method results in a call to the component's validateProperties() method before the display list is rendered.
IInvalidating
  
Calling this method results in a call to the component's validateSize() method before the display list is rendered.
IInvalidating
  
Validates and updates the properties and layout of this object by immediately calling validateProperties(), validateSize(), and validateDisplayList(), if necessary.
IInvalidating
Method Detail
invalidateDisplayList()method
public function invalidateDisplayList():void

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

Calling this method results in a call to the component's validateDisplayList() method before the display list is rendered.

For components that extend UIComponent, this implies that updateDisplayList() is called.

invalidateProperties()method 
public function invalidateProperties():void

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

Calling this method results in a call to the component's validateProperties() method before the display list is rendered.

For components that extend UIComponent, this implies that commitProperties() is called.

invalidateSize()method 
public function invalidateSize():void

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

Calling this method results in a call to the component's validateSize() method before the display list is rendered.

For components that extend UIComponent, this implies that measure() is called, unless the component has both explicitWidth and explicitHeight set.

validateNow()method 
public function validateNow():void

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

Validates and updates the properties and layout of this object by immediately calling validateProperties(), validateSize(), and validateDisplayList(), if necessary.

When properties are changed, the new values do not usually have an immediate effect on the component. Usually, all of the application code that needs to be run at that time is executed. Then the LayoutManager starts calling the validateProperties(), validateSize(), and validateDisplayList() methods on components, based on their need to be validated and their depth in the hierarchy of display list objects.

For example, setting the width property is delayed, because it may require recalculating the widths of the object's children or its parent. Delaying the processing also prevents it from being repeated multiple times if the application code sets the width property more than once. This method lets you manually override this behavior.