4D v14.3

Focus object

Home

 
4D v14.3
Focus object

Focus object 


 

Focus object -> Function result 
Parameter Type   Description
Function result  Pointer in Pointer to the object having the focus

This command is kept only for compatibility reasons. Starting with version 12 of 4D, it is recommended to use the OBJECT Get pointer command.

Focus object returns a pointer to the object having the focus in the current form. If no object has the focus, the command returns Nil. You can use Focus object to perform an action on a form area without having to know which object is currently selected. Be sure to test that the object is the correct data type, using Type, before performing an action on it.

Note: When it is used with a list box, the Focus object function returns a pointer to the list box or the column of the list box depending on the context. For more information, please refer to the Contextual click section.

This command cannot be used with fields in subforms.

Note: This command is to be used only in data entry context, otherwise it will return errors.

Example  

The following example is an object method for a button. The object method changes the data in the current object to uppercase. The object must be a text or string data type (type 0 or 24):

 $vp :=Focus object ` Save the pointer to the last area
 Case of
    :(Nil($pointer)) ` No object has the focus
       ...
    :((Type($vp->)=Is alpha field)|(Type($vp->)=Is string var)) ` If it is a string or text area
       $vp->:=Uppercase($vp->) ` Change the area to uppercase
 End case

 
PROPERTIES 

Product: 4D
Theme: User Interface
Number: 278

 
HISTORY 

Modified: 4D v11 SQL

 
SEE ALSO 

OBJECT Get pointer

 
ARTICLE USAGE

4D Language Reference ( 4D v12.4)
4D Language Reference ( 4D v14 R2)
4D Language Reference ( 4D v14 R3)
4D Language Reference ( 4D v13.5)
4D Language Reference ( 4D v14.3)
4D Language Reference ( 4D v14 R4)

Inherited from : Focus object ( 4D v11 SQL Release 6)