dblClick

dblClick();                             (Form)

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

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

For a Form, the dblClick event also occurs when the user double‑clicks a disabled control or a blank area of a form.

For a Control, this event occurs when the user double‑clicks a control.

For a ListBox control, the event occurs when the user double‑clicks the text of an item. When the user double‑clicks in a word in a JadeTextEdit control, that word is selected.

You can use a dblClick event for an implied action; for example, double‑clicking an icon to open a window or document. This type of event is also useful for carrying out multiple steps with a single action; for example, double‑clicking to select an item in a list box.

For those objects that receive mouse events, the events occur in the following order.

  1. mouseDown

  2. mouseUp

  3. click

  4. dblClick

  5. mouseUp

If the dblClick event does not occur within the double‑click time limit of the system, the object recognizes another click event. The double‑click time limit may vary, because the user can use the Windows Control Panel to set the double‑click speed. When you attach methods for these related events, ensure that their actions do not conflict.

Controls that do not receive dblClick events may receive two clicks instead of a dblClick event.

To distinguish between the left, right, and middle mouse buttons, use the mouseDown and mouseUp events.