Name: focusIn

Type: message

Syntax: focusIn

Summary:

Sent to a <control> when it becomes <active control|active> <focus|focused>.

Introduced: 1.0

Associations: button, field

OS: mac, windows, linux, ios, android

Platforms: desktop, server, mobile

Example:

on focusIn -- boldface the text of the control

set the textStyle of the target to "bold"

end focusIn

Description:

Handle the <focusIn> <message> if you want to perform preparation or do

other tasks when a control receives the <focus|keyboard focus>.

If the control is an unlocked field or a button whose menuMode is

"comboBox", the <openField> <message> is sent to it instead of the

<focusIn> <message>.

A locked field receives the <focusIn> <message> when the user tabs to it

or otherwise makes it <active control(glossary)|active> <focus|focused>,

or when text in it is <selected> by a <handler>.

References: handler (glossary), focus (glossary), message (glossary), active control (glossary), control (keyword),

openField (message), resume (message), selected (property)

Tags: ui