within | ||||||||||
Type | function | |||||||||
Dictionary | LCS | |||||||||
Library | LiveCode Script | |||||||||
Syntax |
| |||||||||
Summary | ||||||||||
Introduced | 1.0 | |||||||||
OS | mac, windows, linux, ios, android | |||||||||
Platforms | desktop, mobile | |||||||||
Parameters |
| |||||||||
Example |
| |||||||||
Values |
| |||||||||
Related | Property: filled, menuMode, pixels, selected Operator: is not within, is within Keyword: button, image, rectangle, point, graphic Object: button, image, stack, graphic Function: intersect, mouseControl Glossary: property, return, title bar, object Control Structure: function | |||||||||
Description | Use the within function to determine whether a point is inside the specified object. If the point is within the clickable area of the object, the within function returns true, even if another object is layered on top of the object. If the object is a graphic, its interior is considered to be within the graphic only if the graphic's filled property is true or the graphic is selected. If the object is an image, only pixels that contain paint are considered to be within the image. Transparent parts of the image are not within the image, although they are within the image's rectangle. If the object is a button whose menuMode is "tabbed", only the tabs are considered to be within the button. The area below the tabs is not within the button, although it is within the button's rectangle. If the object is a stack, the within function returns true if the point is in the stack's content area, and false if the point is in the stack's title bar or borders. The expression
is equivalent to
unless the object a/ is a graphic or image, or a tabbed button. | |||||||||
Tags | ui |