# Manuale di Mousetweaks

## Introduzione

Mousetweaks fornisce avanzate funzioni di accessibilità del mouse per lo GNOME Desktop mettendo a disposizione le seguenti funzioni:

- Simulazione del clic secondario: consente di eseguire un clic secondario (clic di menù) premendo e tenendo premuto il pulsante primario mentre non viene eseguito alcun movimento col puntatore.

- Clic automatico: consente di eseguire diversi clic senza premere alcun pulsante hardware.

- Cattura del puntatore: consente di bloccare il puntatore in una determinata area del pannello fino a che non viene rilasciato tramite la pressione di determinati tasti o di un pulsante del mouse.

Since version 2.31.3, mousetweaks does not depend any more on the AT-SPI accessibility framework.

## Come attivare le funzioni

Il clic secondario simulato e il clic automatico dipendono direttamente dall'esecuzione del programma; inoltre, l'applet di cattura del puntatore, dipende dal pannello di GNOME. Di conseguenza, i metodi per avviarli sono diversi.

### Attivare il clic secondario

È possibile attivare il clic secondario in due modi:

- dall'interfaccia grafica

- dalla riga di comando

#### Dall'interfaccia grafica

L'interfaccia grafica per attivare il clic secondario simulato è localizzata nella scheda Accessibilità delle preferenze del mouse. Per avviarla, scegliere Sistema Preferenze Mouse per aprire il dialogo delle preferenze del mouse. Una volta selezionata la scheda Accessibilità le seguenti funzioni sono disponibili:

Immagine del dialogo delle preferenze del mouse

Per attivare il clic secondario simulato, selezionare l'opzione:

Dare avvio al clic secondario tenendo premuto il pulsante principale

Immagine dell'opzione per avviare il clic secondario simulato

#### Dalla riga di comando

Per attivare il clic secondario simulato dalla riga di comando, aprire il Terminale e digitare quanto segue:

`mousetweaks `--ssc``

### Attivare il clic automatico

È possibile attivare la funzione di clic automatico in tre modi:

- all'interno della sezione Accessibilità delle preferenze del mouse

- dalla riga di comando

- dall'applet da pannello per il clic automatico

#### Dall'interfaccia grafica

L'interfaccia grafica per attivare il clic automatico è localizzata nella scheda Accessibilità delle preferenze del mouse. Per avviarla, scegliere Sistema Preferenze Mouse per aprire il dialogo delle preferenze del mouse. Una volta selezionata la scheda Accessibilità le seguenti funzioni sono disponibili:

Immagine del dialogo delle preferenze del mouse

Per attivare la funzione di clic automatico, selezionare l'opzione:

Iniziare il clic quando si ferma il movimento del puntatore

Immagine dell'opzione per avviare il clic automatico

#### Dalla riga di comando

Per attivare la funzione di clic automatico e mostrare la finestra con i tipi di clic dalla riga di comando, aprire il Terminale e digitare quanto segue:

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

The starting parameters --login and --daemonize were added to allow GDM to start and quit mousetweaks: the first disables the check for the Assistive Technologies framework at the start of mousetweaks; by not passing the second, mousetweaks will keep the pid that it got when it started, allowing GDM to shut it down by using the pid.

#### Attivare dall'applet da pannello del clic automatico

It is possible to start the Dwell Click by simply resting (dwelling) for a little delay with the pointer on the mouse icon displayed by the Dwell Click panel applet. In fact, this mouse icon is a dwellable On/Off button that provides feedback of the passing dwell time by filling its frame with another colour. When the frame is completely filled, the button displays its active state and the dwell click gets started.

Immagine che mostra l'applet con i tipi di clic

For instructions about how to install the Dwell Click applet on the GNOME panel, please have a look at Starting The Pointer Capture Function where you can see how it is done for the Pointer Capture panel applet. The procedure for the Dwell Click panel applet is similar.

### Attivare la funzione di cattura del puntatore

Poiché l'applet «Cattura puntatore» è un'applet da pannello, per avviarla è necessario seguire la procedura per aggiungere una qualsiasi applet al pannello di GNOME. Quindi, per installarla, basta aggiungerla al pannello.

Fare clic col pulsante destro del mouse (clic secondario), scegliere Aggiungi al pannello... per visualizzare il dialogo contenente tutte le applet che è possibile aggiungere.

Facendo doppio clic su Cattura del puntatore, l'applet verrà aggiunta al pannello e verrà eseguita finché non viene rimossa.

## Come terminare le funzioni

Come per l'attivazione delle funzione, la loro terminazione dipende da quale delle funzioni si prende in considerazione.

### Terminare la simulazione del clic secondario

È possibile terminare la simulazione del clic secondario in due modi:

- Deselezionando l'opzione corrispondente nel dialogo delle preferenze di Mousetweaks.

  Immagine dell'opzione per attivare la simulazione del clic secondario

  Per localizzare l'opzione, fare riferimento alla sezione Dall'interfaccia grafica.

- Digitando il seguente comando alla riga di comando:

  `mousetweaks` `--shutdown`

### Terminare il clic automatico

È possibile terminare il clic automatico in tre modi:

- Deselezionando l'opzione corrispondente nel dialogo delle preferenze di Mousetweaks.

  Immagine dell'opzione per attivare il clic all'assenza di movimento del puntatore

  Per localizzare l'opzione, fare riferimento alla sezione Dall'interfaccia grafica.

- Digitando il seguente comando alla riga di comando:

  `mousetweaks` `--shutdown`

- Se l'applet per il clic automatico è stata installata nel pannello, tale funzione può essere disabilitata soffermandosi col puntatore sul pulsante On/Off.

  Immagine che mostra l'applet con i tipi di clic

### Terminare la funzione di cattura del puntatore

Dato che l'applet «Cattura puntatore» è un'applet da pannello, per terminarla è necessario seguire la procedura per eliminare una qualsiasi applet da una pannello. Quindi, per disinstallarla, fare clic sul col pulsante destro sulla "maniglia" dell'applet e scegliere Rimuovi dal pannello dal menù contestuale.

Immagine che mostra l'area di cattura del puntatore (verde) con il suo menù contestuale

Quando viene usato il tema predefinito di GNOME, la "maniglia" dell'applet assomiglia a due linee punteggiate verticali posizionate alla sinistra dell'applet.

## Descrizione delle funzioni

Il programma offre all'utente tre funzioni di accessibilità per il puntatore. In questa sezione vengono descritte queste tre funzioni:

- mouse-a11y-ssc-description

- mouse-a11y-dwell-description

- mouse-a11y-pointer-capture-description

### Descrizione del clic secondario simulato

Quando l'utente attiva questa funzionalità, è possibile eseguire clic secondari usando il pulsante primario del mouse (quello sinistro). Questo risulta molto utile agli utenti con un mouse dotato di un solo pulsante.

Immagine che mostra il clic secondario simulato abilitato

#### Come funziona

Si assume che l'utente abbia abilitato il clic secondario simulato.

To perform a simulated secondary click, the user has to keep the primary mouse button pressed without moving the pointer for the time determined by the delay slider of the Simulated Secondary Click feature. While the primary mouse button is kept pressed, the arrow of the pointer will be filled with a different color to give feedback about the passing time.

If the user releases the primary mouse button before the arrow of the pointer has been completely filled with the new color, the system will only receive the information of the primary mouse button press and release.

If the user releases the primary mouse button after the arrow of pointer has been completely filled with the new color, the primary mouse button events will be followed by a secondary mouse button click. In fact, mousetweaks creates this simulated secondary mouse button click as soon as the user releases the the primary mouse button.

The explanations above assumed that the pointer did not move between the primary mouse button press and release. If the pointer gets moved before the primary mouse button is released, no simulated secondary click will be created. Consequently, to cancel an initiated secondary click, the user only has to move the pointer before releasing the primary mouse button.

Moreover, the fact that the simulated secondary click is immediately preceded by a left click makes it behave differently than expected when the preceding left click has an incidence on the object that is to receive the simulated secondary click. Please, have a look at the section about the Differences To The Normal Secondary Click for more details.

#### Il controllo scorrevole del ritardo

Il tempo totale che un utente deve tenere premuto il pulsante primario del mouse viene determinato dal controllo scorrevole Ritardo, localizzato al di sotto della casella di scelta dell'opzione. Utilizzando questo controllo scorrevole, è possibile impostare il ritardo più adatto alle proprie esigenze.

#### Soglia di movimento

Persone con problemi nel mantenere il puntatore completamente immobile possono utilizzare il controllo scorrevole «Soglia di movimento». Questa impostazione consente al programma di ignorare piccoli movimenti, cosicché il clic secondario simulato viene eseguito anche se il puntatore si muove. Per maggiori informazioni, consultare la sezione Impostare la soglia di movimento.

Il controllo scorrevole Soglia di movimento localizzato nella sezione Clic automatico, ha effetto sul Clic secondario simulato anche se l'opzione del Clic automatico è disabilitata.

#### Differenze col clic secondario normale

As the Simulated Secondary Click does not discard the primary mouse button press and release, the resulting primary click occurs just before the secondary click created by mousetweaks. Consequently, the simulated secondary click behaves a bit differently than the normal secondary click, because the latter is usually not preceded immediately by a primary mouse button click. For example:

- Non è possibile eseguire un clic secondario su molteplici oggetti poiché il clic primario eseguito prima di quello secondario deseleziona gli oggetti.

- When performing a simulated secondary click on a link in a web page, the primary click, that precedes the simulated secondary click, opens the referenced page before the simulated secondary click has a chance to open the contextual menu of the link.

  The contextual menu of a link in a web page can be opened by performing a simulated secondary click while keeping the Ctrl modifier pressed. This works because the referenced page opens in a new tab when the link receives a primary click in conjunction with a pressed Ctrl modifier; which is also what happens as a side effect when opening the contextual menu of a link by using the simulated secondary click in conjunction with the Ctrl modifier.

  However the browser has to be configured to not automatically switch to the new tab when it opens; otherwise the page with the link disappears as the new tab becomes visible and the contextual menu does not appear.

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

Non è possibile fornire un elenco completo di tutti i casi in cui il clic secondario si comporta diversamente, poiché il tutto dipende dalla reazione dell'applicazione che riceve il clic secondario preceduto da quello primario.

Looking at it the other way, it is not possible to perform a long motionless primary mouse button press without also triggering the secondary click, unless the pointer is moved before the primary mouse button release. This may also have unexpected consequences for some users. For example:

- When releasing the primary button after keeping it pressed on the arrow of a scrollbar for more than the delay time, the scrollbar jumps to the bottom. This is in fact the normal behaviour of a secondary click on an arrow of a scrollbar.

  To avoid that the scrollbar jumps to the bottom, simply move the pointer away from the arrow of the scrollbar before releasing the primary button; this way, the initiated simulated secondary click gets cancelled.

### Descrizione del clic automatico

Alcuni utenti non possono utilizzare alcun pulsante hardware. Attivando il Clic automatico, è possibile eseguire i vari clic del mouse senza dover interagire coi pulsanti del mouse. I clic del mouse che è possibile eseguire sono: clic singolo primario, doppio-clic, clic di trascinamento e clic secondario.

When the dwell click is active, the mouse buttons remain functional and it is still possible to click with the mouse buttons. Moreover, If the user performs a click with a mouse button while a dwell click is in progress, the dwell click gets stopped and no dwell click is generated; to initiate a new dwell click, the user has to move and stop moving the mouse as usual for the dwell click.

#### Come funziona

Ogni qual volta il puntatore si ferma, viene eseguito un clic automatico. Per fornire all'utente un riscontro di quello che avviene, il programma, durante il tempo impostato per l'esecuzione del clic automatico, riempie la freccia del puntatore con un altro colore.

Come viene completato e scelto il tipo di clic dipende dalla modalità di clic automatico selezionata. Le modalità disponibili sono:

- Scegliere il tipo di clic in anticipo

- Scegliere il tipo di clic coi gesti del mouse

Immagine che mostra i pulsanti radio per la selezione del clic automatico

Per selezionare la modalità, basta fare clic sul pulsante radio corrispondente alla proprio scelta.

##### Clic automatico con scelta anticipata del clic

Questa modalità è attiva quando viene selezionato Scegliere il tipo di clic in anticipo. Dopo che il mouse è rimasto fermo per la quantità di tempo indicata dal controllo scorrevole Ritardo, il sistema eseguirà automaticamente il tipo di clic selezionato dalla seguente finestra:

Immagine che mostra la finestra coi tipi di clic

Per visualizzare la finestra Tipo di clic automatico, è necessario selezionare l'opzione Mostrare la finestra per il tipo di clic:

Immagine con l'opzione per visualizzare la finestra coi tipi di clic

Una volta eseguito il clic, la tipologia del clic singolo viene ripristinata automaticamente. Per poter scegliere un altro tipo di clic, è necessario eseguire un clic automatico sul pulsante nella finestra Tipi di clic.

Al posto della finestra coi tipi di clic, è possibile utilizzare l'applet da pannello Clic automatico che presenta alcuni vantaggi:

Immagine che mostra l'applet con i tipi di clic

Usando invece l'applet da pannello Clic automatico:

- Non è necessario avere aperta la finestra Tipo di clic automatico che potrebbe nascondere altre finestre.

- È possibile avviare il clic automatico direttamente usando il pulsante On/Off dell'applet Clic automatico. Questo metodo si rivela molto utile quando è necessario disabilitare il clic automatico per un breve periodo di tempo senza che il clic automatico continui a essere eseguito.

Per visualizzare l'applet Clic automatico su un pannello, è necessario seguire la procedura per aggiungere una qualsiasi altra applet. Un esempio può essere trovato nella sezione Attivare la funzione di cattura del puntatore.

La finestra Tipo di clic automatico e l'applet Clic automatico possono essere utilizzate contemporaneamente o singolarmente.

##### Clic automatico con scelta del tipo di clic coi gesti del mouse

Questa modalità è attiva quando viene selezionato Scegliere il tipo di clic coi gesti del mouse. Dopo che il mouse è rimasto fermo per la quantità di tempo indicata dal controllo scorrevole Ritardo, il puntatore cambia forma per un breve periodo di tempo, assumendo la forma per eseguire i gesti:

- Se il puntatore viene mosso mentre è visualizzata la forma per i gesti, viene eseguito un clic alla posizione in cui il puntatore si trovava prima di essere mosso e quindi ritorna ad assumere la sua forma normale. Il tipo di clic eseguito dipende dalla direzione del movimento del mouse. Durante il movimento del puntatore, viene disegnata una linea che segue i movimenti, utile per fornire un riscontro visivo all'utente.

- Se il puntatore viene mantenuto fermo fino al ritorno alla sua forma normale, è possibile muovere il mouse senza che venga eseguito un clic. Il clic automatico successivo viene eseguito quando il puntatore si ferma nuovamente.

È anche possibile assegnare al tipo di clic un movimento particolare utilizzando le quattro opzioni che seguono:

Immagine che mostra le opzioni di configurazione per mappare il tipo di clic col movimento

In ognuna di queste opzioni è disponibile anche il valore Disabilitato in modo che sia possibile disabilitare alcuni tipi di clic se non sono ritenuti necessari. Questa funzionalità è utile per gli utenti che hanno problemi solo con alcuni tipi di clic.

#### Impostare il ritardo

Attraverso il controllo scorrevole Ritardo, è possibile impostare il tempo in cui il puntatore deve essere immobile affinché venga eseguito il clic.

Immagine che mostra il controllo scorrevole del ritardo

Il ritardo del clic automatico funziona solamente per i clic automatici.

#### Impostare la soglia di movimento

Il controllo scorrevole Soglia di movimento è utile alle persone che non riescono a mantenere il mouse completamente fermo.

Immagine che mostra il controllo scorrevole della soglia del movimento

Quando il controllo è portato vicino alla soglia "piccola", anche il minimo movimento viene considerato, impostando una soglia più grande, è necessario far coprire al puntatore uno spazio maggiore per poter considerare il movimento.

Il controllo scorrevole per la soglia del movimento funziona anche per il clic secondario simulato, anche se il clic automatico è disabilitato.

### Bloccare il puntatore

Alcuni utenti possono usare il dispositivo di puntamento non solo per il computer, ma per altre mansioni. In questi casi, un'area dello per bloccare il puntatore e usare il dispositivo per altre attività, è molto utile.

L'applet da pannello di cattura del puntatore crea una piccola area nel pannello, all'interno della quale è possibile bloccare il puntatore fintantoché non viene rilasciato in un determinato modo.

Have a look at Starting The Pointer Capture Function for instructions about how to install the pointer capture applet on the GNOME panel.

Immagine che mostra l'area di cattura del puntatore (verde) con il suo menù contestuale

Immagine che mostra l'area di cattura del puntatore una volta catturato il puntatore

Scegliendo Preferenze dal menù contestuale dell'applet Cattura del puntatore, viene visualizzata la finestra con le opzioni dell'applet Cattura del puntatore:

Immagine che mostra le preferenze per l'applet di cattura del puntatore

La finestra Preferenze di Cattura del puntatore dell'applet Cattura del puntatore è composta di tre sezioni:

- Nella sezione Cattura del puntatore, è possibile specificare sotto quali circostanze il puntatore viene catturato quando passa nell'area di cattura. Per esempio, se uno dei modificatori è selezionato, il puntatore viene catturato quando passa sopra l'area e viene premuto il modificatore selezionato. Se nessun modificatore è selezionato e il pulsante del mouse è impostato a zero (0), affinché il puntatore venga catturato è sufficiente farlo passare sopra l'area.

  È anche possibile indicare una combinazione di modificatori e pulsante mouse.

- Nella sezione Rilascio del puntatore, è possibile specificare quale modificatore o quale pulsante del mouse è usato per rilasciare il puntatore.

  È anche possibile indicare una combinazione di modificatori e pulsante mouse.

- Nella sezione Dimensione dell'area di cattura, è possibile specificare la larghezza dell'area di cattura presente nel pannello.

## Informazioni riguardo Mousetweaks

### Autori e sito web

Mousetweaks è basato su specifica presente in Launchpad. È stato implementato da Gerd Kohlberger (gerdk@svn.gnome.org), Francesco Fumanti (frfumanti@svn.gnome.org) ha fornito supporto e logistica.

È possibile trovare maggiori informazioni riguardo Mousetweaks su Launchpad e su GNOME Live.

### Commenti

Per segnalare un problema o inviare suggerimenti riguardo il modulo mousetweaks, l'interfaccia grafica o su questo manuale, utilizzare il servizio Bugzilla di GNOME. Se riguarda la disposizione degli elementi della scheda «Accessibilità» del dialogo «Preferenze del mouse», indicare il modulo «gnome-control-center»; per ogni altra cosa, indicare il modulo «mousetweaks».

### Licenza

Questo programma è distribuito sotto i termini della GNU General Public License come pubblicata dalla Free Software Foundation; o la versione 3 della licenza o (a propria scelta) una versione successiva. Una copia della licenza è disponibile a questo collegamento o nel file COPYING incluso con il codice sorgente di questo programma.

Questo manuale è distribuito sotto i termini della GNU Free Documentation License come pubblicata dalla Free Software Foundation; o la versione 1.3 della licenza o (a propria scelta) una versione successiva. Una copia della licenza può essere trovata a questo collegamento o nel file COPYING incluso con il codice sorgente di questo programma.