mx.core

# IInvalidating - AS3 Flex

Package | mx.core
Interface | public interface IInvalidating
Implementors | GraphicElement, PostScaleAdapter, ProgrammaticSkin, UIComponent, UIFTETextField, 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

| Method | Defined By
--- | --- | ---
|  | invalidateDisplayList():void Calling this method results in a call to the component's validateDisplayList() method before the display list is rendered. | IInvalidating
|  | invalidateProperties():void Calling this method results in a call to the component's validateProperties() method before the display list is rendered. | IInvalidating
|  | invalidateSize():void Calling this method results in a call to the component's validateSize() method before the display list is rendered. | IInvalidating
|  | validateNow():void 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.

© 2015 Adobe Systems Incorporated. All rights reserved.
Mon Apr 10 2017, 12:28 PM -07:00