foundLoc
Type
function
Summary
Returns the location of the top left corner of the box that surrounds text found by the find command.
Syntax
the foundLoc
foundLoc()
Description
Use the foundLoc function to determine the location in the stack window where the found text is shown.
When the find command finds text, it surrounds the text with a box. The first item of the return value is the horizontal distance in pixels from the left edge of the stack to the left edge of this box. The second item of the returned value is the vertical distance from the top edge of the stack window to the top of the box.
The foundLoc function is cleared when the text selection moves into the foundField or when the current card is closed. At the same time, the box the find command draws around the found text disappears. If there is no box, the foundLoc function returns empty.
Examples
the foundLoc
drag from the foundLoc to the bottomLeft of this card
Value
| Name | Type | Description |
|---|---|---|
return | The foundLoc function returns two positive integers separated by a comma. |
Related
object: stack
property: pixels
command: find
control structure: function
function: selectedLoc, foundField
glossary: current card, integer, command, return, return value, stack window
Compatibility and Support
Introduced
LiveCode 1.0
OS
mac
windows
linux
ios
android
Platforms
desktop
server
mobile