\input amigatexinfo
\input ita_texi
\input texinfo
@c %**start of header
@setfilename ToolManager.info
@settitle Documentazione di ToolManager 3.0
@setchapternewpage on
@c %**end of header


@comment
@comment  italiano.tex V3.0
@comment
@comment  Documentazione di ToolManager (formato Texinfo, Lingua: italiano)
@comment
@comment  Copyright (C) 1990-1997 Stefan Becker
@comment


@comment ----------------------------------------------------------------
@comment --- Title & Copyright Page (for printed manual)              ---
@comment ----------------------------------------------------------------
@titlepage

@title{ToolManager}
@subtitle{Un'estensione al Workbench di Amiga}
@subtitle{}
@subtitle{Versione 3.0}
@subtitle{23 Febbraio 1997}

@page
@vskip 0pt plus 1filll

@comment ----------------------------------------------------------------
@comment Note to translators:
@comment Translate this page and then copy it to the node "Copyright"
@comment Both pages must be identical (except for the TeX commands)!
@comment ----------------------------------------------------------------

È permesso fare e distribuire copie esatte di questo manuale a
condizione che le informazioni sul copyright e questa nota vengano
mantenute in tutte le copie.

@ignore
È permesso processare questo file con il TeX e stampare i risultati, a
condizione che i documenti stampati riportino una nota sul permesso di
copia identica a questa, fatta eccezione per la cancellazione di questo
paragrafo (questo paragrafo non ha importanza per quanto riguarda il
manuale stampato).
@end ignore

@noindent COPYRIGHT

Copyright @copyright{} 1990--1997 Stefan Becker

Nessun programma, documento, file di dati o codice sorgente che faccia
parte di questo pacchetto software può essere incluso o utilizzato in
altri prodotti software, per intero o in parte, senza il permesso
scritto dell'autore.

@noindent ASSENZA DI GARANZIA

Questo programma non è garantito in alcun modo. Sebbene l'autore abbia
cercato di eliminare ogni errore, egli non può garantire che il
software descritto in questo documento sia affidabile al 100%. Di
conseguenza, state utilizzando questo materiale a vostro rischio e
pericolo. L'autore non può essere ritenuto responsabile di eventuali
danni prodotti dall'uso di questo software.

@noindent DISTRIBUZIONE

Questo pacchetto software è liberamente distribuibile. Può essere
trasferito su qualsiasi mezzo utilizzato per la distribuzione di
software liberamente distribuibile, come raccolte di programmi di Pubblico
Dominio su dischetto, CDROM, server FTP o BBS.

Per assicurare l'integrità di questo pacchetto software, i
distributori dovrebbero usare i file originali:

@tex
\settabs 2 \columns
\+{\tt ToolManager3\_0Binaries.lha}&  (nome del file su Aminet: {\tt ToolManagerBin.lha})\cr
\+{\tt ToolManager3\_0Developer.lha}& (nome del file su Aminet: {\tt ToolManagerDev.lha})\cr
\+{\tt ToolManager3\_0Extras.lha}&    (nome del file su Aminet: {\tt ToolManagerExt.lha})\cr
\+{\tt ToolManager3\_0Locale.lha}&    (nome del file su Aminet: {\tt ToolManagerLoc.lha})\cr
\+{\tt ToolManager3\_0Sources.lha}&   (nome del file su Aminet: {\tt ToolManagerSrc.lha})\cr
@end tex

L'autore non può essere ritenuto responsabile nel caso in cui questo
pacchetto software sia divenuto inutilizzabile a causa di modifiche al
contenuto dei file archiviati o agli stessi archivi compressi.

Non è fissato alcun limite al compenso richiesto dai distributori, ad
esempio: per il costo del mezzo (dischetti, nastri o compact disk), o
per il processo di duplicazione. È stato accertato che tali limiti
sono nocivi per il concetto di software liberamente distribuibile, ad
esempio: il programma in questione veniva rimosso invece di ridurre
il prezzo di un floppy disk al di sotto di un certo limite.

Per quanto l'autore non ponga limiti a tali compensi, egli intende
esprimere il suo personale parere in proposito:

@itemize @bullet
@item Questo pacchetto software dovrebbe essere reso disponibile a
ciascuno gratuitamente ogni volta che ciò è possibile.

@item Se avete comprato questo pacchetto software in condizioni
normali da un venditore di prodotti di Pubblico Dominio su floppy disk
e avete pagato più di 5 DM o 5$, allora avete pagato
@emph{decisamente} troppo. Siete pregati di non contribuire
ulteriormente a questa forma inappropriata di guadagno e di rivolgervi
a una fonte meno cara il prima possibile.
@end itemize

@noindent RESTRIZIONI SULL'USO

Nessun programma, documento, file di dati o codice sorgente che faccia
parte di questo pacchetto software può essere utilizzato, per intero o
in parte, su di una macchina che venga utilizzata

@itemize @bullet
@item per la ricerca, sviluppo, costruzione, sperimentazione o
produzione di armi, o altre applicazioni militari. Questo include
anche qualsiasi macchina che venga utilizzata nell'istruzione relativa
a uno qualsiasi degli scopi sopra descritti.

@item da persone che accettano, sostengono o utilizzano la violenza
contro altre persone, ad esempio: cittadini di paesi stranieri.
@end itemize
@page
(Questa pagina è stata lasciata vuota di proposito)
@end titlepage
@headings double
@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Prima pagina Node (not printed)                                   ---
@comment ----------------------------------------------------------------
@ifinfo
@node Prima pagina, Copyright, (dir), (dir)
@top ToolManager 3.0 Documentation

@menu
Informazioni importanti:

* Copyright::          Copyright e altre informazioni legali
* Giftware::           Se vi piace ToolManager@dots{}
* Futuro::             Riguardo il futuro di ToolManager
* Autore::             Dove inviare segnalazioni di bug, commenti e donazioni

Uso:

* Requisiti::          Che cosa è richiesto per usare ToolManager
* Installazione::      Come installare ToolManager
* Concetti::           I concetti alla base di ToolManager
* Preferenze::         Come configurare ToolManager

Appendici:

* Tasti rapidi::       Come definire un tasto rapido
* Quesiti::            Quesiti frequenti
* History::            Storia di ToolManager
* Ringraziamenti::     L'autore ringrazia@dots{}
* MUI::                Informazioni su MUI
* Indice::             Indice
@end menu

@end ifinfo
@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Chapter: Copyright (for Info/AmigaGuide document)        ---
@comment ----------------------------------------------------------------
@ifinfo
@node Copyright, Giftware, Prima pagina, Prima pagina
@chapter Copyright e altre informazioni legali
@cindex Copyright
@cindex Distribuzione
@cindex Informazioni legali
@cindex Concessioni
@cindex Divieti

È permesso fare e distribuire copie esatte di questo manuale a
condizione che le informazioni sul copyright e questa nota vengano
mantenute in tutte le copie.

@noindent COPYRIGHT

Copyright @copyright{} 1990--1997 Stefan Becker

Nessun programma, documento, file di dati o codice sorgente che faccia
parte di questo pacchetto software può essere incluso o utilizzato in
altri prodotti software, per intero o in parte, senza il permesso
scritto dell'autore.

@noindent ASSENZA DI GARANZIA

Questo programma non è garantito in alcun modo. Sebbene l'autore abbia
cercato di eliminare ogni errore, egli non può garantire che il
software descritto in questo documento sia affidabile al 100%. Di
conseguenza, state utilizzando questo materiale a vostro rischio e
pericolo. L'autore non può essere ritenuto responsabile di eventuali
danni prodotti dall'uso di questo software.

@noindent DISTRIBUZIONE

Questo pacchetto software è liberamente distribuibile. Può essere
trasferito su qualsiasi mezzo utilizzato per la distribuzione di
software liberamente distribuibile, come raccolte di programmi di Pubblico
Dominio su dischetto, CDROM, server FTP o BBS.

Per assicurare l'integrità di questo pacchetto software, i
distributori dovrebbero usare i file originari:


@noindent
ToolManager3_0Binaries.lha  (nome del file su Aminet: ToolManagerBin.lha)
ToolManager3_0Developer.lha (nome del file su Aminet: ToolManagerDev.lha)
ToolManager3_0Extras.lha    (nome del file su Aminet: ToolManagerExt.lha)
ToolManager3_0Locale.lha    (nome del file su Aminet: ToolManagerLoc.lha)
ToolManager3_0Sources.lha   (nome del file su Aminet: ToolManagerSrc.lha)

L'autore non può essere ritenuto responsabile nel caso in cui questo
pacchetto software sia divenuto inutilizzabile a causa di modifiche al
contenuto dei file archiviati o agli stessi archivi compressi.

Non è fissato alcun limite al compenso richiesto dai distributori, ad
esempio: per il costo del mezzo (dischetti, nastri o compact disk), o
per il processo di duplicazione. È stato accertato che tali limiti
sono nocivi per il concetto di software liberamente distribuibile, ad
esempio: il programma in questione veniva rimosso invece di ridurre
il prezzo di un floppy disk al di sotto di un certo limite.

Per quanto l'autore non ponga limiti a tali compensi, egli intende
esprimere il suo personale parere in proposito:

@itemize @bullet
@item Questo pacchetto software dovrebbe essere reso disponibile a
ciascuno gratuitamente ogni volta che ciò è possibile.

@item Se avete comprato questo pacchetto software in condizioni
normali da un venditore di prodotti di Pubblico Dominio su floppy disk
e avete pagato più di 5 DM o 5$, allora avete pagato
@emph{decisamente} troppo. Siete pregati di non contribuire
ulteriormente a questa forma inappropriata di guadagno e di rivolgervi
a una fonte meno cara il prima possibile.
@end itemize

@noindent RESTRIZIONI SULL'USO

Nessun programma, documento, file di dati o codice sorgente che faccia
parte di questo pacchetto software può essere utilizzato, per intero o
in parte, su di una macchina che venga utilizzata

@itemize @bullet
@item per la ricerca, sviluppo, costruzione, sperimentazione o
produzione di armi, o altre applicazioni militari. Questo include
anche qualsiasi macchina che venga utilizzata nell'istruzione relativa
a uno qualsiasi degli scopi sopra descritti.

@item da persone che accettano, sostengono o utilizzano la violenza
contro altre persone, ad esempio: cittadini di paesi stranieri.
@end itemize
@end ifinfo
@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Chapter: Giftware                                        ---
@comment ----------------------------------------------------------------
@node Giftware, Futuro, Copyright, Prima pagina
@chapter Se vi piace ToolManager@dots{}
@cindex Giftware
@cindex Donazioni

ToolManager è @emph{Giftware}, @strong{non} Shareware!

Così, se il programma vi piace e lo usate molto spesso, dovreste
prendere in considerazione l'idea di mandare una piccola donazione o
un dono per onorare l'impegno che ho messo nel fare questo programma.
Suggerisco una donazione di 10--20$, o 10--20 DM. Per favore, non
mandate assegni o bonifici da paesi non europei, poiché molto spesso
incassare questi trasferimenti di valuta costa più della donazione
stessa.

Se non potete permettervi di mandare una donazione non dovete sentirvi
in colpa. Ma dovreste almeno mandarmi una cartolina o una lettera per
dirmi che utilizzate ToolManager (mi piace ricevere lettere dei fan
:-). @xref{Autore}.

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Chapter: Future                                          ---
@comment ----------------------------------------------------------------
@node Futuro, Autore, Giftware, Prima pagina
@chapter Riguardo il futuro di ToolManager
@cindex Futuro

Dopo l'ultima versione di ToolManager, la 2.1 rilasciata nel Maggio
del 1993, sono stati tempi duri per l'Amiga e i suoi utenti. Al
momento in cui scrivo, il futuro non appare ancora roseo. Malgrado
ciò, ho deciso di sviluppare questa nuova versione di ToolManager a
causa del feedback che ho ricevuto da centinaia di utenti soddisfatti.

Il mio fedele A3000 sta diventando vecchio e, data la situazione
attuale, la via che prenderà l'Amiga non è affatto sicura. Non posso
permettermi di comprare ogni aggiornamento o una delle (eventuali)
nuove macchine, dato che questo progetto è soltanto un mio hobby. Così
dipende dalle vostre reazioni e donazioni se sarò in grado di lavorare
a versioni future di ToolManager.

Questo è anche un appello alle società che stanno lavorando ai futuri
modelli di Amiga (Amiga Technologies, Phase5, ProDAD, VisCorp o
chiunque altro sia coinvolto attualmente). Sono solo un autore di
software liberamente distribuibile che non può permettersi di comprare
ogni eventuale sistema che verrà prodotto, o pagare il materiale per
lo sviluppo per ogni sistema. Quindi ho bisogno del vostro sostegno,
se volete vedere ToolManager sul vostro sistema. Ricordate che
ToolManager è uno dei programmi più usati su Amiga, forse @strong{il} più
usato, e quindi costituirebbe un vantaggio per il vostro sistema.

Il futuro di ToolManager dipende dal @emph{VOSTRO} sostegno!

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Chapter: Author                                          ---
@comment ----------------------------------------------------------------
@node Autore, Requisiti, Futuro, Prima pagina
@chapter Dove inviare segnalazioni di bug, commenti e donazioni
@cindex Indirizzi
@cindex Autore
@cindex Contattare l'autore
@cindex Posta elettronica
@cindex Homepage
@cindex Pagina WWW
@cindex Indirizzo postale
@cindex World Wide Web

L'autore può essere raggiunto ai seguenti indirizzi:

@table @asis
@item Indirizzo postale:

@example

        Stefan Becker
        Bonner Ring 68
D-50374 Erfstadt
        GERMANY
@end example

@item Posta elettronica:

@example

stefanb@@yello.ping.de
@end example
@end table

Inoltre esiste anche una homepage dedicata a ToolManager sul World
Wide Web:

@example
http://www.ping.de/sites/yello/toolmanager.html
@end example

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Chapter: Requirements                                    ---
@comment ----------------------------------------------------------------
@node Requisiti, Installazione, Autore, Prima pagina
@chapter Che cosa è richiesto per installare ToolManager
@cindex Requisiti
@cindex OS 3.0
@cindex V39
@cindex DataTypes
@cindex PictDT V43
@cindex Pophotkey
@cindex Popport
@cindex Popposition
@cindex DOSPath
@cindex WBStart
@cindex ScreenNotify

ToolManager necessita come minimo:

@table @asis
@item AmigaOS 3.0 (V39)
o superiore per i memory pools e il picture.datatype.

@item WBStart 2.2
Questo permette a ToolManager di lanciare programmi Workbench.

@item DOSPath 1.0
Questo permette a ToolManager di gestire i path AmigaDOS.
@end table

Oltre a ciò sono supportati:

@table @asis
@item ScreenNotify 1.0
Questo pacchetto permette a ToolManager di aprire e chiudere le sue
finestre pannello quando uno schermo pubblico viene aperto o chiuso.

@item picture.datatype V43
Le estensioni di questo picture.datatype avanzato sono supportate
automaticamente se è installato nel vostro sistema. @xref{Ringraziamenti}.
@end table

Il programma di configurazione richiede:

@table @asis
@item AmigaOS 3.0 (V39)
o superiore per i memory pools.

@item MUI 3.7
La GUI orientata agli oggetti. @xref{MUI}.

@item Pophotkey, Popport, Popposition
Delle classi MUI di tipo custom per il popup. @xref{Ringraziamenti}.
@end table

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Chapter: Installation                                    ---
@comment ----------------------------------------------------------------
@node Installazione, Concetti, Requisiti, Prima pagina
@chapter Come installare ToolManager
@cindex Installazione
@cindex Installer V43.3

Siete pregati di usare l'accluso script Installer per installare
ToolManager. Richiede l'Installer AmigaOS V43.3. Questa versione è
reperibile su Aminet.

Accertatevi di aver chiuso il vecchio ToolManager prima di installare
la nuova versione!

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Chapter: Concepts                                        ---
@comment ----------------------------------------------------------------
@node Concetti, Preferenze, Installazione, Prima pagina
@chapter I concetti alla base di ToolManager
@cindex Concetti

ToolManager è un programma che vi permette di lanciare le vostre
applicazioni in un modo molto semplice. Potete lanciare programmi
usando delle abbreviazioni da tastiera (@pxref{Tasti rapidi}), selezionando una
voce dal menu Strumenti del Workbench oppure cliccando su di un'icona
sul Workbench o in speciali finestre pannello. Potete anche trascinare
icone dai cassetti del Workbench sulle icone dei pannelli per fornire file
ai programmi. Inoltre potete anche collegare un suono a ciascuna di
queste operazioni.

Tutte queste cose vengono controllate dagli oggetti di ToolManager.
Ogni oggetto ha un compito specifico e contiene informazioni su come
compiere tale compito. Ad esempio, i programmi sono rappresentati come
oggetti eseguibili e possono contenere informazioni riguardo il nome
del programma e le dimensioni dello stack.

Vi sono due tipi di oggetti: gli oggetti di tipo eseguibile, immagine
e suono sono chiamati oggetti di base, poiché contengono informazioni
riguardo a un singolo programma eseguibile, immagine o suono.

Gli oggetti di tipo menu, icona e pannello vengono chiamati oggetti
composti, poiché uniscono più oggetti di base per eseguire i loro
compiti. Ad esempio, un'icona sul Workbench è rappresentata da un
oggetto icona che è collegato ad un oggetto immagine per l'immagine e
a un oggetto eseguibile che lancia un programma quando l'icona è
attivata.

@menu
* Oggetti eseguibili::    Programmi
* Oggetti immagine::      Immagini
* Oggetti suono::         Suoni
* Oggetti menu::          Voci nel menu Strumenti del Workbench
* Oggetti icona::         Icone nella finestra del Workbench
* Oggetti pannello::      Finestre di pannello
@end menu

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Section: Concepts/Oggetti eseguibili                           ---
@comment ----------------------------------------------------------------
@node Oggetti eseguibili, Oggetti immagine, , Concetti
@section Programmi
@cindex Oggetti eseguibili

Un oggetto eseguibile contiene informazioni riguardo un programma che
viene lanciato quando l'oggetto è attivato. L'oggetto può
essere attivato direttamente dall'utente usando un @ref{Tasti rapidi,
tasto rapido} o attraverso un oggetto composto. Possono essere indicati una
serie di file che al momento dell'attivazione vengono inviati al
programma in qualità di parametri di partenza. Gli oggetti eseguibili
vengono configurati con la finestra @ref{Finestra eseguibili, Modifica oggetto
eseguibile}.

ToolManager può eseguire diversi tipi di programmi:

@table @asis
@item Shell
Il programma viene eseguito come se l'utente avesse digitato l'intera
linea di comando nella shell. Gli script shell devono essere lanciati
in questo modo. Potete utilizzare il consueto segnaposto @file{[]} per
specificare dove dovrebbero essere posti gli argomenti sulla linea di
comando.

@item Workbench
Viene simulato un lancio dal Workbench. Tutti i file vengono forniti
come argomenti Workbench. I programmi eseguibili solo da shell e gli script
non funzioneranno se lanciati come programmi Workbench.

@item ARexx
Viene eseguito uno script o un comando ARexx.

@item Pannello
Il comando specifica un oggetto pannello da attivare. Potete usare questo
tipo di programma per creare pannelli che sono contenuti all'interno di
altri pannelli.

@item Tasto rapido
Viene simulata la pressione di alcuni tasti. Questa potrebbe essere
utilizzata per controllare un altro programma da ToolManager.
@end table

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Section: Concepts/Image objects                          ---
@comment ----------------------------------------------------------------
@node Oggetti immagine, Oggetti suono, Oggetti eseguibili, Concetti
@section Immagini
@cindex Oggetti immagine

Un oggetto immagine contiene informazioni riguardo un'immagine che viene
utilizzata da un oggetto composto. ToolManager può caricare icone del
Workbench che vengono usate da @ref{Oggetti icona,oggetti icona}. Quando un
@ref{Oggetti pannello, oggetto pannello} usa un oggetto immagine i dati vengono
caricati utilizzando il sistema dei Datatype. Così ToolManager può usare
ogni oggetto per il quale avete installato sul vostro sistema un datatype
valido. Gli oggetti immagine vengono configurati per mezzo della
finestra @ref{Finestra immagini, Modifica oggetto immagine}.

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Section: Concepts/Oggetti suono                          ---
@comment ----------------------------------------------------------------
@node Oggetti suono, Oggetti menu, Oggetti immagine, Concetti
@section Suoni
@cindex Oggetti suono

Un oggetto suono contiene informazioni riguardo un comando relativo a
un suono. Questo comando viene inviato come comando ARexx a un
riproduttore di suoni esterno. Gli oggetti suono vengono configurati
per mezzo della finestra @ref{Finestra suoni, Modifica oggetto suono}.

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Section: Concepts/Menu objects                           ---
@comment ----------------------------------------------------------------
@node Oggetti menu, Oggetti icona, Oggetti suono, Concetti
@section Voci nel menu Strumenti del Workbench
@cindex Oggetti menu

Un oggetto menu è un oggetto composto che unisce un @ref{Oggetti eseguibili,
oggetto eseguibile} e un @ref{Oggetti suono, oggetto suono} per creare una
voce nel menu Strumenti del Workbench. Ogni volta che questa voce viene
selezionata l'oggetto eseguibile e quello suono vengono attivati. Ogni icona
selezionata sul Workbench viene usata come parametro di partenza per il
programma. Gli oggetti menu vengono configurati per mezzo della finestra
@ref{Finestra menu, Modifica oggetto menu}.

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Section: Concepts/Icon objects                           ---
@comment ----------------------------------------------------------------
@node Oggetti icona, Oggetti pannello, Oggetti menu, Concetti
@section Icone nella finestra del Workbench
@cindex Oggetti icona

Un oggetto icona è composto da un @ref{Oggetti eseguibili, oggetto eseguibile}, un
@ref{Oggetti immagine, oggetto immagine} e un @ref{Oggetti suono, oggetto
suono} per creare un'icona sulla finestra (o schermo) del Workbench.
L'oggetto immagine viene utilizzato per creare l'immagine dell'icona. Gli
oggetti icona vengono creati per mezzo della finestra @ref{Finestra
icone, Modifica oggetto icona}.

Le icone possono essere attivate in due modi. L'utente può cliccare
due volte sull'icona, oppure può selezionare altre icone sul Workbench e
trascinarle sull'icona. Ogni volta che l'icona è attivata vengono
attivati anche l'oggetto eseguibile e l'oggetto suono. Le icone che
sono state trascinate sull'oggetto icona vengono usate come parametri
di partenza per il programma.

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Section: Concepts/Dock objects                           ---
@comment ----------------------------------------------------------------
@node Oggetti pannello, , Oggetti icona, Concetti
@section Finestre di pannello
@cindex Oggetti pannello

Un oggetto pannello è un oggetto composto che presenta all'utente una
finestra contenente file di pulsanti. Ogni pulsante lega insieme un
@ref{Oggetti eseguibili, oggetto eseguibile}, un @ref{Oggetti immagine, oggetto
immagine} e un @ref{Oggetti suono, oggetto suono}. Ogni pulsante può
mostrare un testo, un'immagine o entrambi. Il nome dell'oggetto eseguibile
viene utilizzato per il testo. L'oggetto immagine viene utilizzato per
l'immagine. Gli oggetti pannello sono configurati per mezzo della finestra
@ref{Finestra pannelli, Modifica oggetto pannello}.

Ogni pulsante può essere attivato in due modi. L'utente puòò cliccare
sul pulsante oppure può selezionare delle icone sul Workbench e trascinarle
sul pulsante. Ogni volta che il pulsante è attivato vengono attivati anche
l'oggetto eseguibile e l'oggetto suono. Le icone che sono state
trascinate sul pulsante vengono usate come parametri di partenza per
il programma.

Un oggetto pannello può essere attivato con un @ref{Tasti rapidi, tasto rapido}.
Quando la finestra del pannello è chiusa e l'utente digita il tasto rapido
allora la finestra viene aperta, e viceversa.

Se la @file{screennotify.library} è stata installata, allora ToolManager può
aprire e chiudere le finestre dei pannelli automaticamente. Ogni volta che
uno schermo sta per essere chiuso, per prima cosa vengono chiuse tutte
le finestre pannello che si trovano su di esso. Quando lo schermo pubblico
si riapre, tutte le finestre pannello che si trovavano su di esso vengono
aperte di nuovo.

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Chapter: Preferences                                     ---
@comment ----------------------------------------------------------------
@node Preferenze, Tasti rapidi, Concetti, Prima pagina
@chapter Come configurare ToolManager
@cindex Preferenze

Il programma di configurazione serve a configurare ToolManager.

@menu
* Finestra principale::   La finestra principale

Finestre per la configurazione:

* Finestra eseguibili::   Come configurare gli oggetti eseguibili
* Finestra immagini::     Come configurare gli oggetti immagine
* Finestra suoni::        Come configurare gli oggetti suono
* Finestra menu::         Come configurare gli oggetti menu
* Finestra icone::        Come configurare gli oggetti icona
* Finestra pannelli::     Come configurare gli oggetti pannello

Altre finestre:

* Gruppi::        Come rinominare un gruppo di oggetti
* Appunti::       Appunti per gli oggetti
* Globali::       Opzioni globali di ToolManager

@end menu

Il programma di configurazione è in grado di interpretare i parametri
standard del Workbench e i parametri di un comando shell:

@table @asis
@item @code{FROM} (Shell only)
Indica il nome del file da cui il programma deve caricare la
configurazione.

@item @code{EDIT} (default)
Modifica la configurazione.

@item @code{USE}
Usa temporaneamente la configurazione indicata.

@item @code{SAVE}
Usa permanentemente la configurazione indicata.

@item @code{CREATEICONS}
Crea icone per i file di configurazione quando questi vengono salvati.
Se lanciato dal Workbench il programma di configurazione crea
automaticamente le icone, se lanciato da Shell no.
@end table

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Section: Preferences/Finestra principale                          ---
@comment ----------------------------------------------------------------
@node Finestra principale, Finestra eseguibili, , Preferenze
@section La finestra principale

La finestra principale contiene le liste di oggetti. Cliccando sul
tipo di oggetto potete scegliere la lista da rendere visibile. Ogni
lista può contenere diversi gruppi, ogni gruppo può contenere diversi
oggetti.

Un doppio click sul nome di un gruppo apre la finestra @ref{Gruppi,
Modifica gruppo}. Cliccando sul simbolo a sinistra del nome del gruppo si
apre o chiude il gruppo. Se un gruppo è aperto potete vedere tutti gli
oggetti che contiene. Un doppio click sul nome di un oggetto apre la
finestra che permette di modificarlo.

Per spostare un gruppo dovete prima selezionarlo, poi trascinarlo fino
alla sua nuova posizione tenendo premuto il pulsante sinistro del
mouse, infine rilasciare il pulsante del mouse. Con lo stesso metodo
si possono anche spostare oggetti fra gruppi diversi.

Ogni lista presenta quattro pulsanti:

@table @asis
@item Nuovo gruppo
Crea un nuovo gruppo vuoto. Si aprirà la finestra @ref{Gruppi, Modifica
gruppo} per permettervi di dare un nome al nuovo gruppo.

@item Nuovo oggetto
Crea un nuovo oggetto nel gruppo selezionato. Verrà aperta la finestra
di modifiche in modo da poter impostare le proprietà del nuovo
oggetto.

@item Cancella
Cancella il gruppo o l'oggetto selezionato. Se un gruppo è selezionato
allora anche tutti gli oggetti da esso contenuti verranno cancellati.

@item Ordina
Se viene selezionato un oggetto oppure un gruppo aperto, allora i
contenuti di tale gruppo vengono ordinati alfabeticamente. Se nessun
gruppo è aperto, allora sono i gruppi stessi a venir messi in ordine
alfabetico.
@end table

Con i pulsanti che si trovano nella parte inferiore della finestra
principale potete istruire il programma di configurazione sul luogo dove
salvare la configurazione. Il nome del file di configurazione è @file{ToolManager.prefs}.

@table @asis
@item Salva
Salva la configurazione in @file{ENVARC:} e @file{ENV:}. La nuova
configurazione viene utilizzata automaticamente e sopravvive al
reboot. Dopo aver salvato il file di configurazione il programma esce.

@item Usa
Salva la configurazione in @file{ENV:}. La nuova configurazione viene
utilizzata automaticamente, ma @emph{non} sopravviverà a un reboot.
Dopo aver salvato il file di configurazione il programma esce.

@item Prova
Salva la configurazione in @file{ENV:}. La nuova configurazione viene
utilizzata automaticamente, ma @emph{non} sopravviverà ad un reboot.
Il programma di configurazione non esce.

@item Annulla
Il programma di configurazione esce. Tutte le modifiche che non sono
state salvate verranno abbandonate.
@end table

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Section: Preferences/ExecWindow                          ---
@comment ----------------------------------------------------------------
@node Finestra eseguibili, Finestra immagini, Finestra principale, Preferenze
@section Come configurare gli oggetti eseguibili

Gli @ref{Oggetti eseguibili, oggetti eseguibili} contengono informazioni
relative ai programmi. La finestra contiene i seguenti gadget:

@table @asis
@item Nome
Nome dell'oggetto.

@item Tipo eseg.
Tipo di programma. Potete scegliere tra Shell, Workbench, ARexx,
Pannello, Tasto rapido e Rete. Il tipo Rete al momento non è supportato.

@item Comando
Il nome del programma. Questo è il nome del file, il nome di un
pannello oppure la descrizione di un tasto rapido che dipende dal tipo
eseguibile.

@item Tasto rapido
Una stringa di descrizione del @ref{Tasti rapidi, tasto rapido} che attiva questo
oggetto Exec.

@item Stack
Le dimensioni dello stack per il programma. ToolManager imporrà un
minimo di 4096 byte.

@item Priorità
La priorità del programma. In genere dovreste usare solo il valore
preimpostato, cioè 0.

@item Argomenti
Se questo gadget è selezionato, allora i file selezionati vengono inviati al
programma come argomenti di partenza. Altrimenti i file vengono ignorati.

@item In primo piano
Se questo gadget è selezionato, allora lo schermo pubblico indicato
viene spostato in primo piano prima di lanciare il programma.

@item Directory attuale
Il programma viene lanciato da questa directory.

@item Percorso
Qui potete indicare una lista di directory (separate da ";") che verrà
utilizzata dai programmi di tipo shell per cercare altri programmi.

@item File di output
L'output di programmi di tipo shell viene indirizzato verso questo
file. Se specificate una finestra console, allora l'output e l'input
del programma verranno indirizzati verso questa finestra.

@item Schermo pubblico
Specifica il nome dello schermo pubblico che verrà spostato in primo
piano prima di lanciare il programma.
@end table

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Section: Preferences/ImageWindow                         ---
@comment ----------------------------------------------------------------
@node Finestra immagini, Finestra suoni, Finestra eseguibili, Preferenze
@section Come configurare gli oggetti immagine

Gli @ref{Oggetti immagine, oggetti immagine} contengono informazioni riguardo
le immagini. La finestra di impostazione di un oggetto immagine contiene i
seguenti gadget:

@table @asis
@item Nome
Nome dell'oggetto.

@item File
Il nome del file che contiene l'immagine e che dovrebbe essere
caricato. In genere è necessario rimuovere il suffisso @file{.info} se
si desidera caricare un'icona.
@end table

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Section: Preferences/SoundWindow                         ---
@comment ----------------------------------------------------------------
@node Finestra suoni, Finestra menu, Finestra immagini, Preferenze
@section Come configurare gli oggetti suono

Gli @ref{Oggetti suono, oggetti suono} contengono informazioni riguardo i
suoni. La finestra di impostazione di un oggetto suono contiene i seguenti
gadget:

@table @asis
@item Nome
Nome dell'oggetto.

@item Comando
Il comando ARexx che deve essere inviato al programma di riproduzione
musicale esterno.

@item Porta ARexx
Il nome della porta ARexx del riproduttore musicale esterno. Il valore
predefinito è @code{PLAY} e viene utilizzato dal programma @file{upd}.
@end table

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Section: Preferences/MenuWindow                          ---
@comment ----------------------------------------------------------------
@node Finestra menu, Finestra icone, Finestra suoni, Preferenze
@section Come configurare gli oggetti menu

Gli @ref{Oggetti menu, oggetti menu} contengono informazioni riguardo il
menu Tools del Workbench. La finestra di impostazione contiene i seguenti
gadget:

@table @asis
@item Nome
Nome dell'oggetto. Viene utilizzato anche per creare una voce del
menu.

@item Oggetto eseg.
Collegamento ad un @ref{Oggetti eseguibili, oggetto eseguibile}. Usate il
Drag&Drop dalla @ref{Finestra principale, finestra principale} oppure dagli
@ref{Appunti, appunti} per stabilire il collegamento con un oggetto.
Potete modificare le caratteristiche dell'oggetto collegato cliccandoci
sopra.

@item Oggetto suono
Collegamento ad un @ref{Oggetti suono, oggetto suono}. Usate il Drag&Drop
dalla @ref{Finestra principale, finestra principale} oppure dagli @ref{Appunti,
appunti} per stabilire il collegamento con un oggetto. Potete
modificare le caratteristiche dell'oggetto collegato cliccandoci
sopra.
@end table

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Section: Preferences/IconWindow                          ---
@comment ----------------------------------------------------------------
@node Finestra icone, Finestra pannelli, Finestra menu, Preferenze
@section Come configurare gli oggetti icona

Gli @ref{Oggetti icona, oggetti icona} contengono informazioni riguardo le
icone presenti nella finestra del Workbench. La finestra di impostazione
contiene i seguenti gadget:

@table @asis
@item Nome
Nome dell'oggetto.

@item Oggetto eseg.
Collegamento ad un @ref{Oggetti eseguibili, oggetto eseguibile}. Usate il
Drag&Drop dalla @ref{Finestra principale, finestra principale} oppure dagli
@ref{Appunti, appunti} per stabilire il collegamento con un oggetto.
Potete modificare le caratteristiche dell'oggetto collegato cliccandoci
sopra.

@item Oggetto immagine
Collegamento ad un @ref{Oggetti immagine, oggetto immagine}. Usate il Drag&Drop
dalla @ref{Finestra principale, finestra principale} oppure dagli @ref{Appunti,
appunti} per stabilire il collegamento con un oggetto. Potete modificare le
caratteristiche dell'oggetto collegato cliccandoci sopra.

@item Oggetto suono
Collegamento ad un @ref{Oggetti suono, oggetto suono}. Usate il Drag&Drop
dalla @ref{Finestra principale, finestra principale} oppure dagli @ref{Appunti,
appunti} per stabilire il collegamento con un oggetto. Potete
modificare le caratteristiche dell'oggetto collegato cliccandoci
sopra.

@item Posizione
Specifica le coordinate X e Y dell'icona, ad esempio: per @code{X =
100} e @code{Y = 55} dovreste digitare @code{100/55}. Le coordinate
sono relative all'angolo superiore sinistro della finestra del
Workbench.

@item Mostra nome
Se questo gadget è selezionato, allora il nome dell'oggetto è mostrato
sotto l'icona.
@end table

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Section: Preferences/DockWindow                          ---
@comment ----------------------------------------------------------------
@node Finestra pannelli, Gruppi, Finestra icone, Preferenze
@section Come configurare gli oggetti pannello

Gli @ref{Oggetti pannello, oggetti pannello} contengono informazioni riguardo
le finestre pannello. La finestra di impostazione contiene i seguenti
gadget:

@table @asis
@item Nome
Nome dell'oggetto. Viene utilizzato anche come titolo per la finestra.

@item Tasto rapido
Una stringa di descrizione del @ref{Tasti rapidi, tasto rapido} che apre
e chiude la finestra del pannello.

@item Schermo pubblico.
Specifica lo schermo pubblico sul quale compare la finestra del
pannello. Dovete @strong{necessariamente} specificare un valido nome
di schermo pubblico se intendete usare la possibilità di apertura e
chiusura automatiche per le finestre pannello.

@item Carattere
Usa questo font per il testo dei pulsanti.

@item Colonne
Numero di colonne di pulsanti nella finestra pannello. Le colonne
verranno riempite con i pulsanti a partire da sinistra verso destra.
Se viene impiegata l'ultima colonna di una fila, allora viene aggiunta
una nuova fila di pulsanti. Tutti i pulsanti hanno la stessa larghezza
e altezza.

@item Posizione
Specifica le coordinate X e Y della finestra pannello, ad esempio: per @code{X =
150} e @code{Y = 200} dovreste digitare @code{150/200}. Le coordinate
sono relative all'angolo superiore sinistro della finestra del
Workbench.

@item Voci
Ciascuna voce in questa lista crea un pulsante. La colonna di sinistra
contiene il collegamento a un @ref{Oggetti eseguibili, oggetto eseguibile},
quella centrale il collegamento a un @ref{Oggetti immagine, oggetto immagine}
e quella di destra il collegamento a un @ref{Oggetti suono, oggetto suono}.
Usate il Drag&Drop dalla @ref{Finestra principale, finestra principale} oppure
dagli @ref{Appunti, appunti} per stabilire il collegamento con un oggetto.
Potete modificare le caratteristiche dell'oggetto collegato cliccandoci
sopra. Potete usare il Drag&Drop per ordinare le voci nella lista. Quando
premete il pulsante Cancella la voce attualmente selezionata viene rimossa
dalla lista. Gli oggetti stessi @emph{non} verranno cancellati.

@item Attivo
La finestra pannello verrà aperta al momento in cui viene caricata la
configurazione.

@item Backdrop
La finestra pannello viene spostata in secondo piano dopo essere stata
aperta.

@item Bordo
Quando questo gadget è selezionato la finestra pannello sembra una
normale finestra con un bordo e i gadget delle finestre di Intuition.
Altrimenti non avrà nessun bordo e nessun gadget. Si noti che è
possibile spostare una finestra pannello soltanto se ha un bordo.

@item Menu
Viene creato un menu per la finestra pannello. Il menu permette di chiudere
il pannello, di lanciare l'@ref{Preferenze, editor di preferenze} di
ToolManager oppure di chiudere ToolManager.

@item Primo piano
Quando questo gadget è selezionato la finestra pannello si aprirà
sempre sul primo schermo pubblico disponibile.

@item A comparsa
La finestra pannello si chiude automaticamente dopo che un pulsante è
stato selezionato.

@item Centrato
La finestra pannello si apre in posizione centrata rispetto alla
posizione attuale del mouse.

@item Fisso
In genere una finestra pannello ricorda la sua posizione quando la
chiudete. Si aprirà sulla stessa posizione se richiamata nuovamente.
Se questo gadget è selezionato il pannello si aprirà sempre sulla
stessa posizione.

@item Immagini
I pulsanti in questa finestra pannello mostreranno delle immagini. Si
noti che in questo caso è necessario collegare degli @ref{Oggetti
immagine, oggetti immagine} alle voci del pannello.

@item Testo
I pulsanti nella finestra pannello mostreranno il nome dell'@ref{Oggetti
eseguibili, oggetto eseguibile} collegato. Si noti che in questo caso è
necessario collegare degli oggetti eseguibili al pannello.
@end table

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Section: Preferences/GroupWindow                         ---
@comment ----------------------------------------------------------------
@node Gruppi, Appunti, Finestra pannelli, Preferenze
@section Come rinominare un gruppo di oggetti

Potete cambiare il nome di un gruppo cliccando su di esso e
modificando il vecchio nome nella finestra "Modifica nome gruppo".

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Section: Preferences/ClipWindow                          ---
@comment ----------------------------------------------------------------
@node Appunti, Globali, Gruppi, Preferenze
@section Appunti per gli oggetti

Questa finestra contiene un elenco di @ref{Oggetti eseguibili, oggetti
eseguibili}, @ref{Oggetti immagine, oggetti immagine} e @ref{Oggetti suono,
oggetti suono}. Potete trascinare oggetti da questo elenco e lasciarli
cadere sulle finestre di configurazione. Potete modificare gli oggetti
collegati con un doppio click su di essi. Quando il pulsante Cancella viene
premuto l'oggetto attualmente selezionato viene rimosso dalla lista. Gli
oggetti stessi @emph{non} verranno cancellati.

La clipboard può essere richiamata dal menu della finestra principale.
Potete avere più di una clipboard aperta nello stesso momento.

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Section: Preferences/GlobalWindow                        ---
@comment ----------------------------------------------------------------
@node Globali, , Appunti, Preferenze
@section Opzioni globali di ToolManager

Questa finestra vi permette di modificare le opzioni globali di ToolManager.
Può essere aperta dal menu della finestra principale. Ha i seguenti
gadget:

@table @asis
@item Directory attuale
Imposta la directory corrente per ToolManager. Tutti i file privi di
un path completo verranno aperti in relazione a questa directory. La
directory corrente predefinita è il volume di boot.

@item Editor impostazioni
Path del programma di @ref{Preferenze, impostazione delle preferenze} di
ToolManager. L'impostazione predefinita è @file{SYS:Prefs/ToolManager}.

@item Abilita rete
Attualmente non supportato.

@item Abilita rimapp.
Consente il remapping dei colori per il picture.datatype. Disabilitate
questa impostazione soltanto se le immagini nelle finestre pannello
presentano dei colori sbagliati.

@item Precisione rimapp.
Definisce la precisione del remapping dei colori. Potete provare a
modificare questo valore se le scelte relative ai colori
dell'algoritmo di remapping sono insoddisfacenti sul vostro sistema.
@end table

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Appendix: Hotkeys                                        ---
@comment ----------------------------------------------------------------
@node Tasti rapidi, Quesiti, Preferenze, Prima pagina
@appendix Come definire un tasto rapido
@cindex Introduzione ai tasti rapidi
@cindex Tasti rapidi

Questo capitolo descrive come definire un tasto rapido, ovvero una
``scorciatoia'' da tastiera, come stringa di
descrizione dell'input, che viene poi analizzata da Commodities. Tutte
le volte che viene attivato un tasto rapido, Commodities genera un
evento che ToolManager utilizza per attivare oggetti eseguibili o
finestre pannello. .Una stringa di descrizione presenta la seguente
sintassi:

@example
[<classe>] @{[-][<qualificatore>]@} [-][upstroke] [<codice tasto>]
@end example

Le parole chiave possono essere indifferentemente in maiuscolo o minuscolo.

@code{classe} descrive la classe dell'InputEvent. Questo parametro è
opzionale, e se assente viene assunto @code{rawkey}. @xref{Classi di
InputEvent}.

I qualificatori sono dei ``segnali'' che devono essere attivati o disattivati
al momento in cui viene premuto il tasto (in caso contrario non viene
generato alcun evento). Per ogni qualificatore, occorre indicare la parola
chiave corrispondente; si assume che i qualificatori non citati debbano
essere disattivati. Se volete ignorare un particolare qualificatore, basta
precedere la parola chiave con @code{-}. @xref{Qualificatori}.

La scorciatoia viene generalmente attivata quando il tasto viene premuto. Se
desiderate che sia invece attivata quando il tasto viene rilasciato, indicate
la parola chiave @code{upstroke}. Se volete che sia la pressione che il rilascio
di un tasto generino l'evento, usate @code{-upstroke}.
Il codice tasto dipende dalla classe InputEvent. @xref{Codici tasto}.

@menu
* Classi di InputEvent::
* Qualificatori::
* Codici tasto::
* Esempi di tasti rapidi::
@end menu

Nota: scegliete @emph{con cura} i vostri tasti rapidi, perché Commodities ha
un'alta priorità nella catena dei gestori di InputEvent, e dunque potrebbe
sottrarre le segnalazioni degli eventi ad altri programmi.

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Appendix Section: Hotkeys/InputEvent classes             ---
@comment ----------------------------------------------------------------
@node Classi di InputEvent, Qualificatori, , Tasti rapidi
@appendixsection Classi di InputEvent
@cindex Diskinserted
@cindex Diskremoved
@cindex Classi di InputEvent
@cindex Rawkey
@cindex Rawmouse

Commodities supporta la maggior parte delle classi di InputEvent generati
dalla input.device. Questa sezione descrive le classi più utili nella
descrizione di tasti rapidi per ToolManager.

@table @code
@item rawkey
Questa è la classe predefinita e comprende tutti gli eventi di tastiera.
Per esempio, @code{rawkey a} o @code{a} crea un evento tutte le volte che
viene premuto il tasto ``a''. È necessario specificare un codice tasto per
questa classe. @xref{Codici rawkey}.

@item rawmouse
Questa classe descrive tutti gli eventi relativi ai pulsanti del mouse. È
necessario specificare un codice tasto per questa classe.
@xref{Codici rawmouse}.

@item diskinserted
Gli eventi di questa classe vengono generati quando si inserisce un disco in
un drive. Questa classe non richiede codici tasto.

@item diskremoved
Gli eventi di questa classe vengono generati quando si estrae un disco da
un drive. Questa classe non richiede codici tasto.
@end table

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Appendix Section: Hotkeys/Qualifiers                     ---
@comment ----------------------------------------------------------------
@node Qualificatori, Codici tasto, Classi di InputEvent, Tasti rapidi
@appendixsection Qualificatori
@cindex Qualificatori

Commodities supporta i sequenti qualificatori:

@table @asis
@item @code{lshift}, @code{left_shift}
Tasto maiuscole sinistro

@item @code{rshift}, @code{right_shift}
Tasto maiuscole destro

@item @code{shift}
Qualunque tasto maiuscole

@item @code{capslock}, @code{caps_lock}
Tasto fissa maiuscole

@item @code{caps}
Un tasto maiuscole o il tasto fissa maiuscole

@item @code{control}, @code{ctrl}
Tasto Control

@item @code{lalt}, @code{left_alt}
Tasto Alt sinistro

@item @code{ralt}, @code{right_alt}
Tasto Alt destro

@item @code{alt}
Qualunque tasto Alt

@item @code{lcommand}, @code{lamiga}, @code{left_amiga}, @code{left_command}
Tasto Amiga (o Command) sinistro

@item @code{rcommand}, @code{ramiga}, @code{right_amiga}, @code{right_command}
Tasto Amiga (o Command) destro

@item @code{numericpad}, @code{numpad}, @code{num_pad}, @code{numeric_pad}
@emph{Deve} essere usata per i tasti sul tastierino numerico

@item @code{leftbutton}, @code{lbutton}, @code{left_button}
Pulsante sinistro del mouse

@item @code{midbutton}, @code{mbutton}, @code{middlebutton}, @code{middle_button}
Pulsante centrale del mouse

@item @code{rbutton}, @code{rightbutton}, @code{right_button}
Pulsante destro del mouse

@item @code{repeat}
Questo qualificatore indica che è attiva l'autoripetizione della tastiera. È
utile solo per gli InputEvent di classe @code{rawkey}
@end table

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Appendix Section: Hotkeys/Key codes                      ---
@comment ----------------------------------------------------------------
@node Codici tasto, Esempi di tasti rapidi, Qualificatori, Tasti rapidi
@appendixsection Codici tasto

Ogni classe di InputEvent ha i propri codici tasto:

@menu
* rawkey:Codici rawkey.
* rawmouse:Codici rawmouse.
@end menu

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Appendix Subsection: Hotkeys/Key codes/rawkey key codes  ---
@comment ----------------------------------------------------------------
@node Codici rawkey, Codici rawmouse, , Codici tasto
@appendixsubsec Codici tasto per gli InputEvent di classe @code{rawkey}
@cindex Codici tasto per @code{rawkey}

@table @asis
@item @code{a}-@code{z}, @code{0}-@code{9}, @dots{}
Caratteri ASCII

@item @code{f1}, @code{f2}, @dots{}, @code{f10}, @code{f11}, @code{f12}
Tasti funzione

@item  @code{up}, @code{cursor_up}, @code{down}, @code{cursor_down}
@itemx @code{left}, @code{cursor_left}, @code{right}, @code{cursor_right}
Tasti cursore

@item  @code{esc}, @code{escape}, @code{backspace}, @code{del}, @code{help}
@itemx @code{tab}, @code{comma}, @code{return}, @code{space}, @code{spacebar}
Tasti speciali

@item  @code{enter}, @code{insert}, @code{delete}
@itemx @code{page_up}, @code{page_down}, @code{home}, @code{end}
Tasti sul tastierino numerico. Questi codici tasto @emph{devono} essere usati
con il qualificatore @code{numericpad}!
@end table

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Appendix Subsection: Hotkeys/Key codes/rawmouse key codes --
@comment ----------------------------------------------------------------
@node Codici rawmouse, , Codici rawkey, Codici tasto
@appendixsubsec Codici tasto per InputEvent di classe @code{rawmouse}
@cindex Codici tasto per @code{rawmouse}

@table @code
@item mouse_leftpress
Pressione del tasto sinistro del mouse

@item mouse_middlepress
Pressione del tasto centrale del mouse

@item mouse_rightpress
Pressione del tasto destro del mouse
@end table

Nota: per usare uno di questi codici tasto, dovete anche impostare il
qualificatore relativo, per esempio:

@example
rawmouse leftbutton mouse_leftpress
@end example

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Appendix Section: Hotkeys/Hotkey examples                ---
@comment ----------------------------------------------------------------
@node Esempi di tasti rapidi, , Codici tasto, Tasti rapidi
@appendixsection Esempi di tasti rapidi
@cindex Esempi di tasti rapidi

@table @code
@item ralt t
Tieni premuto il tasto Alt destro e premi ``t''

@item ralt lalt t
Tieni premuti i tasti Alt sinistro @emph{e} destro e premi ``t''

@item alt t
Tieni premuto uno qualunque dei tasti Alt e premi ``t''

@item rcommand f2
Tieni premuto il tasto Amiga destro e premi F2

@item numericpad enter
Premi il tasto Enter sul tastierino numerico

@item rawmouse midbutton leftbutton mouse_leftpress
Tieni premuto il tasto centrale del mouse e premi il tasto sinistro del mouse

@item diskinserted
Inserisci un disco in qualunque drive
@end table

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Appendix: Questions                                      ---
@comment ----------------------------------------------------------------
@node Quesiti, History, Tasti rapidi, Prima pagina
@appendix Quesiti frequenti

Ecco le risposte alle domande più frequenti riguardo a ToolManager:

@itemize @minus
@item Quando avvio le preferenze di ToolManager compare solo una finestra con
il testo ``Program initialization failed''. Cos'è che non va?

L'editor di preferenze verifica i requisiti di base prima di aprire la prima
finestra. Controllate che tali @ref{Requisiti, requisiti} siano
soddisfatti! Potrebbe anche non essere disponibile la memoria necessaria.
Potreste dover chiudere qualche altra applicazione prima che sia disponibile
memoria a sufficienza per eseguire l'editor di preferenze di ToolManager.
Inoltre, può esserci una sola istanza dell'editor di preferenze in esecuzione
in un dato momento.

@item Come posso avviare l'editor di preferenze di ToolManager su uno schermo
pubblico diverso dal Workbench?

Selezionate la voce @code{MUI...} dal menu Impostazioni nella
@ref{Finestra principale, finestra principale}. Selezionate poi la pagina @code{Sistema} e
inserite il nome dello schermo pubblico nel gadget string. Per ulteriori
dettagli, consultate la documentazione di @ref{MUI}.

@item Dopo aver convertito la mia vecchia configurazione di ToolManager
2.x alcune immagini non vengono più visualizzate, e alcuni pannelli non
compaiono del tutto!

ToolManager 3.0 supporta all'interno dei pannelli soltanto immagini
leggibili attraverso il picture.datatype. In questo caso, la vecchia
configurazione faceva riferimento ad alcune immagini provenienti da icone.
Per continuare a usare tali immagini, occorre installare un datatype per le
icone nel vostro sistema. Potete trovare datatype di questo tipo su Aminet,
oppure potete convertire le icone in pennelli IFF.

@item Dopo aver convertito la mia vecchia configurazione di ToolManager 2.x,
mancano alcune icone nella finestra del Workbench!

ToolManager 3.0 supporta soltanto file di icone come oggetti icona. Nella
vecchia configurazione avevate collegato agli oggetti icona degli oggetti
immagine definiti con pennelli IFF. Dovete convertire tali immagini in file
di icona per usarle con gli oggetti icona di ToolManager 3.0.

@item Quando uso dei file di icona per definire delle immagini usate in un
pannello, compaiono dei testi aggiuntivi nell'immagine, o l'immagine ha un
bordo spesso. Dove sbaglio?

Avete installato un datatype per le icone nel vostro sistema che inserisce
delle informazioni aggiuntive sull'icona all'immagine. Controllate la
documentazione dell'icon.datatype su come potete rimuovere queste aggiunte.
Per eliminare il bordo spesso, dovete indicare al datatype di non generare
il bordo normalmente associato alle icone.

@item Perché ToolManager non permette di creare più menu ``Strumenti'' o
sottomenu al suo interno?

Attualmente il Workbench non supporto menu multipli o sottomenu di
``Strumenti''. Per crearli, è necessario intervenire modificando dei
particolari @emph{interni} di AmigaOS, e ciò può causare instabilità del
sistema. Ho dunque scelto di non implementare questa rischiosa
caratteristica in ToolManager.

@item Come posso creare un pannello orizzontale?

Basta impostare come numero di colonne il numero totale di voci del
pannello.


@item Come posso creare una finestra per l'output dei programmi da Shell?

Potete creare delle finestre per l'output usando il dispositivo @code{CON:}.
Usate il nome di file seguente per creare una finestra ad apertura
automatica, con un pulsante per la chiusura e che non si chiude
immediatamente dopo il termine dell'esecuzione del programma:

@example
CON:10/10/640/100/Finestra-di-output/AUTO/CLOSE/WAIT
@end example

Il dispositivo @code{CON:} ha molte opzioni, consultate il vostro manuale di
AmigaDOS per ulteriori informazioni.


@item Come posso inserire gli argomenti in un punto intermedio in una riga
di comando Shell o ARexx?

Solitamente, tutti gli argomenti vengono aggiunti in fondo alla riga di
comando. Per inserire gli argomenti in posizioni diverse, usate la sintassi
@code{[]} similmente a quella del comando @code{alias} di AmigaShell. Per
esempio,

@example
Dir [] all
@end example

inserirà tutti gli argomenti prima della parola chiave @code{all}.

@item Come posso creare dei sotto-pannelli?

Dovete usare degli oggetti eseguibili di tipo pannello. Inserite oggetti di
questo tipo fra le voci del vostro pannello principale, la loro attivazione
causerà l'apertura/chiusura degli altri pannelli.

@item Le finestre dei pannelli scompaiono quando lo schermo del Workbench
viene chiuso e riaperto.

Avete dimenticato di impostare il nome dello schermo pubblico per la
finestra di pannello a @code{Workbench}. ToolManager chiude le finestre di
pannello quando viene chiuso lo schermo pubblico. Tuttavia, ToolManager deve
sapere su quale schermo pubblico i pannelli dovrebbero aprirsi per poterli
aprire automaticamente alla riapertura dello schermo pubblico.

@end itemize

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Appendix: History                                        ---
@comment ----------------------------------------------------------------
@node History, Ringraziamenti, Quesiti, Prima pagina
@appendix Storia di ToolManager

@comment ----------------------------------------------------------------
@comment Note to translators:
@comment This chapter doesn't need to be translated
@comment ----------------------------------------------------------------

@table @asis
@item 3.0, Release date 23.02.1997
@itemize @minus
@item Again rewritten (almost) from scratch :-)
@item Old object system removed, TM objects are now BOOPSI objects
@item Now uses memory pools
@item Delay parameter removed from Exec Objects
@item Animation support removed from Image Objects
@item Picture.datatype V43 support added to Image Objects
@item Only icon images supported for Icon Objects
@item Only images loadable via picture.datatype are supported in Dock Objects
@item Pattern & Vertical flags and Title parameter removed from Dock Objects
@item Dock Objects can now display text and images
@item Dock Objects can now be completely borderless
@item New preferences file format, hopefully more flexible
@item Converter for the ToolManager 2.x format
@item Events are now checked while the configuration is read
@item Preferences is now a MUI application: resizable window, multiple open
edit windows and Drag&Drop support
@item Changing an object name automatically updates all references to the
object.
@item Support for grouping objects.
@item All dock objects get the screen notifications
@item Added support for DOSPath 1.0
@item CLI command lines are not limited to 4KB anymore
@item Installer script
@end itemize


@item 2.1b, Release date 13.03.1996
@itemize @minus
@item Minor update to 2.1
@item Added support for WBStart 2.0
@end itemize


@item 2.1a, Release date 26.03.1995
@itemize @minus
@item Minor update to 2.1
@item Added support for ScreenNotify 1.0
@item Included newer version of WBStart-Handler
@item Included missing AutoDocs for toolmanager.library
@end itemize


@item 2.1, Release date 16.05.1993, Fish Disks #872 & #873
@itemize @minus
@item New Exec object types: Dock, Hot Key, Network
@item New Dock object flags: Backdrop, Sticky
@item New object type: Access
@item Network support
@item Editor main window is now an AppWindow
@item Gadget keyboard shortcuts in the preferences editor
@item New tooltypes for the preferences editor
@item Several bug fixes
@item Enhanced documentation
@end itemize


@item 2.0, Release date 26.09.1992, Fish Disk #752
@itemize @minus
@item Complete new concept (object oriented)
@item (Almost) Complete rewrite
@item ToolManager is now split up into two parts
@item Main handler is now embedded into a shared library
@item Configuration is now handled by a Preferences program
@item Configuration file format has changed again :-) It is an IFF File now
and resides in ENV:
@item Multiple Docks and multi-column Docks
@item Docks with new window design
@item Dock automatically detects largest image size
@item Sound support
@item Direct ARexx support for Exec objects
@item ToolManager can be used without the Workbench. If the Workbench isn't
running, it won't use any App* features.
@item Locale support
@item Path from Workbench will be used for CLI tools
@item Seperate Handler Task for starting WB processes
@end itemize


@item 1.5, Release date 10.10.1991, Fish Disk #551
@itemize @minus
@item Status Window: New/Open/Append/Save As menu items for config file
@item Edit Window: File requesters for file string gadgets
@item Added a Dock Window (a la NeXT)
@item Added a DeleteTool
@item A list of all active HotKeys can be shown
@item Tools can be moved around in the list
@item Icon positioning in the edit window added
@item Name of the program icon can be set
@item CLI tools can have an output file and a path list
@item Uses UserShell for CLI tools
@item Maximum command line length for CLI tools is now 4096 Bytes
@item AppIcons without a name are supported now
@item Workbench screen will be moved to front if you pop up the Status window
@item Workbench screen can be moved to front before starting a tool via HotKey
@item TM will wait up to 20 seconds for the workbench.library
@item Added a DELAY switch which causes TM to wait <num> seconds before adding
any App* stuff
@item renamed some tooltypes/parameters
@item some visual cues added
@item some internal changes
@end itemize


@item 1.4, Release date 09.07.1991, Fish Disk #527
@itemize @minus
@item Keyboard short cuts for tools
@item AppIcons for tools
@item Menu item can be switched off
@item Configuration file format completely changed (hopefully the last time)
@item CLI commandline parsing is now done by ReadArgs()
@item Status & edit window updated to new features
@item Safety check before program shutdown added
@item Menu item ``Open TM Window'' only appears if the program icon is
disabled
@item WB startup method changed. Now supports project icons
@item several internal changes
@end itemize


@item 1.3, Release date 13.03.1991, Fish Disk #476
@itemize @minus
@item Now supports different configuration files
@item Format of the configuration file slightly changed
@item Tool definitions can be changed at runtime
@item Now supports CLI & Workbench startup method
@item Selected icons are passed as parameters to the tools
@item Now uses the startup icon as program icon if started from Workbench
@item The position of the icon can now be supplied in the configuration file
@item The program icon can now be disabled
@item New menu entry ``Show TM Window''
@item Every new started ToolManager passes its startup parameters to the
already running ToolManager process
@end itemize


@item 1.2, Release date 12.01.1991, Fish Disk #442
@itemize @minus
@item Status window changed to a no-GZZ & simple refresh type
(this should save some bytes)
@item Status window remembers its last position
@item New status window gadget ``Save Configuration'': saves the actual tool
list in the configuration file
@item Small bugs removed in the ListView gadget handling
@item Name of the icon hard-wired to ``ToolManager''
@end itemize


@item 1.1, Release date 01.01.1991
@itemize @minus
@item Icons can be dropped on the status window
@item Status window contains a list of all tool names
@item Tools can be removed from the list
@end itemize


@item 1.0, Release date 04.11.1990
@itemize @minus
@item Initial release
@end itemize

@end table

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Appendix: Credits                                        ---
@comment ----------------------------------------------------------------
@node Ringraziamenti, MUI, History, Prima pagina
@appendix L'autore ringrazia@dots{}
@cindex Riconoscimenti
@cindex Ringraziamenti

ToolManager ha attraversato molti importanti passi di evoluzione dalla sua
prima implementazione a metà del 1990. Questi sviluppi non sarebbero stati
possibili se non avessi ricevuto molte idee e suggerimenti da vari utenti di
ToolManager@dots{}

Vorrei dunque ringraziare:

@table @asis
@item Per il test delle versioni alfa e beta, idee & segnalazioni di errori:
Osma Ahvenlampi, Stephane Barbaray, Olaf Barthel, Fionn Behrens,
Mario Cattaneo, Michael van Elst, Michael Hohmann, Markus Illenseer,
Frank Mariak, Klaus Melchior, Bernhard Moellemann, Matthias Scheler,
Ralph Schmidt, Tobias Walter.

@item Matthew Dillon
Senza il tuo @strong{eccellente} sistema di sviluppo C DICE e altri
strumenti, ToolManager non esisterebbe!

@item Tutti gli utenti che mi hanno inviato dei contributi:
Il vostro supporto ha reso possibile questa versione.

@item Tutti gli utenti che mi hanno inviato delle note:
Ho letto con piacere le vostre lettere ed e-mail.
@end table

ToolManager usa i seguenti pacchetti:

@table @asis
@item picture.datatype V43
Copyright @copyright{} 1995--1996 Ralph Schmidt, Frank Mariak &@*
Matthias Scheler

@item WBStart 2.2
Copyright @copyright{} 1991--1996 Stefan Becker

@item ScreenNotify 1.0
Copyright @copyright{} 1995 Stefan Becker

@item DOSPath 1.0
Copyright @copyright{} 1996 Stefan Becker

@item MUI
Copyright @copyright{} 1993--1997 Stefan Stuntz@*
Home page sul World Wide Web: @code{http://www.sasg.com/}.

@itemx Pophotkey.mcc, Popport.mcc, Popposition.mcc
Copyright @copyright{} 1996--1997 Klaus Melchior

@item Icone
Copyright @copyright{} 1995 Michael W. Hohmann
@end table

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Appendix: MUI                                            ---
@comment ----------------------------------------------------------------
@node MUI, Indice, Ringraziamenti, Prima pagina
@appendix Informazioni su MUI
@cindex MUI

@example
                          This application uses


                        MUI - MagicUserInterface

                (c) Copyright 1993-97 by Stefan Stuntz


MUI is a system to generate and maintain graphical user interfaces. With
the  aid  of  a  preferences program, the user of an application has the
ability to customize the outfit according to his personal taste.

MUI is distributed as Shareware. To obtain a complete package containing
lots of examples and more information about registration please look for
a  file  called  "muiXXusr.lha"  (XX means the latest version number) on
your local bulletin boards or on public domain disks.

          If you want to register directly, feel free to send


                         DM 30.-  or  US$ 20.-

                                  to

                             Stefan Stuntz
                        Eduard-Spranger-Straße 7
                             80935 München
                                GERMANY



             Support and online registration is available at

                          http://www.sasg.com/
@end example

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Unnumbered chapter: Index                                ---
@comment ----------------------------------------------------------------
@node Indice, , MUI, Prima pagina
@unnumbered Indice

@printindex cp

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Table of Contents (appears only in printed manual)       ---
@comment ----------------------------------------------------------------
@contents
@comment ----------------------------------------------------------------

@comment This is REALLY the end :-)

@bye
