Flag to mark a dirty displaylist. It basically means it is waiting for a call to updateDisplayList at some point

The height set in terms of actual pixels. You do not call this function in your code. Setting the width of the control to an actual numeric value (rather than percent) calls this function Call this function only if you want to set width without calling the invalidation methods [TODO] This class should have namespace access control (pyro_internal)

Set/get the height of the control. If the height is set to a different value from the one the control is already at, it triggers the size invalidation cycle

Specifies whether this control participates in the layout system in OpenPyro. For example if you have 3 UIControls sitting in a container with a HLayout layout, but the second control as the includeInLayout property set to false, the layout will not position that control.

Property indicates whether a control has been initialized or not. Initialization happens the first time the control is added to the parent.

Set the measured height of the control. This is usually set by the same control's measure() function. If the measuredHeight is changed, the displayList is invalidated

Returns the measured width after the control has been measured. Note this value will return NaN if the control is explicitly sized by setting the explicitWidth property

Only setting percent width/heights changes the needsMeasurement flag which makes its parent container call measure on it. If width and height are set directly, measurement is never called (although size invalidation still does if size has changed)

Set/get the percent height. If the value is different from the earlier, it sets the measurement flag and calls invalidateSize

Set/get the percent width. If the value is different from the earlier, it sets the measurement flag and calls invalidateSize

The flag to mark that the control's size has been invalidated. This means the control is now waiting for a validateSize call.

This property defines whether measure() will be called during validateSize() or not.

Set/get the width of the control. If the width is set to a different value from the one the control is already at, it triggers the size invalidation cycle

Calculates the measuredHeight property.

Calculates the measuredWidth property.

Calls the queueValidateDisplayList if measure causes _dimensionsChanged to change to true. UIControl overrides this with a call to doChildBasedValidation which then goes and checks if the size of the children affects the size of the control.

This is where the new children should be created and then added to the displaylist. Similar to Flex's createChildren() method.

Dispatches the UpdateComplete event

[Temp] This function is called automatically by a parent UIControl if this is created as a child of a UIControl. Else you have to call this function for now.

doQueueValidateSize is executed by the top level UIControl.

Returns the explicitly defined height or the measured height computed by the measure function.

Returns the explicitly defined width or the measured number computed by the measure function.

This happens only once when a child is first added to any parent. Subsequent removeChild and addChild actions do not trigger this function but rather directly call validateSize.

Marks itself dirty and waits till either the container to validateSize or validates itself at the next enterframe if it has no parent container. This method is overridden by UIControl. The code here will only be useful for a Spacer type of component.

Utility function to check if a mouseEvent happened while the mouse was over the displayObject

Measure is called during the validateSize if the needsmeasurement flag is set. At this point, new measured width/heights are calculated. If these values are different from the values previously calculated, the resizeHandler is queued for the next enterframe

The event listener executed when this component has been added to the parent.

This function is called if the framework determines that dimensions of the control have changed. This determination is made during the validateSize() function. If this control is the top level OpenPyro control, it will validate the displaylist in the next enter frame, otherwise it just dispatches the size changed event and waits till the validateDisplaylist is called.

The updateDisplayList is triggered everytime the framework determines that some event has taken place that needs the UI to be refreshed.

validateDisplayList is called as a response to invalidateDisplayList.

The validateSize function is called in response to a component declaring its size invalid (usually by calling invalidateSize()). The job of this method is to compute the final width and height (whether by calling measure if an explicit w/h is not declared or not if an explicit w & h is declared)

See also