Lingo Dictionary > A-C > constrainH()

 

constrainH()

Syntax

constrainH (whichSprite, integerExpression)

Description

Function; evaluates integerExpression and then returns a value that depends on the horizontal coordinates of the left and right edges of whichSprite, as follows:

When the value is between the left and right coordinates, the value doesn't change.

When the value is less than the left horizontal coordinate, the value changes to the value of the left coordinate.

When the value is greater than the right horizontal coordinate, the value changes to the value of the right coordinate.

The constrainH and constrainV functions constrain only one axis each; the constraint sprite property limits both. Note that this function does not change the sprite's properties.

Example

These statements check the constrainH function for sprite 1 when it has left and right coordinates of 40 and 60:

put constrainH(1, 20)
-- 40
put constrainH(1, 55)
-- 55
put constrainH(1, 100)
-- 60

Example

This statement constrains a moveable slider (sprite 1) to the edges of a gauge (sprite 2) when the mouse pointer goes past the edge of the gauge:

set the locH of sprite 1 to constrainH(2, the mouseH)

See also

constrainV(), constraint, left, right