A script-enabled browser is required for this page to function properly.

When-Mouse-DoubleClick Trigger

Description

Fires after the operator double-clicks the mouse if one of the following events occurs:

Six events must occur before a When-Mouse-DoubleClick trigger will fire:

Any trigger that is associated with these events will fire before the When-Mouse-DoubleClick trigger fires.

Definition Level form, block, or item

Legal Commands

SELECT statements, restricted Built-ins, unrestricted Built-ins

Enter Query Mode yes

Usage Notes

Use a When-Mouse-DoubleClick trigger to perform an action every time the operator double-clicks the mouse within an item and/or canvas.

On Failure

no effect

When-Mouse-DoubleClick Trigger Example

Assume that an application requires Behavior A when the operator clicks the mouse and Behavior B when the operator double-clicks the mouse. For example, if the operator clicks the mouse, a product information window must appear. If the operator double-clicks the mouse, an online help window must appear.

Three triggers are used in this example, a When-Mouse-Click trigger, a When-Timer-Expired trigger, and a When-Mouse-DoubleClick trigger.

/*
** Trigger: When-Mouse-Click
** Example: When the operator clicks the mouse, create a timer
** that will expire within .5 seconds.
*/

DECLARE
timer_id TIMER;
timer_duration NUMBER(5) := 500;
BEGIN
timer_id := Create_Timer('doubleclick_timer', timer_duration,
NO_REPEAT);
END;

/*
** Trigger: When-Timer-Expired
** Example: When the timer expires display the online help
** window if the operator has double-clicked the mouse
** within .5 seconds, otherwise display the product
** information window.
*/
BEGIN
IF :Global.double_click_flag = 'TRUE' THEN
Show_Window('online_help');
:Global.double_click := 'FALSE';
ELSE
Show_Window('product_information');
END IF;
END;

/*
** Trigger: When-Mouse-DoubleClick
** Example: If the operator double-clicks the mouse, set a
** flag that indicates that a double-click event
** occurred.
*/
BEGIN
:Global.double_click_flag := 'TRUE';
END;