click

click();                             (Form)

click(control: control-type input);  (Control)

click(menuItem: MenuItem input);     (MenuItem)

The click event occurs when the user presses and then releases the left mouse button over an object.

For a menu item, this event occurs when the user clicks the menu item. If the menu item has a submenu, logic in this event allows the contents of the submenu to be changed before it becomes visible.

For a form, this event occurs when the user clicks a blank area or a disabled control. (The click event is lost if a form or another application is displayed between the mouseDown or keyDown event and the mouseUp or keyUp event. This occurs most commonly if write instructions invoke the display window or if the display window has bring to top enabled.)

For a control, this event occurs when the user:

• Clicks a control with the left mouse button. (Both the click and the sheetChg events are generated when the user clicks the tab of a sheet of a Folder or Table control that is not currently the top sheet.)

• Selects an item in a ComboBox or ListBox control, by pressing the arrow keys, by clicking the left mouse button, or by entering text into the edit area of a combo box that causes a list item to become selected.

• Presses the spacebar when a Button, OptionButton, or CheckBox control has the focus.

• Presses an access key combination for a control. For example, if the caption of a command button is &Go, pressing Alt+G triggers the event.

• Presses the Enter key and a button is defined as being the default.

• Presses the Esc key and a button is defined as the Cancel button.

For the JadeTextEdit class, a single click event positions the caret (insertion point) in the text editor, a double-click selects a word, a triple-click selects a line, and a single-click outside selected text cancels the selection.

For details about handling the click event method in check box, combo box, list box, and option button controls and user-defined subclasses of only those controls on Web pages, see "Handling Events on Web Pages", in the JADE Web Application Guide.

Typically, you attach a click event to a control or menu, to carry out commands and command-like actions, or to a change in the control.

You can use the value property of a control to test for the state of the control from logic (except for a push button control). When a click event is generated, JADE also calls the related events in the following order.

1. mouseDown

2. mouseUp

3. click

When you attach methods for these related events, ensure that their actions do not conflict.

The methods in the following examples show the use of the click event method.

btnCancel_click(btn: Button input) updating;
begin
    unloadForm;
end;

theTable_dblClick(table: Table input) updating;
begin
    if xColSave <> 0 and yRowSave <> 0 then
        if theTable.row > 1 then
            btnChange.click(btnChange);
        endif;
    endif;
end;