Versions Compared
compared with
Key
- This line was added.
- This line was removed.
- Formatting was changed.
OnBrowserClick picture event
Declaration
Global handler:
Special handler:
Blok kódu | ||||
---|---|---|---|---|
| ||||
ENTRY OnBrowserClick(IN INT _refId, IN INT _mouseBtn, IN BOOL _dblClick, IN INT _row, IN INT _col, IN BOOL _bShift, IN BOOL _bCTRL[, IN BOOL _bButton[, BOOL _bDoDefault]]) ; script actions END OnBrowserClick |
Special handler:
Blok kódu | ||||
---|---|---|---|---|
| ||||
ENTRY XXX_OnBrowserClick(IN INT _mouseBtn, IN BOOL _dblClick, IN INT _row, IN INT _col, IN BOOL _bShift, IN BOOL _bCtrl[, IN BOOL _bButton[, BOOL _bDoDefault]]) ; script actions END XXX_OnBrowserClick |
Parameters
_refId | Parameter of INT type (required for global handler). |
XXX | Name of the reference variable connected to graphic object (without the character "_"). |
_mouseBtn | Input parameter of INT type - determines the pressed mouse button. |
_dblClick | Parameter of BOOL type.
|
_row | Row of the item above which the event was executed. |
_col | Column of the item above which the event was executed. |
_bShift | Attribute of the SHIFT key state when the mouse button is pressed. |
_bCtrl | Attribute of the CTRL key state when the mouse button is pressed. |
_bButton | Attribute that indicates whether the user clicked the button in given item or not (for the items with the parameter Display set to the Text+Button type). Possible values:
|
_bDoDefault | Allows to control the default behaviour of the browser after clicking the right mouse button. Possible values:
|
Description
The picture event is being generated by the defined displayer of Browser type, when the user click an item of the browser. The item is identified by its row (the parameter _row) and its column (the parameter _col).
The parameter _btnNr identifies the pressed mouse button according to the following table:
The parameter _btnNr identifies the pressed mouse button according to the following table:
_mouseBtn | Mouse button |
1 | Left |
2 | Middle |
3 | Right |
Example
Special picture event handler:
Blok kódu | ||||
---|---|---|---|---|
| ||||
ENTRY brw1_OnBrowserClick(IN INT _mouseBtn, IN BOOL _dblClick, IN INT _row, IN INT _col, IN BOOL _bShift, IN BOOL _bCtrl) %HI_AddItem(_lst, "brw1_OnBrowserClick") %HI_AddItem(_lst, " _mouseBtn = " + %IToStr(_mouseBtn)) IF _dblClick THEN %HI_AddItem(_lst, " _dblClick = TRUE") ELSE %HI_AddItem(_lst, " _dblClick = FALSE") ENDIF %HI_AddItem(_lst, " _row = " + %IToStr(_row)) %HI_AddItem(_lst, " _col = " + %IToStr(_col)) IF _bShift THEN %HI_AddItem(_lst, " _bShift = TRUE") ELSE %HI_AddItem(_lst, " _bShift = FALSE") ENDIF IF _bCtrl THEN %HI_AddItem(_lst, " _bCtrl = TRUE") ELSE %HI_AddItem(_lst, " _bCtrl = FALSE") ENDIF END brw1_OnBrowserClick |
Note
If both the handlers are defined in picture script, the global handler will never be called for _refId=_brw1, because a special handler is already defined.