Click

Click() Event

Called when the button is clicked

Applies to: Button , CheckBox , ComboBox , KCMLEdit , List Box , Picture Button , Radio

Click() Event

Click on graph data

Applies to: Graph

Introduced in KCML version 5.03

Click

This event handler is called each time a control is clicked. Note that the MouseX and MouseY properties are passed into this event handler. These properties contain the location of the mouse pointer at the time the Click() event occured. These properties can be used to place controls onto the picture, alternatively a popup menu can be displayed with the TrackPopup() menu method.

CheckBox

This event is called if the check box is checked or unchecked. The State property can be used to determine if the control is check or unchecked.

Radio

This event is called if the radio button is selected. The State property can be used to determine if the radio button is selected.

KCMLEdit

This event is called if the user clicks on the Ellipsis button on an Edit control. The Ellipsis button is only set if the DropStyle property is set to Ellipsis.

Note that when using dropdown ellipses within a grid control cell, the EllipsisClick() event handler is used.

Graph

The Click() event is triggered when the user clicks onto a bar element, pie sector or legend. If the user clicks anywhere else on the graph the NoItemClick event is triggered instead.

The data set and index are found in ClickSet and ClickIndex and allow the programmer to take an action based on the element clicked such as bring up further information or drilling down into the data. If the user clicks on a legend item, the values returned will depend on whether the graph has single or multiple sets of data. On a single set graph, each legend represents a data item, so the ClickSet will be the single set of the graph and the ClickIndex wil be the item of the legend. On a multiple set graph, each legend item represents a data set, so the ClickSet will be the legend clicked and the ClickIndex will be 0 as no particular item is accessed. On pie charts elements may be highlighted using the Explode() method.

See also

Button methods, properties and events. CheckBox methods, properties and events. ComboBox methods, properties and events. Graph methods, properties and events. KCMLEdit methods, properties and events. List Box methods, properties and events. Picture Button methods, properties and events. Radio methods, properties and events.