User Guide

462 Chapter 12: Methods

pointToParagraph()

Usage

-- Lingo syntax

spriteObjRef.pointToParagraph(pointToTranslate)

// JavaScript syntax

spriteObjRef.pointToParagraph(pointToTranslate);

Description

Function; returns an integer representing the paragraph number located within the text or field

sprite at a specified at screen coordinate, or returns -1 if the point is not within the text.

Paragraphs are separated by carriage returns in a block of text.

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

Parameters

pointToTranslate

Required. Specifies the screen coordinate to test.

Example

These statements display the number of the paragraph being clicked, as well as the text of the

paragraph, in the message window:

-- Lingo syntax

property spriteNum

on mouseDown me

pointClicked = _mouse.mouseLoc

currentMember = sprite(spriteNum).member

paragraphNum = sprite(spriteNum).pointToParagraph(pointClicked)

paragraphText = currentMember.paragraph[paragraphNum]

put("Clicked paragraph" && paragraphNum & ", the text" && paragraphText)

end

// JavaScript syntax

function mouseDown() {

var pointClicked = _mouse.mouseLoc;

var currentMember = sprite(this.spriteNum).member;

var paragraphNum = sprite(this.spriteNum).pointToParagraph(pointClicked);

var paragraphText = currentMember.getProp("paragraph", paragraphNum);

trace("Clicked paragraph " + paragraphNum + ", the text " + paragraphText);

}