Lingo Dictionary > O-R > pointToItem() |  |

pointToItem()

Syntax

    sprite(whichSpriteNumber).pointToItem(pointToTranslate)
    pointToItem(sprite spriteNumber, pointToTranslate)

Description

Function; returns an integer representing the item position in the text or field sprite `spriteNumber` at screen coordinate `pointToTranslate`, or returns -1 if the point is not within the text. Items are separated by the `itemDelimiter` property, which is set to a comma by default.

This function can be used to determine the item under the cursor.

Example

This Lingo displays the number of the item being clicked, as well as the text of the item, in the Message window:

    property spriteNum

    on mouseDown me
    	pointClicked = the mouseLoc
    	currentMember = sprite(spriteNum).member
    	itemNum = sprite(spriteNum).pointToItem(pointClicked)
    	itemText = currentMember.item[itemNum]
    	put "Clicked item" && itemNum & ", the text" && itemText
    end

See also

`itemDelimiter`, `mouseLoc`, `pointToChar()`, `pointToWord()`, `pointToItem()`, `pointToLine()`, `pointToParagraph()`