mouseChunk

Typefunction
DictionaryLCS
LibraryLiveCode Script
Syntax
the mouseChunk
mouseChunk()
Summary

Returns a chunk expression describing the location of the word or text group under the mouse pointer.

Introduced1.0
OSmac, windows, linux, ios, android
Platformsdesktop, server, mobile
Example
the mouseChunk
if the shiftKey is down then select the mouseChunk
Values
NameTypeDescription
return

The mouseChunk function returns a chunk expression of the form char startChar to endChar of field fieldNumber.

RelatedKeyword: word, character, field
Property: textStyle
Function: dropChunk, selectedChunk, mouseCharChunk
Glossary: handler, grouped text, mouse pointer, return, chunk expression, return value
Control Structure: function
Description

Use the mouseChunk function within a handler to determine which word or text group the mouse is hovering over, in order to take some action based on the current character.

The mouseChunk function only returns locations in a field. If the mouse pointer is not over a field, the mouseChunk function returns empty.

The return value reports the word the mouse is over. The startChar is the first character of the word, and the endChar is the last character. If the textStyle of the text is "link", the return value specifies the entire text group.

To get the text of the word or text group, use the mouseText function.

Important: Words are defined a little differently by the mouseChunk function than the way they are used in chunk expressions. A word, for purposes of the mouseChunk, is any text delimited by spaces, tabs, returns, or punctuation. If the mouse pointer is over a punctuation character, only that character is returned.

Tagsui