FOCUS property [Revelation On-Line Wiki]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== FOCUS property ======


 
==== Applies To ====
 
Interactive controls
 
==== Description ====
 
Used to determine if a control has focus, or to set focus to a control. Returns the name of the object that has focus.
 
==== Usage ====
 
//focusobject// = **Get_Property**(//windowname//, "**FOCUS**")

//currentfocus// = **Get_Property**("**SYSTEM**", "**FOCUS**")

If the window specified in //windowname// is not active, then //focusobject// will be the object that will get focus as soon as the window is activated.

//existingprop// = **Set_Property**(//objectname//, "**FOCUS**", //value//)

//existingprop// = **Set_Property**("**SYSTEM**", "**FOCUS**", //appwindow//)

In the first method, Set_Property suppresses all events generated because of focus change; the second method does not.

 
==== Remarks ====
 
Values passed in Set_Property:

^Value^Description^
|//Value//|A Boolean value (1 or 0, where 1 means that the control will have focus and 0 means that no control will have focus).|
|//objectname//|Name of control in //windowname// to receive focus.|
|//appwindow//|Name of window, in a multi-window application.|
 
==== Returns ====
 
Values returned by both Get_Property and Set_Property:

^Value^Description^
|//focusobject//|Control, in the current window, that has focus.|
|//existingprop//|Object with focus, when Set_Property was run.|

 
==== See Also ====
 
[[prevfocus|PREVFOCUS property]]