Click Event

This document covers the following topics:


Applies To

Bitmap Control, List Box Control, List View Column, List View Control, Menu Item, OLE Container Control, Push Button Control, Radio Button Control, Table Control, Toggle Button Control, Tool Bar Item, Tree View Control.

Description

Occurs whenever the end user selects the dialog element by a keyboard function or by a mouse click: a push button control may be pressed, a list box item may be selected, or a toggle button control may be checked. It is the most important event because the end user may trigger business logic with it (press a push button control to trigger a calculation or to validate data that have been entered, and so on).

Clicking a dialog element always selects the dialog element, but it does not necessarily cause an action to occur. A click event handler section is therefore only relevant if you want an action to occur.

For list view controls, a click event is raised every time the selected state of a list view item changes, regardless of whether this represents a selection or a de-selection. If necessary, these two cases can be distinguished in the click event handler by examining the SELECTED state of the corresponding ITEM.

If this event occurs in a cell of a Table Control, the ROW and COLUMN attributes are modified so that they contain the position of the cell that has been clicked on.