Difference between revisions of "SHIP:Property:box:over"

From Serious Documentation
Jump to: navigation, search
Line 11: Line 11:
  
 
The property will transition {{Reserved|true}} when the touchscreen is pressed inside the {{Node|box}}, whether this is a new touch down event or the finger/stylus is already pressed and moves into the {{Node|box}}.  The property will go {{Reserved|false}} when the touchscreen is release or the pressed finger/stylus moves outside the outer bounds of the {{Node|box}}.
 
The property will transition {{Reserved|true}} when the touchscreen is pressed inside the {{Node|box}}, whether this is a new touch down event or the finger/stylus is already pressed and moves into the {{Node|box}}.  The property will go {{Reserved|false}} when the touchscreen is release or the pressed finger/stylus moves outside the outer bounds of the {{Node|box}}.
 +
 +
If the any {{Node|displayable}} parent node's {{Prop|displayable|visible}} property goes {{Reserved|false}} while {{Prop|box|over}} is {{Reserved|true}}, the {{Prop|box|over}} property will transition to {{Reserved|false}} immediately ''before'' the {{Node|box}} is made invisible, hence {{Node|listener}}s to {{Node|box}}.{{Prop|page|over}} ''will'' receive this transition-to-{{Reserved|false}} event.
 +
 +
If the any {{Node|layoutarea|layout area}} parent node's {{Prop|layoutarea|enabled}} property goes {{Reserved|false}} while {{Prop|box|over}} is {{Reserved|true}}, the {{Prop|box|over}} property will transition to {{Reserved|false}} ''afterwards'', hence any {{Node|listener}}s will not receive this transition.
  
 
This property is only relevant on {{Node|box}} nodes in the {{Node|layoutarea|layout area}}.
 
This property is only relevant on {{Node|box}} nodes in the {{Node|layoutarea|layout area}}.

Revision as of 07:08, 21 January 2013

Node: box (in the layoutarea only), page

Property Data Type Description
over Boolean If true the touchscreen is currently pressed within the bounds of the outer area of the box.

The over property reflects the real-time state of the touchscreen as pressed over the bounds of the outer-area of the box.

The property will transition true when the touchscreen is pressed inside the box, whether this is a new touch down event or the finger/stylus is already pressed and moves into the box. The property will go false when the touchscreen is release or the pressed finger/stylus moves outside the outer bounds of the box.

If the any displayable parent node's visible property goes false while over is true, the over property will transition to false immediately before the box is made invisible, hence listeners to box.over will receive this transition-to-false event.

If the any layout area parent node's enabled property goes false while over is true, the over property will transition to false afterwards, hence any listeners will not receive this transition.

This property is only relevant on box nodes in the layout area.