| Parameter | Description |
|---|---|
| hoParent | object handle of focus parent |
Returns zero if object was successfully added to the focus tree. See Return Value Explanations below.
Procedure Add_Focus Handle hoParent Returns Integer
| Call: | Get msg_Add_Focus hoParent to IntegerVariable |
The Add_Focus message adds the object into the focus tree at the Next_Level of the hoParent in the focus tree. If the hoParent is not active, the message is terminated and returns a non-zero value (see below).
Add_Focus or Activate can be used to cancel object activation.
This message is used to construct the focus tree in a predefined structure. The activate message uses this message to either add the object to the next level of the current focus or the next level of the parent of the object, depending on the value of the Attach_Parent_State property.
See Activate for detailed explanations of the View and Modal Dialog activation process.
Get msg_Add_Focus oCustomerEntry to iRetVal
If the object cannot be added to the focus tree, a non-zero value is returned according to the following error conditions:
| 1 | Error_Activating | Activating returned a non zero value |
| 5 | Error_Cant_Accept_Focus | The Focus_Mode of the object is No_Activate |
| 6 | Error_Cant_Create_Tree | The object cannot be added to focus tree (probably due to lack of available memory) |
| 7 | Error_Add_to_Inactive_Object | The hoParent is not active |
| 8 | Error_No_Focusable_Children | If the object being added to the focus tree has its Client_Area_State set to true, and none of its child objects could be added to the focus tree |