Queue double-click

Command group	Flag affected	Reversible	Execute on client	Platform(s)
Events	NO	NO	NO	All

Syntax

Options

Description

This command queues a "double-click event" on the specified field, that is, it simulates a user-generated double-click event on the field. A double-click event always generates an evClick before an evDoubleClick. You must specify the name of the field as a parameter, including the click positions within the field (that is, Start Row, Finish Row for lists and Start Character, Finish Character for text field selection).

There are options for including up to three modifier keys (that is, Shift, Ctrl/Cmnd) along with the click.

The field name parameter must be the name of a window field, not the name of the method associated with the field or the data name ($name, not $dataname). As an alternative to a simple name string, you can supply a notation string such as $cinst.$objs.name or even $cinst.$toolbars.toolbar.$objs.name where in the latter case the object is a toolbar control in the window toolbar that can accept the focus e.g. a combo box.

Double-clicks on text within an edit field will select the complete word. If a range was specified, all COMPLETE words falling within the start and end positions will be highlighted.

Double-clicks on list fields will generate an evClick followed by an evDoubleClick. The behavior in other ways is the same as described for Queue click.

Pushbuttons, radio buttons, radio groups and check boxes behave in the same way as described for Queue click. An evDoubleClick event is not generated.

Example

# Example for edit fields

# If the text in the field is:

# Good books are the lifeblood of a master spirit

# and the command is

Queue double-click
 
myEditField (7,23)

# The selected text is:

# books are the lifeblood

 
# Example for pushbutton - opens a new window while in Enter Data mode

# and selects all the text in the field myField

On
 
evClick

  
Open window instance
 
wMyWindow

  
Queue double-click
 
myField

  

On default
  
Quit event handler