# Handbok för Musjusteringar

2007 - 2008
Francesco Fumanti
2008
Daniel Nylander (po@danielnylander.se)

Tillstånd att kopiera, distribuera och/eller modifiera detta dokument ges under villkoren i GNU Free Documentation License (GFDL), version 1.2 eller senare, utgivet av Free Software Foundation utan standardavsnitt och omslagstexter. En kopia av GFDL finns att hämta på denna länk eller i källkodspaketet för Musjusteringar.

Denna handbok utgör en av flera GNOME-handböcker som distribueras under villkoren i GFDL. Om du vill distribuera denna handbok separat från övriga handböcker kan du göra detta genom att lägga till en kopia av licensavtalet i handboken enligt instruktionerna i avsnitt 6 i licensavtalet.

Flera namn på produkter och tjänster är registrerade varumärken. I de fall dessa namn förekommer i GNOME-dokumentation - och medlemmarna i GNOME-dokumentationsprojektet är medvetna om dessa varumärken - är de skrivna med versaler eller med inledande versal.

DOKUMENTET OCH MODIFIERADE VERSIONER AV DOKUMENTET TILLHANDAHÅLLS UNDER VILLKOREN I GNU FREE DOCUMENTATION LICENSE ENDAST UNDER FÖLJANDE FÖRUTSÄTTNINGAR:

1. DOKUMENTET TILLHANDAHÅLLS I "BEFINTLIGT SKICK" UTAN NÅGRA SOM HELST GARANTIER, VARE SIG UTTRYCKLIGA ELLER UNDERFÖRSTÅDDA, INKLUSIVE, MEN INTE BEGRÄNSAT TILL, GARANTIER ATT DOKUMENTET ELLER EN MODIFIERAD VERSION AV DOKUMENTET INTE INNEHÅLLER NÅGRA FELAKTIGHETER, ÄR LÄMPLIGT FÖR ETT VISST ÄNDAMÅL ELLER INTE STRIDER MOT LAG. HELA RISKEN VAD GÄLLER KVALITET, EXAKTHET OCH UTFÖRANDE AV DOKUMENTET OCH MODIFIERADE VERSIONER AV DOKUMENTET LIGGER HELT OCH HÅLLET PÅ ANVÄNDAREN. OM ETT DOKUMENT ELLER EN MODIFIERAD VERSION AV ETT DOKUMENT SKULLE VISA SIG INNEHÅLLA FELAKTIGHETER I NÅGOT HÄNSEENDE ÄR DET DU (INTE DEN URSPRUNGLIGA SKRIBENTEN, FÖRFATTAREN ELLER NÅGON ANNAN MEDARBETARE) SOM FÅR STÅ FÖR ALLA EVENTUELLA KOSTNADER FÖR SERVICE, REPARATIONER ELLER KORRIGERINGAR. DENNA GARANTIFRISKRIVNING UTGÖR EN VÄSENTLIG DEL AV DETTA LICENSAVTAL. DETTA INNEBÄR ATT ALL ANVÄNDNING AV ETT DOKUMENT ELLER EN MODIFIERAD VERSION AV ETT DOKUMENT BEVILJAS ENDAST UNDER DENNA ANSVARSFRISKRIVNING;

2. UNDER INGA OMSTÄNDIGHETER ELLER INOM RAMEN FÖR NÅGON LAGSTIFTNING, OAVSETT OM DET GÄLLER KRÄNKNING (INKLUSIVE VÅRDSLÖSHET), KONTRAKT ELLER DYLIKT, SKA FÖRFATTAREN, DEN URSPRUNGLIGA SKRIBENTEN ELLER ANNAN MEDARBETARE ELLER ÅTERFÖRSÄLJARE AV DOKUMENTET ELLER AV EN MODIFIERAD VERSION AV DOKUMENTET ELLER NÅGON LEVERANTÖR TILL NÅGON AV NÄMNDA PARTER STÄLLAS ANSVARIG GENTEMOT NÅGON FÖR NÅGRA DIREKTA, INDIREKTA, SÄRSKILDA ELLER OFÖRUTSEDDA SKADOR ELLER FÖLJDSKADOR AV NÅGOT SLAG, INKLUSIVE, MEN INTE BEGRÄNSAT TILL, SKADOR BETRÄFFANDE FÖRLORAD GOODWILL, HINDER I ARBETET, DATORHAVERI ELLER NÅGRA ANDRA TÄNKBARA SKADOR ELLER FÖRLUSTER SOM KAN UPPKOMMA PÅ GRUND AV ELLER RELATERAT TILL ANVÄNDNINGEN AV DOKUMENTET ELLER MODIFIERADE VERSIONER AV DOKUMENTET, ÄVEN OM PART SKA HA BLIVIT INFORMERAD OM MÖJLIGHETEN TILL SÅDANA SKADOR.

Francesco
Fumanti

    frfumanti@svn.gnome.org

version 2.21.5
Januari 2008

The contents of the manual have been adapted to the changes applied to mousetweaks for its integration into GNOME 2.22. Francesco Fumanti frfumanti@svn.gnome.org

version 0.2
November 2007

The contents of the manual have been adapted to the default theme of GNOME, called Clearlooks. This version is included with the release 0.2.6 of Mousetweaks. Francesco Fumanti francesco.fumanti@gmx.net

version 0.1
Oktober 2007

First draft of the manual. Francesco Fumanti francesco.fumanti@gmx.net

This manual describes version 2.21.5 of mousetweaks and its graphical user interface consisting of the accessibility tab of the mouse control panel and two panel applets.
To report a bug or make a suggestion regarding the Mousetweaks application or this manual, please go to GNOME's Bugzilla, where where mousetweaks should soon be available.

## Återkoppling

To report a bug or make a suggestion regarding the mousetweaks module (i.e.: mouse accessibility), its user interface or its manual, please use the facilities provided by the GNOME's Bugzilla, where the corresponding module should soon be available.

## Introduktion

The mousetweaks module provides mouse accessibility enhancements for the GNOME Desktop. Indeed, it offers the following new functions to the user:

- Simulated secondary click: it allows the user to perform a secondary click (menu click) by holding down the primary mouse button while keeping the pointer motionless.

- Dwell click: it allows the user to perform the various clicks without pressing any hardware button.

- Pointer capture: it allows the user to lock the pointer in a determined area of the panel until the user releases it by a predefined keystroke or mouse button.

## Hur man startar funktionerna

The simulated secondary click and the dwell click depend on the mousetweaks process; however the pointer capture applet depends on the gnome panel. Consequently, they have to be started differently.

### Starting The Simulated Secondary Click Function

You can start the simulated secondary click in two ways:

- från det grafiska användargränssnittet

- från kommandoraden

#### Start From The Graphical User Interface

The graphical user interface to start the simulated secondary click is located in the accessibility tab of the mouse control panel. To open it, choose the menu System Preferences Control Center and the Control Center will open. By clicking on Mouse in the Control Center, the Mouse control panel will open and after clicking on the Accessibility tab, you will see the following settings:

Picture of the Mouse control panel

To start the simulated secondary click function, put a checkmark into the checkbox that says:

Trigger secondary secondary click by holding down the primary button

Picture of the checkbox to start the simulated secondary click

#### Start From The Command Line

To start the simulated secondary click from the command line, open the Terminal and type the following:

`mousetweaks `--enable delay``

### Starting The Dwell Click Function

You can start the dwell click function in two ways:

- från det grafiska användargränssnittet

- från kommandoraden

#### Start From The Graphical User Interface

The graphical user interface to start the dwell click is located in the accessibility tab of the mouse control panel. To open it, choose the menu System Preferences Control Center and the Control Center will open. By clicking on Mouse in the Control Center, the Mouse control panel will open and after clicking on the Accessibility tab, you will see the following settings:

Picture of the Mouse control panel

To start the dwell click function, put a checkmark into the checkbox that says:

Initiate click when stopping pointer movement

Picture of the checkbox to start the dwell click function

#### Start From The Command Line

To start the dwell click function and show the click type window from the command line, open the Terminal and type the following:

`mousetweaks `--enable dwell --show-ctw``

### Starting The Pointer Capture Function

As the pointer capture applet comes in the from of a panel applet, its starting method has to follow the rules dictated by the GNOME panel. Thus, to start the pointer capture function, you only have to install it on the panel and it will automatically run.

In order to add it to the panel, proceed as you do with any panel applet: perform a secondary click on the panel to open its contextual menu, choose Add to Panel, and you will get the window showing all the applets that can be installed on the GNOME panel.

Picture showing the Pointer Capture applet in the Add to Panel window

By double clicking on the Pointer Capture item in the Add to Panel window, the pointer capture applet will be added to the panel, and it will be working until removed.

## How To Quit The Functions

Similar to the starting of the functions, their quitting also depends on the feature that you want to quit.

### Quitting The Simulated Secondary Click

It is possible to quit the simulated secondary click in two ways:

- By removing the mark from the corresponding checkbox in the control panel of Mousetweaks.

  Picture of the checkbox to start the right click feature

  Please refer to Start The Simulated Secondary Click From The Graphical User Interface to locate the checkbox.

- By typing the following command at the command line:

  `musjusteringar` `--shutdown`

### Quitting The Dwell Click

It is possible to quit the dwell click in two ways:

- By removing the mark from the corresponding checkbox in the control panel of Mousetweaks.

  Picture of the checkbox to start the buttonless click feature

  Please refer to Start The Dwell Click From The Graphical User Interface to locate the checkbox.

- By typing the following command at the command line:

  `musjusteringar` `--shutdown`

### Quitting The Pointer Capture Function

As the pointer capture function comes in the form of a panel applet, you have to quit it the same way that you do it with other applets: perform a right click on the applet and choose Remove From Panel from its contextual menu.

Picture showing the pointer capture area (green) with its contextual menu

## Description Of The Functions

The Mousetweaks application offers three new pointer features to the user. These are:

### Simulated Secondary Click Description

When the user activates this feature, he will be able to perform secondary clicks by using the primary mouse button. This is especially useful for users that have only one mouse button at their disposal.

#### Hur fungerar det?

When this feature is enabled, mousetweaks performs a secondary click at the location of the pointer, if the user keeps the primary mouse button pressed without moving the pointer for a determined time.

How long the user has to hold the primary mouse button pressed is determined by the delay slider under the activation checkbox:

Picture showing the slider to set how long to hold the primary button for the secondary click to be triggered

#### Differences To The Normal Secondary Click

As the simulated secondary click is not able to discard the mouse button down gesture from the primary button press of the user, it issues a primary click before issuing the secondary click. In other words, each secondary click performed by this function is immediately preceded by a primary click, and this makes it behave a bit differently to the normal secondary click performed by the secondary mouse button. For example:

- It is not possible to perform a secondary click on multiple items because the primary click issued before the secondary click deselects the items.

- When the simulated secondary click is performed on the trash icon on the panel, not only does the contextual menu appear, but the trash folder does also open. (The former is caused by the secondary click, the latter by the primary click preceding the right click.)

It is not possible to provide a list of all diverging behaviours, because it depends on the reaction of the application receiving the secondary click preceded by a primary click.

Some users may also be surprised by the consequences of the following: it is not possible to perform a long motionless primary button click and hold, without also triggering the secondary click. For example:

- When doing a motionless primary button click and hold on the arrow of a scrollbar, the scrollbar jumps to the bottom after some time. This is in fact the normal behaviour of a secondary click on an arrow of a scrollbar.

  To work around this behaviour, simply move the pointer immediately after pressing the primary mouse button. This way the simulated secondary click is not issued.

### Dwell Click Description

There are users that cannot use any hardware button. By activating the Dwell Click, they can have the mouse perform the various clicks without pressing any mouse button. The click types that can be performed are: single primary click, double-click, drag click and secondary click.

When the buttonless click is active, the mouse buttons remain functional and it is still possible to click with the mouse buttons.

#### Dwell Delay Setting

With the Delay slider, the user can configure how long the pointer has to be motionless for the click to be initiated.

Picture showing the delay slider of the dwell click

Details about how to complete the click and how to choose the click type can be found under How To Complete Clicks And Specify The Click Type.

The dwell delay only works in the context of the dwell click.

#### Motion Treshold Setting

For people that have trouble to keep the mouse motionless, there is the Motion Treshold slider.

Picture showing the motion treshold slider of the dwell click

When the slider is set towards low, even little mouse movements are considered; however, by setting a higher treshold, the mouse has to traverse a bigger distance before it is considered as moving.

This function only works in the context of the dwell click.

#### How To Complete Clicks And Specify The Click Type

Each time she pointer stops moving, a click is initiated. How the click is completed and how the click type is chosen depends on what dwell mode the user has selected. The two available modes are:

Picture showing the radio buttons to select dwell mode

To select the mode, the user only has to click on the radio button that corresponds to his choice.

##### Dwell Click With Automatic Click Completion And Click Type Choice Beforehand

This mode is active when the user selects Choose type of click beforehand. In fact, after the mouse has been motionless for the time defined by the Delay slider, the system will automatically perform the click type that is selected in the Click Type Window shown here:

Picture showing the click type window

To display the click type window on the screen, the user has to put a checkmark in the checkbox named Show click type window:

Picture with the checkbox to display the click type window

After the click has occurred, the single click type will be automatically restored. In order to choose another click type, the user has to perform an automatic click on the button in the Click Type Window that corresponds to its click type choice.

Some users might prefer to use the Dwell Click panel applet instead of the Click Type Window. The advantage of the panel applet is that it does not cover any open window on the desktop.

Picture showing the click type applet at the right of the gnome menus

To display the click type applet on the GNOME panel, please follow the procedure you have to use in order to add any applet to the GNOME panel. If you do not know how to add an applet to the panel, have a look at Starting The Pointer Capture Function.

The click type window and the click type applet can be used simultaneously or each on its own.

##### Dwell Click With Click Type Choice And Click Completion By A Mouse Gesture

This mode is active when the user selects Choose type of click with mouse gestures. In fact, after the mouse has been motionless for the above predefined delay, the shape of the pointer will change for a little while:

- If the user moves the mouse while it is showing the alternative shape, a click is performed and the pointer returns to its normal shape. The type of click performed depends on the direction of the movement of the mouse.

- If the user keeps the mouse motionless until the pointer returns to its normal shape, the user can move the mouse without a click being performed. The next dwell click can be performed when the mouse stops moving again.

The user also has the possibility to match click type with movement direction by using the 4 popups available under this mode:

Picture showing the configuration options to map click type to movement direction

There is also a Disabled menu item in each popup. The user can select it if he does not want some click types to be performed automatically. This is especially interesting for users that have problems only with certain click types.

### Locking The Pointer Description

There are people that have to use their pointing device not only for the computer. These people would welcome a way to lock the pointer into an area of the screen, so that they can use their pointing device for other tasks.

In fact, the Pointer Capture panel applet creates such an area on the panel, into which the user can lock the pointer until he releases it in a determined way.

Picture showing the pointer capture area (green) with its contextual menu

Picture of the pointer capture area when the pointer has been captured

By choosing Preferences in the contextual menu of the pointer capture applet, the user gets a window with the options of the pointer capture applet:

Picture showing the preferences of the pointer capture applet

The preferences window of the pointer capture applet has three sections:

- In the Capture Pointer section, the user can specify under what circumstances the pointer gets captured when it moves into the capture area. For example: if the control modifier is checked, the pointer gets captured when it is over the capture area and the user presses the Control modifier key. If no modifier is checked and the mouse button is set to 0, the pointer only has to move into the capture area to get locked.

  It is also possible to specify a combination of modifiers and mouse button.

- In the Release Pointer section, the user can specify what modifier or mouse button releases the pointer.

  It is also possible to specify a combination of modifiers and mouse button.

- In the Size of Capture Area section, the user can specify the width of the capture area on the GNOME panel.

## About Mousetweaks

### Authors and hosting site

Mousetweaks is based on a specification hosted on Launchpad. It was implemented by Gerd Kohlberger ( gerdk@svn.gnome.org ), while I ( frfumanti@svn.gnome.org ) helped with testing and other things.

You can find more informations about Mousetweaks on Launchpad and on GNOME Live.

### Återkoppling

To report a bug or make a suggestion regarding the mousetweaks module (i.e.: mouse accessibility), its user interface or its manual, please use the facilities provided by the GNOME's Bugzilla, where the corresponding module should soon be available.

### Licens

This program is distributed under the terms of the GNU General Public license as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version. A copy of this license can be found at this link, or in the file COPYING included with the source code of this program.