Defining the double-click duration for the Desktop

The following steps describe how to modify the double-click duration by editing the appropriate resource files.

1. Open the desired resource file for editing:

   • /usr/lib/X11/app-defaults/XDesktop3 for system-wide changes

   • $HOME/XDesktop3 for individual changes
   
   

2. Add the Desktop double-click resource specification, using the following format:
   
   XDesktop3.triggers.maxUpTime: resource_value

3. If desired, you can further customize mouse behavior on the Desktop with the following resources:

   • Set the XDesktop3.triggers.thresholdDownTime resource to control the time, in milliseconds, that a mouse button can be held down before it is considered a hold action instead of a click.

   • Set the XDesktop3.triggers.maxMotion resource to control the distance, in pixels, that the mouse cursor can move before a mouse button press is considered a drag action.

   When you have finished, save your changes and exit the resource file.

4. Restart the Desktop.

Step 1: Editing the resource file

You can change the duration allowed between the mouse button presses in a double-click action so that all users on your system can use the new behavior, or you can specify a new duration for an individual user only.

The majority of default Desktop resource settings are defined in the /usr/lib/X11/app-defaults/XDesktop3 file. The resources in this file are read by the resource manager when the Desktop is executed. If you want to modify the time allowed for double-clicks for all users, you should edit this file. You must have root privileges to edit this file. It is also a good idea to make a backup copy of this file before making changes to it.

If they do not use scomouse, individual users can also change this behavior using their personal Desktop resource file, $HOME/XDesktop3. When the user starts the Desktop, it checks to see if an XDesktop3 file exists in $HOME. If the file does exist, the resource values specified in the user resource file take precedence over any values assigned to the same resource for the system, or in the resource database.

See also:

• ``Methods for specifying resources'' for a more detailed explanation of the resource files

Step 2: Setting the maxUpTime resource

Use the triggers.maxUpTime resource to specify the duration allowed between clicks so the action is interpreted as a double-click. The default value of this resource is 500 milliseconds.

Use the following format to set this resource:

XDesktop3.triggers.maxUpTime: resource_value

For example, if you want to specify a duration of ``1,000'' milliseconds, set the triggers.maxUpTime resource so it reads:

XDesktop3.triggers.maxUpTime: 1000

Step 3: Modifying other Desktop mouse resources

There are two other resources that you can set to refine the interaction of your mouse with the Desktop client:

• The triggers.thresholdDownTime resource controls the time, in milliseconds, that a mouse button can be held down before it is considered a hold action instead of a click. The default value for this resource is ``700'' milliseconds.

• The triggers.maxMotion resource controls the distance, in pixels, that the mouse cursor can move before a mouse button press is considered a drag action. The default value for this resource is ``3'' pixels.

Step 4: Restarting the Desktop

Once you have made the desired resource changes, you need to restart the Desktop so the newly defined values will be read. Select Restart Desktop Session from the main Desktop File menu. In the Restart dialog box, click on Yes. The Desktop starts again and reads your new resource values.