Included for backward compatibility. Use the ActiveControl Property for new forms instead.
This system variable is undocumented in the original VFP9 help file,
but the following documentation was found in the FoxPro for Windows 2.6 help, and may still be valid:
Returns or initializes the current @ ... GET object number.
_CUROBJ = expN
|
Remarks
_CUROBJ contains the number expN of the currently selected GET object. GET objects are created with @ ... GET and @ ... EDIT and include fields, check boxes, push and invisible buttons, popups, lists and text-editing regions. _CUROBJ is frequently queried or changed in a user-defined function called by a VALID or WHEN clause, or other READ and @ ... GET clauses.
You can return the value from _CUROBJ to determine which object is selected, or you can store a value to _CUROBJ to select a specific GET object.
The GET object number is determined by the order in which the GETs are issued. Each individual button in a set of push buttons, radio buttons or invisible buttons is considered a separate object.
You can change the value of _CUROBJ to position the cursor on another GET object. This is typically done in VALID and WHEN routines.
Example
The following program example demonstrates how GET objects are numbered and how _CUROBJ can be used to return the object number of the current object. Press Tab or the arrow keys to select different objects.
Pressing F2 displays the object number for the current object.
CLEAR SET TALK OFF STORE 1 to x, y, z ON KEY LABEL F2 @ 12,2 SAY 'Object # ' + STR(_CUROBJ) && Show # @ 4,2 GET x PICTURE '@*R \ | |

Microsoft Visual FoxPro 9 SP2 Help file, VFPX Edition v1.08