Livecode Wiki
m
Tag: sourceedit
Line 1: Line 1:
Sent to a field when the focus is being removed from that field and the field's '''content has changed'''.
+
Sent to a [[field(keyword)]] when the [[focus]] is being removed from that [[field(keyword)]] and the [[field(object)|field's]] content has changed.Syntax:
 
closeField
   
 
Examples:
Syntax:
 
on closeField
 
...
 
end closeField
 
Examples:
 
 
on closeField -- make sure the user has entered a valid date
 
on closeField -- make sure the user has entered a valid date
 
if the text of me is not a date then
 
if the text of me is not a date then
Line 14: Line 11:
 
end closeField
 
end closeField
   
Handle the '''closeField''' message if you want to make sure a field's content is correct after it has been changed.
+
Handle the [[closeField]] [[message]] if you want to make sure a
  +
[[field(object)|field's]] content is correct after it has been changed.
   
  +
The selection is removed from a field (and the field loses focus) when
The selection is removed from a field (and the field loses focus) when another window is brought to the front, when the user clicks in another field, or when the user tabs out of the field. The field also loses focus when the select command is used to select text in another field. However, the '''closeField''' message is not sent when the user clicks in the same field.
 
  +
another window is brought to the front, when the user clicks in another
  +
field, or when the user tabs out of the field. The field also loses
  +
focus when the select [[command]] is used to [[select]] text in another
  +
[[field]]. However, the [[closeField]] [[message]] is not sent when the user
  +
clicks in the same [[field]].
   
The '''closeField''' message is not sent when a handler changes the field's contents using the [[put]] command.
+
The [[closeField]] [[message]] is not sent when a [[handler]] changes the
  +
field's contents using the [[put]] [[command]].
   
  +
If the lookAndFeel [[property]] is set to "Macintosh", the [[closeField]]
If the [[lookAndFeel]] property is set to "Macintosh", the '''closeField''' message is generally not sent when another control (such as a button) is clicked. This is because clicked buttons do not receive the focus on Mac OS systems, and therefore the selection remains active.
 
  +
[[message]] is generally not sent when another control (such as a
  +
[[button(keyword)]]) is clicked. This is because clicked buttons do not
  +
receive the [[focus]] on [[Mac OS|Mac OS systems]], and therefore the
  +
[[selection]] remains active.
   
The '''closeField''' message is also sent to buttons whose [[menuMode]] is "comboBox", since the type-in box in a combo box behaves like a field.
+
The [[closeField]] [[message]] is also sent to [[button(object)|buttons]]
  +
whose [[menuMode]] is "comboBox", since the type-in box in a [[combo box]]
  +
behaves like a [[field]].
   
If a field is closing and its contents have not changed, the [[exitField]] message is sent instead of '''closeField'''.
+
If a field is closing and its contents have not changed, the [[exitField]]
  +
[[message]] is sent instead of [[closeField]].
   
  +
See also: [[openField]] (message),[[exitField]] (message),[[focusOut]] (message),[[field]] (object),[[button]] (object),[[menuMode]] (property),
See Also: [[focusOut]] Message, [[openField]] Message, [[exitField]] Message
 
[[Category:Messages]]
+
[[Category: ui]]

Revision as of 14:56, 25 August 2016

Sent to a field(keyword) when the focus is being removed from that field(keyword) and the field's content has changed.Syntax:

closeField

Examples:

on closeField -- make sure the user has entered a valid date
  if the text of me is not a date then
    beep
    answer "Please enter a date."
    select text of me
  end if
end closeField

Handle the closeField message if you want to make sure a field's content is correct after it has been changed.

The selection is removed from a field (and the field loses focus) when another window is brought to the front, when the user clicks in another field, or when the user tabs out of the field. The field also loses focus when the select command is used to select text in another field. However, the closeField message is not sent when the user clicks in the same field.

The closeField message is not sent when a handler changes the field's contents using the put command.

If the lookAndFeel property is set to "Macintosh", the closeField message is generally not sent when another control (such as a button(keyword)) is clicked. This is because clicked buttons do not receive the focus on Mac OS systems, and therefore the selection remains active.

The closeField message is also sent to buttons whose menuMode is "comboBox", since the type-in box in a combo box behaves like a field.

If a field is closing and its contents have not changed, the exitField message is sent instead of closeField.

See also: openField (message),exitField (message),focusOut (message),field (object),button (object),menuMode (property),