EtsT_Obj_Model_Click_Handler
Abstract
Callback: Used to specify custom behavior for an application’s response when a user left-, middle-, or double-clicks an object.
Syntax
<model_click_handler_name> (obj_handle, click_type)
| Argument | Type | Description |
|---|---|---|
obj_handle |
EtsT_Obj_Handle |
Handle to the object that was clicked. |
click_type |
EtsT_Obj_Click_Type |
The type of click that occurred, as indicated by one of the following constants:EtsC_Obj_Click_Type_LeftEtsC_Obj_Click_Type_MiddleEtsC_Obj_Click_Type_Double |
Return Type
EtsT_Obj_Click_Return
One of the following constants:
EtsC_Obj_Click_Continue— indicates that the application should continue handling the click.
EtsC_Obj_Click_Handled— indicates that the click has been handled and the application should not do any further processing.
Header
ets_api_obj.h
Details
The model click handlers let you intercept a click and either replace or add to the application’s handling of it. If a model click handler is specified for an object, the application calls that function when the user left-clicks, middle-clicks, or double-clicks that object. (Right-clicks are passed to the menu display handler, if one is specified.)
Note: If an object is double-clicked, two events will be sent: a left-click event followed by a double-click event.
If the click handler returns EtsC_Obj_Click_Continue, the application continues processing the click in the normal manner. If the function returns EtsC_Obj_Click_Handled, the application stops processing the click event (the click effectively has been “consumed”).