Name: foundLoc

Type: function

Syntax: the foundLoc

Syntax: foundLoc()

Summary: <return|Returns> the location of the top left corner of the box that surrounds text found by the <find> <command>.

Introduced: 1.0

OS: mac,windows,linux,ios,android

Platforms: desktop,server,web,mobile

Example:

the foundLoc

Example:

drag from the foundLoc to the bottomLeft of this card

Returns: The <foundLoc> <function> <return|returns> two positive <integer|integers> separated by a comma.

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 <return value|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> <return|returns> empty.

References: pixels (property), function (control structure), item (keyword), selection (keyword), current card (glossary), integer (glossary), command (glossary), return (glossary), return value (glossary), stack window (glossary), selectedLoc (function), foundField (function), find (command), stack (object)

Tags: database