@DATABASE InterfaceEditor.guide @Index INDEXNODE @$VER: IEditor.guide 2.31 (22.12.96) @AUTHOR "Simone Tellini" @(C) "Simone Tellini Software" @WIDTH 74 @NODE MAIN "Manuale di Interface Editor" Interface Editor - Manuale Utente @{" Disclaimer                 " link disclaimer}@{" Selezione Gadgets          " link "selection"} @{" Copyright                  " link copyright}@{" Menù  di IEditor           " link "menus"} @{" Aggiornamenti              " link updates}@{" Tags dei Gadget            " link "requesters"} @{" Come registrarsi " link register}@{" Muovere & Resize i gadget " link "move"} @{" Configurazione richiesta   " link requirements}@{" Il Sorgente Generato       " link "source"} @{" Introduzione               " link introduction}@{" I comandi ARexx " link arexx} @{" Iniziare con IEditor       " link starting}@{" Note                       " link "notes"} @{" Comandi da tastiera " link keyboard}@{" Ringraziamenti             " link "credits"} @{" La finestra Strumenti " link toolbar}@{" Uno sguardo sul futuro     " link "future"} @{" History " link History.txt/MAIN} @{" Cerca... " system "Run SearchGuide InterfaceEditor_ITA.guide"} @ENDNODE @NODE disclaimer "DA LEGGERE!" Standard international disclaimer: THERE IS NO WARRANTY FOR THE SOFTWARE TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHERE OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE SOFTWARE "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE SOFTWARE IS WITH YOU. SHOULD THE SOFTWARE PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY REDISTRIBUTE THE SOFTWARE AS PERMITTED BELOW, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE SOFTWARE (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE SOFTWARE TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. ----- In breve: ;) Tu usi questo programma a tuo proprio rischio. Esso è fornito "così come è", senza garanzie di qualsiasi tipo. L'autore non può essere ritenuto responsabile per l'esattezza di questo manuale e/o il programma che descrive. Qualsiasi danno causato direttamente o indirettamente dall'uso o uso errato di questo manuale e/o il programma che descrive è di unica responsabilità dell'utente. @ENDNODE @NODE copyright "Copyright e Distribuzione" Interface Editor © Copyright 1994-96 Simone Tellini Software Scritto usando DICE C v2 da Simone Tellini Piazza Resistenza 2 42016 Guastalla RE Italia Fido: 2:332/502.18 (Simone Tellini) Internet: wiz@pragmanet.it Manuale Utente © Copyright 1995-1996 Simone Tellini Software reqtools.library è © Copyright Nico François Interface Editor è (C) 1994-96 da Simone Tellini Software. Questo programma è SHAREWARE: se lo usi, dovresti @{"spedirmi" link author} la tua tassa di registrazione; in questo modo diventerai un utente registrato di IEditor, riceverai il keyfile del programma e sarai così in grado di usare IE senza alcuna limitazione. Supportare lo shareware è molto importante, ti piaciono i buoni programmi a un prezzo molto basso, non è vero? ;-) Questo programma può essere liberamente distribuito purché che tutti i file siano inclusi nella distribuzione senza modifiche. *NON* si può addebitare più di quanto faccia Fred Fish per un singolo dischetto. Questo programma *NON* può essere scaricato su BBS che reclamano il copyright sul materiale scaricato. Il key file di Interface Editor è strettamente personale, *NON* distribuibile in nessun modo, è permesso solo un backup per l'utente registrato. Quando usi questo programma per progettare GUI per un programma commerciale o shareware apprezzerei una piccola nota riguardo ciò nella documentazione del programma. Apprezzerei anche @{"ricevere" link author} una copia di quel programma, o, almeno, una demo! :-) La distribuzione commerciale di Interface Editor e/o i suoi file relativi *NON* è permessa senza consenso scritto dall'autore. Questo comprende anche la distribuzione su dischetti di copertina, riviste su dischetto etc. Io sarò contento di dare il consenso ad inserire questo programma sul dischetto di riviste o su disk-magazine se ne riceverò una copia. @{"Scrivetemi" link author} per dettagli. Solo l'output di IEditor non è assoggettato a queste regole. Il programma Patcher è liberamente distribuibile, purché non venga modificato in alcun modo. @ENDNODE @NODE register "Come registrarsi" Allora, per registrarvi ad IE dovete semplicemente compilare il "Modulo di registrazione" incluso nell'archivio, metterlo in una busta chiusa e @{"spedirmelo" link author} insieme alla vostra quota di regisrazione. A proposito di quote, ecco uno schemino riassuntivo che spero vi chiarisca le idee: ITALY LIT. 30.000 REST OF THE WORLD US $ 25 Come metodo di pagamento potete utilizzare uno dei seguenti: contanti, assegno non trasferibile intestato a Simone Tellini, vaglia postale. Per l'estero, potete usare solo EuroChecks o contanti. N.B. Se mettete i contanti nella busta, ricordatevi che potrebbero benissimo non arrivarmi! Quindi cercate di utiizzare un modo sicuro per spedirmi la vostra quota di registrazione! @ENDNODE @NODE updates "Aggiornamenti" Una volta che ti sarai registrato, riceverai uno speciale keyfile che ti permetterà di usare una qualsiasi copia di IE senza limitazioni. Così potrai procurarti aggiornamenti a IE direttamente dalle reti di distribuzione di software PD. L'ultima versione di IE, inoltre, è sempre disponibile in ogni sito Aminet, nella directory dev/gui. Gli utenti registrati con un indirizzo telematico riceveranno una E-Mail ogni volta che verrà rilasciata una nuova versione. IEditor ha anche una sua pagina WWW. L'URL è il seguente: http://www.pragmanet.it/~tellini/main.html Attualmente questa BBS supporta IEditor: - BBS: The Drake SysOp: Paolo Masetti Tel: 0522-838800 Fido node: 2:332/522 Area messaggi: IEDITOR.LOC File name: Area SUPPORT - IEditxxx.lha (es. IEdit218.lha) Magic File Name: IEDITOR Se qualche altra BBS è disponibile a supportare IEditor, ne sarei molto lieto: @{"scrivetemi" link author} che ci mettiamo d'accordo. @ENDNODE @NODE introduction "Introduzione" Interface Editor ti permette di salvare un'enorme quantità di tempo quando devi progettare un'interfaccia utente GadTools per i tuoi programmi. Questo programma è il successore di Interface Editor v1.0, che era un piccolo programma con pochissimo controllo sull'aspetto dell'interfaccia. A partire dalla versione 2.0, ho cercato di fare di IEditor un buon programma user-friendly; ho anche sviluppato l'output che, nella v1.0, era molto brutto! Queste sono le caratteristiche principali di IEditor v2.0: Una completa interfaccia utente intuition/gadtools Edita su molte differenti risoluzioni di schermo Edita/Genera sorgenti per grossi schermi autoscrolling Tutti i tipi di gadget GadTools supportati Pieno controllo sui flag e sulle tags delle finestre Pienamente controllato da mouse e tastiera Finestre multiple Font selezionabile dall'utente per ogni gadget La possibilità di cambiare risoluzione di schermo mentre sta editando Facile allineamento e dimensionamento di gadget Multipli spostamenti, cancellazioni, copie ed editing di gadget Gadget booleani, Bevel Box, MENU_IMAGE Porta ARexx ARexx Interface Editor Espandibile tramite moduli esterni ... @ENDNODE @NODE requirements "Configurazione minima richiesta" InterfaceEditor richiede il Kickstart 2.04+ e almeno 512kb di RAM (ma è consigliato 1Mb). É consigliabile utilizzare un stack minimo di 8 kbytes per IE. Queste librerie sono usate da IEditor: reqtools.library v37+ icon.library v37+ locale.library v38+ (facoltativa) asl.library v37+ gadtools.library v37+ intuition.library v37+ dos.library v37+ graphics.library v37+ diskfont.library v37+ iffparse.library v37+ rexxsyslib.library (facoltativa) Per compilare l'output di IEditor serve un compilatore C (come Dice) o un assembler con gli include 2.0 o il compilatore Amiga E (EC) v2.1b o maggiore. Se si crea il codice Assembly specificando il @{"parametro" link asmprefs} RawCode non sono necessari i file include. InterfaceEditor è stato testato su queste macchine: · Amiga 1200 68EC020 28MHz 2Mb CHIP 4Mb FAST Ram ( Blizzrd 1220/4 ) HD IDE Conner 1.2 Gb Squirrel Classic CD-ROM SCSI Pioneer DR-U124X 2 Floppy Drives Kick v39.106 - WB v39.29 ( Release 3.0 ) · Amiga 4000/40 68040 25MHz 2Mb CHIP 16Mb FAST Ram HD IDE Conner 210 Mb HD IDE Seagate ST144At 124 Mb Kick v39.106 - WB v40.42 ( Release 3.0 ) · Amiga 2000B 68000 7MHz 1Mb CHIP 2Mb FAST Ram HD SCSI 850 Mb Kick v40.63 - WB v40.42 ( Release 3.1 ) @ENDNODE @NODE starting "Iniziare con Interface Editor" Puoi eseguire Interface Editor dalla Shell o dal Workbench. Se eseguito dalla Shell, IE accetta come parametro il nome di una GUI da caricare. Anche da WB è possibile passare una GUI da caricare cliccando una volta sull'icona di IE e, premendo il tasto shift, due volte sull'icona del file voluto. Quando si sarà caricato, vedrai uno schermo con una piccola finestra: la Finestra @{"Strumenti" link toolbar}. Allora potrai caricare un'interfaccia vecchia o iniziare a crearne una nuova. Per caricare una GUI puoi selezionare la voce @{"Apri..." link "open"} nel primo menù o tu puoi cliccare sul penultimo gadget della Finestra @{"Strumenti" link toolbar} e poi selezionare il file che vuoi caricare. Per iniziare a creare una nuova interfaccia, devi cliccare sul primo gadget della finestra @{"Strumenti" link toolbar} o selezionare la voce @{"Nuovo..." link "new"} nel menù "Finestre". @ENDNODE @NODE making "Fare un Gadget" Fare un gadget è molto semplice. Innanzitutto devi selezionare la voce "Aggiungi..." nel menù "Gadget" o cliccare sul 5° gadget della @{"ToolBar" link toolbar}. Poi devi scegliere il tipo del gadget nel listview che apparirà. Ora muovi il puntatore del mouse dove vuoi piazzare l'angolo in alto a sinistra del gadget (vedrai le coordinate sulla barra dello schermo). Clicca LMB (tasto sinistro del mouse) e muovi il mouse tenendo premuto il tasto. Vedrai un rettangolo che rappresenta il tuo gadget, le cui dimensionsioni sono mostrate nella ScreenBar. Una volta che hai deciso la dimensione del gadget, rilascia il tasto del mouse. Si aprirà un requester: qui puoi editare il titolo di gadget. Dopo ciò si aprirà un'altro requester consentendoti modificare le tag del gadget. Allora, il gadget verrà creato. Se l'operazione di creazione fallisce, vedrai un rettangolo nero al posto del gadget. Qui c'è una lista dei gadget supportati da IE2: @{" BUTTON        " link "button"} @{" CHECKBOX      " link "checkbox"} @{" INTEGER       " link "integer"} @{" LISTVIEW      " link "listview"} @{" MX            " link "mx"} @{" NUMBER        " link "number"} @{" CYCLE         " link "cycle"} @{" PALETTE       " link "palette"} @{" SCROLLER      " link "scroller"} @{" SLIDER        " link "slider"} @{" STRING        " link "string"} @{" TEXT          " link "text"} @{" BOOLEAN       " link "boolean"} Nota che i gadget @{"CHECKBOX" link checkbox} e @{"MX" link mx} hanno una dimensione fissata che significa che tu non puoi farli di qualsiasi dimensione desideri (a meno che tu non setti la tag Scaled del gadget). Inoltre, nel mettere questi gadget, possono esserci alcuni problemi se usi un font più grande di Topaz 8 e non setti la tag Scaled. NOTA: i gadget @{"booleani" link boolean} non sono gestiti dalla gadtools.library, ma sono dei semplici gadget intuition. @ENDNODE @NODE selection "Selezione di gadget" Se i gadget non sono disabilitati o staccati, per selezionarne uno devi premere LMB dove non ci sono gadget, quindi (tenendo premendo il tasto del mouse) disegna un rettangolo in modo che il/i gadget che vuoi selezionare siano in parte o completamente coperti dal rettangolo. Se i gadget sono disabilitati o staccati puoi semplicemente cliccare sul gadget che desideri selezionare. Puoi sempre disegnare un box attorno a più di un gadget, per fare una selezione multipla. Inoltre, se tieni premuto il @{"tasto" link keyboard} SHIFT, i gadget attualmente attivi non verranno disattivati, ma rimarranno attivi. Quando un gadget è attivato, avrà un rettangolo attorno con quattro punti negli angoli. @ENDNODE @NODE move "Muovere i gadgets" È possibile muovere o @{"ridimensionare" link size} uno o più gadget allo stesso tempo, in base a quanti gadget sono @{"selezionati" link selection}. Per muovere un gadget, devi sempicemente clickare su di esso e quindi, tenendo premuto il pulsante, muovere il mouse. (Se vuoi spostare più di un gadget alla volta devi tener premuto anche un @{"tasto" link keyboard} Shift) Vedrai rettangoli che rappresentano i tuoi gadget, quando sono dove vuoi, semplicemente rilascia il tasto del mouse. Non è così difficile, vero? Per @{"ridimensionare" link size} un gadget devi cliccare in uno dei suoi quattro angoli; quindi muovi il mouse tenendo premuto il suo tasto. Rilascia il tasto del mouse per eseguire i cambiamenti. @ENDNODE @NODE size "Dimensionare i Gadget" Puoi scegliere la dimensione di un gadget (o più di uno) specificando la sua larghezza e altezza o dimensionandoli col @{"mouse" link move}. Nel primo caso, seleziona la voce "Gadget/Dimensioni...": un requester apparirà, inserisci qui i valori che vuoi (anche le coordinate X e Y possono essere inserite qui). @ENDNODE @NODE copy "Gadget/Copia" Questo creerà una copia dei gadget @{"selezionati" link "selection"}: dopo aver scelto questo menu, vedrai dei rettangoli rappresentanti i gadget selezionati che seguiranno il puntatore del mouse. Quando saranno dove vuoi i nuovi gadgets, premi LMB. I nuovi gadget saranno creati in quel posto e avranno TUTTI gli attributi identici ai gadget originali, incluse le etichette. @ENDNODE @NODE menus "I menù di IEditor" Qui tu trovi la descrizione di tutti i menù del mio programma: Progetto @{" Informazioni...  " link "about"} @{" Apri...          " link "open"} @{" Nuovo            " link "new"} @{" Salva            " link "save"} @{" Salva come...   " link "saveas"} @{" Parametri... " link srcparams} @{" Genera Sorgente... " link gensrc } @{" Esci...          " link "quit"} Finestre @{" Nuova...        " link "newwindow"} @{" Apri...         " link "openwindow"} @{" Chiudi          " link "closewindow"} @{" Chiudi tutte    " link "closeallwindow"} @{" Elimina         " link "discardwindow"} @{" Elimina tutte   " link "discardallwindow"} @{" Titolo...       " link "titlewindow"} @{" Flags...        " link "windowflags"} @{" IDCMP...        " link "idcmp"} @{" Dimensioni...   " link "sizewindow"} @{" Zoom...         " link "zoomwindow"} @{" Tags...         " link "windowtags"} BevelBoxes @{" Aggiungi " link addbox} @{" Modifica... " link editbox} Immagini @{" Aggiungi " link addimg} @{" Sposta " link moveimg} @{" Elimina " link deleteimg} Testi @{" Aggiungi... " link addtxt} @{" Elimina... " link deltxt} @{" Modifica... " link edittxt} @{" Move... " link movetxt} Banco di gadget @{" Crea... " link makegbank} @{" Elimina... " link delgbank} @{" Mostra... " link showgbank} @{" Nascondi... " link hidegbank} @{" Parametri... " link editgbank} @{" Stampa " link printwnd} @{" Salva...        " link "savewindow"} @{" Carica...       " link "loadwindow"} Gadgets @{" Aggiungi...     " link "making"} @{" Rimuovi         " link "delete"} @{" Seleziona tutti " link "selectall"} @{" Scelte...       " link "item"} @{" Dimensioni... " link size} @{" Tags            " link "tags"} @{" Font            " link "font"} Allinea @{" A destra       " link "right"} @{" A sinistra     " link "left"} @{" In alto        " link "top"} @{" In basso       " link "bottom"} Distribuisci @{" Orizzontalmente" link spreadhoriz} @{" Verticalmente " link spreadvert} Spaziatura @{" Setta X... " link xspacing} @{" Setta Y... " link yspacing} Clona @{" Larghezza      " link "xsize"} @{" Altezza        " link "ysize"} @{" Entrambe       " link "xysize"} @{" Ordine TabCycle " link taborder} @{" Copia           " link "copy"} @{" Salva...        " link "savegadgets"} @{" Carica...       " link "loadgadgets"} Schermo @{" Tags...         " link "screentags"} @{" Tipo...         " link "screentype"} @{" Font...         " link "getfont"} @{" DriPens...      " link "dripens"} Palette @{" Modifica...     " link "palettemodifica"} @{" Salva...        " link "savepalette"} @{" Carica...       " link "loadpalette"} @{" Salva...        " link "savescr"} @{" Carica...       " link "loadscr"} Varie @{" Menu Editor...   " link "menued"} @{" Banco immagini... " link "imgbank"} @{" ARexx Editor... " link arexxed} @{" main()... " link mained} @{" Localizzazione... " link localize} Macros @{" Tasti funzione... " link macros} @{" Aggiungi... " link addmacro} @{" Rimuovi... " link remmacro} @{" Esegui... " link execmacro} Preferenze @{" Finestra Strumenti               " link "toolswindow"} @{" Usa i Gadget                     " link "usegads"} @{" Workbench                        " link "closewb"} @{" Finestra corrente in primo piano " link "infront"} @{" Usa i Flags settati              " link "usewflags"} @{" Sorgente Assembly...             " link "asmprefs"} @{" Generatore...                    " link genprefs} @{" Genera icone                     " link "createicons"} @{" Memorizza                        " link "saveprefs"} @ENDNODE @NODE new "Progetto/Nuovo" Elimina tutti i gadgets e tutte le finestre, permettendo così di iniziare un nuovo lavoro. @ENDNODE @NODE open "Progetto/Apri..." Questo ti presenterà con un filerequester in cui devi selezionare la GUI che desideri caricare. Se hai fatto cambiamenti alla GUI in memoria che non sono stati ancora salvati ti verrà richiesto se vuoi: A) Si - Cancellare la GUI in memoria. B) Annulla - Annullare l'operazione. Quando l'operazione di caricamento è terminata sarai in grado di selezionare una finestra da aprire con il menù @{"Finestre/Apri..." link "openwindow"} @ENDNODE @NODE save "Progetto/Salva" Questo salverà la GUI attualmente in memoria col nome con cui è stata salvato l'ultima volta. Se è la prima volta che la salvi, un file-requester apparirà richiedendo il nome del file. @ENDNODE @NODE saveas "Progetto/Salva Come..." Questa ha la stessa funzione di @{"Progetto/Salva..." link "save"}, ma apre sempre il file-requester. @ENDNODE @NODE gensrc "Progetto/Genera Sorgente..." Questo ti presenterà con un filerequester in cui tu devi selezionare il nome che sarà usato per salvare il sorgente generato. Se non è stato ancora selezionato un generatore, comparirà la finestra per @{"configurarlo" link genprefs}. Altrimenti, verrà utilizzato il generatore settato in precedenza. Vedi il capitolo @{" Il Sorgente Generato " link "source"} per ulteriori informazioni. @ENDNODE @NODE closewb "Preferenze/Workbench" Questo proverà a chiudere il Workbench (o aprirlo se è chiuso). Se chiudi il WB e poi esci da IEditor, il Workbench sarà automaticamente riaperto. @ENDNODE @NODE about "Progetto/Informazioni..." Penso che già sai ciò che fà, non è vero? Beh, apre quella finestra con informazioni di copyright ed il mio indirizzo che dovresti vedere ogni volta che carichi Interface Editor (a meno che tu non sia un utente registrato ;). @ENDNODE @NODE quit "Progetto/Esci" Selezionando questa voce, lascerai IEditor. Se la GUI corrente non stata salvata, IE ti chiederà se vuoi "Salva", salvarla in formato binario, "Esci", abbandonare immediatamente o "Cancella", non abbandonare. @ENDNODE @NODE delete "Gadgets/Rimuovi" Selezionando questa voce, un requester ti chiederà se davvero vuoi cancellare i gadget selezionati. Rispondendo si, IEditor li cancellerà, per sempre. È possibile cancellare i gadgets anche premendo il @{"tasto" link keyboard} 'DEL'. RICORDA: Una volta che un gadget è cancellato, non puoi riportarlo indietro! @ENDNODE @NODE tags "Gadgets/Tags..." Questo aprirà un requester per editare le tags dei gadget @{"selezionati" link selection}. Per tutti i tipi di gadget gadtools sono presenti questi gadget: Titolo: Inserisci qui il testo del gadget. Etichetta: Questo identificherà il gadget nel sorgente. Nota che se tu non lo specifichi, sarà creato quando viene generato il sorgente. Posizione Questo ti permette di selezionare dove il testo del del titolo: gadget deve stare. Underscore: Settalo se vuoi una lettera sottolineata nel testo del gadget. La lettera da sottolineare deve essere preceduta da "_". Titolo evidenziato: Settalo se vuoi che il titolo sia scritto con la penna Highlight dello schermo. Con alcuni tipi di gadget non ha effetto. Altri gadget sono presenti a seconda del tipo di gadget. Seleziona il tipo su cui vuoi saperne di più: @{" BUTTON        " link "button"} @{" CHECKBOX      " link "checkbox"} @{" INTEGER       " link "integer"} @{" LISTVIEW      " link "listview"} @{" MX            " link "mx"} @{" NUMBER        " link "number"} @{" CYCLE         " link "cycle"} @{" PALETTE       " link "palette"} @{" SCROLLER      " link "scroller"} @{" SLIDER        " link "slider"} @{" STRING        " link "string"} @{" TEXT          " link "text"} Questo tipo di gadget non è gestito dalla gadtools.library, così non ha nessuna tag, ma forse vorrai sapere quali parametri puoi modificare... ;) @{" BOOLEAN       " link "boolean"} @ENDNODE @NODE left "Gadgets/Allinea/A sinistra" Questo ti chiedrà di cliccare sul gadget che ha il margine di sinistra a cui vuoi allineare i gadget. Quando clicchi sul gadget tutti i gadget @{"selezionati" link "selection"} erediteranno la coordinata del margine sinistro del gadget cliccato. @ENDNODE @NODE right "Gadgets/Allinea/A destra" Questo ti chiederà di cliccare sul gadget che ha il margine di destra a cui vuoi allineare i gadget. Quando clicchi sul gadget tutti i gadget @{"selezionati" link "selection"} erediteranno la coordinata del margine destro del gadget cliccato. NOTA: Questo potrebbe non funzionare sempre quando allinei al margine di destra di un gadget @{"Palette" link "palette"}. La gadtools.library rende le dimensioni di questo gadget tali da adattarlo all'interno dell'area specificatae ciò rende possibile che il gadget sia in effetti più piccolo di quanto specificato. @ENDNODE @NODE top "Gadgets/Allinea/In alto" Questo ti chiederà di cliccare sul gadget che ha il margine superiore a cui vuoi allineare i gadget. Quando clicchi sul gadget tutti i gadget @{"selezionati" link "selection"} erediteranno la coordinata del margine superiore del gadget cliccato. NOTA: Potrebbe non funzionare quando provi ad allineare un gadget @{"MX" link "mx"}, se il gadget usa un font più alto di 8 punti e non ha settata la tag scaled. @ENDNODE @NODE bottom "Gadgets/Allinea/In basso" Questo ti chiederà di cliccare sul gadget che ha il margine inferiore a cui vuoi allineare i gadget. Quando clicchi sul gadget tutti i gadget @{"selezionati" link "selection"} erediteranno la coordinata del margine inferiore del gadget cliccato. NOTA: Queto può non funzionare quando allinei al margine inferiore di un gadget @{"LISTVIEW" link "listview"}. La gadtools.library dimensiona il gadget in modo da farlo stare nell'area specificata, ciò può rendere il gadget più piccolo di quanto specificato. NOTA 2: Può non funzionare se provi ad allineare un gadget @{"MX" link "mx"}, se usa un font più alto di 8 punti e non ha settata la tag scaled. @ENDNODE @NODE xsize "Gadgets/Clona/Larghezza" Questo ti chiederà di cliccare sul gadget che ha la larghezza che vuoi clonare. Quando clicchi sul gadget desiderato tutti i gadget @{"selezionati" link "selection"} prenderanno la stessa sua larghezza. @ENDNODE @NODE ysize "Gadgets/Clona/Altezza" Questo ti chiederà di cliccare sul gadget che ha l'altezza che vuoi clonare. Quando clicchi sul gadget desiderato tutti i gadget @{"selezionati" link "selection"} prenderanno la stessa sua altezza. @ENDNODE @NODE xysize "Gadgets/Clona/Entrambe" Questo ti chiederà di cliccare sul gadget che ha le dimensioni che vuoi clonare. Quando clicchi sul gadget desiderato tutti i gadget @{"selezionati" link "selection"} prenderanno le sue stesse dimensioni. @ENDNODE @NODE loadgadgets "Gadgets/Carica..." Questo aprirà un filerequester ASL con cui puoi selezionare un file di gadget precedentemente salvati. Quei gadget saranno messi nella finestra attiva e non sostituiranno i gadget già esistenti in essa. @ENDNODE @NODE savegadgets "Gadgets/Salva..." Questo salverà tutti i gadgets @{"selezionati" link "selection"}. @ENDNODE @NODE item "Gadgets/Scelte..." Questo aprirà l'editor delle Scelte: consiste in una listview in cui puoi vedere le scelte che il gadget @{"selezionato" link "selection"} ha, uno string gadget che ti di modificare le scelte e tre pulsanti: Nuovo: Aggiunge una nuova voce alla lista. Elimina: Cancella la voce selezionata. Ok: (=ESC) Chiude l'editor. Questa funzione funziona solo con i gadget @{"LISTVIEW" link "listview"}, @{"MX" link "mx"} e @{"CYCLE" link "cycle"}. Per gli ultimi due, sei obbligato ad inserire almeno DUE voci. @ENDNODE @NODE font "Gadgets/Font..." Questo aprirà un ASL Font Requester in cui puoi selezionare un font. Quest font sarà usato per tutti i gadget @{"selezionati" link "selection"}. @ENDNODE @NODE selectall "Gadgets/Seleziona tutti" Sì! Hai indovinato! Questo selezionerà tutti i gadget della finestra corrente. ;) @ENDNODE @NODE newwindow "Finestre/Nuova..." Questo aprirà una nuova finestra vuota. Puoi aprire quante finestre vuoi (devi avere abbastanza memoria, naturalmente). @ENDNODE @NODE discardwindow "Finestre/Elimina" L'attuale finestra attiva sarà cancellata dalla memoria. FAI ATTENZIONE! @ENDNODE @NODE discardallwindow "Finestre/Elimina tutte" Tutte le finestre attive saranno cancellate dalla memoria. STAI MOLTO ATTENTO! @ENDNODE @NODE openwindow "Finestre/Apri..." Apparirà una lista delle finestre attualmente in memoria: clicca su quella che vuoi aprire. Puoi usare anche i @{"tasti" link keyboard} freccia per andare su e giù nella lista, il @{"tasto" link keyboard} RETURN per selezionare e il @{"tasto" link keyboard} 'ESC' per terminare. @ENDNODE @NODE loadwindow "Finestre/Carica..." Questo aprirà un filereq ASL con cui puoi scegliere una finestra da caricare. La finestra selezionata sarà aggiunta alle altre finestre dell'interfaccia. @ENDNODE @NODE savewindow "Finestra/Salva..." Questo apre un filereq in cui tu puoi selezionare il nome con cui salvare la finestra attiva. @ENDNODE @NODE windowflags "Finestre/Flags..." Questo aprirà una lista dei flag per le finestre: puoi scegliere quelli che desideri cliccandoci su. Quelli selezionati saranno marcati da questo '*'. Nota che i flag non sono usati, a meno che tu non abbia settato la voce @{" Preferenze/Usa i flags settati " link "usewflags"}. @ENDNODE @NODE idcmp "Finestre/IDCMP..." Questo aprirà una lista degli IDCMP: puoi scegliere quelli che desideri cliccandoci su. Quelli selezionati saranno marcati da questo '*'. NOTA: Nessuno dei flag IDCMP è in effetti usato dentro IEditor. I flag funzioneranno solo nel sorgente generato. @ENDNODE @NODE windowtags "Finestre/Tags..." Questo aprirà una finestra in cui puoi editare la più importanti tags della finestra. Nella finestra troverai i seguenti gadget: ScreenTitle Puoi scrivere un titolo di schermo alternativo qui dentro. Questo sarà il titolo dello schermo quando la finestra è attiva. AutoAdjust Quando questo gadget è checkato Intuition automaticamente aggiusterà la posizione della finestra e le sue dimensioni per forzarla ad adattarsi allo schermo. FallBack Quando la tua finestra si deve aprire su uno schermo specifico e quello schermo non è disponibile si aprirà automaticamente sullo schermo di default quando questa tag è settata. MouseQueue Questo ti permette di assegnare il massimo numero di messaggi MOUSEMOVE che saranno incodati alla tua porta messaggio in una sola volta. RptQueue Lo stesso di MouseQueue solo che questa volta indica il massimo numero di messaggi RAWKEY/VANILLAKEY. Notify Depth Se questa tag è settata, riceverai un messaggio IDCMP_CHANGEWINDOW quando la tua finestra viene spostata davanti o dietro. Menu Help Se settato, abilita la caratteristica MenuHelp per questa finestra. Tablet Messages Richiede gli IntuiMessages estesi per la tua finestra, così puoi ricevere gli eventi IESUBCLASS_NEWTABLET con gli IntuiMessages. Porta IDCMP Condivisa Se settato,  indica  che  questa  finestra deve utilizzare una @{"porta IDCMP condivisa" link sharedport}. Nel Box Localizza, troverai alcuni checkbox che ti permetteranno di decidere cosa localizzare nella finestra. @ENDNODE @NODE closewindow "Finestre/Chiudi" Questo chiuderà la finestra attiva, consentendoti di salvare la memoria allocata per essa e per i suoi gadget. Se la vuoi riaprire, seleziona la voce @{"Apri..." link "openwindow"}. @ENDNODE @NODE closeallwindow "Finestre/Chiudi tutte" Questo chiuderà tutte le finestre del tuo GUI, consentendoti di salvare la memoria allocata per esse e per i loro gadget. Se le vuoi riaprire, seleziona la voce @{"Apri..." link "openwindow"}. @ENDNODE @NODE titlewindow "Finestre/Titolo..." Questo aprirà il requester per il titolo della finestra, in cui puoi specificare il titolo della finestra (Noo! ;) e la sua etichetta. Nota che se non specifichi un'etichetta, sarà creata da IE quando generi il tuo sorgente. @ENDNODE @NODE sizewindow "Finestre/Dimensioni..." Questo aprirà un requester in cui tu puoi specificare tutte le tags di dimensione delle finestre, che sono: MinWidth, MinHeight, MaxWidth, MaxHeight: questi determinano le minime e massime dimensioni della finestra. Premendo il gadget "*" vicino ai gadget integer, la dimensione della finestra attiva sarà copiata in essi. Inner Width, Inner Height: se selezionati, questi determineranno la dimensione interna della finestra, trascurando la dimensione del bordo o la barra del titolo. I gadget Ok e Cancella rispettivamente confermano o annullano l'operazione. @ENDNODE @NODE zoomwindow "Finestre/Zoom..." Questo aprirà un requester in cui tu troverai questi gadget: Top: coordinata Y dell'angolo superiore sinistro che la finestra dovrà assumere quando viene premuto il gadget zoom. -1 indica che la finestra deve rimanere dov'è. (Kick 3.0) Left: coordinata X dell'angolo superiore sinistro che la finestra dovrà assumere quando viene premuto il gadget zoom. -1 indica che la finestra deve rimanere dov'è. (Kick 3.0) Width: Indica la larghezza che la finestra assumerà quando viene premuto lo zoom gadget. Height: Indica l'altezza che la finestra assumerà quando viene premuto lo zoom gadget. Ci sono anche quattro gadget "*": premendoli le dimensioni e la posizione della finestra saranno copiate nei rispettivi gadget integer. @ENDNODE @NODE makegbank "Finestre/Banco di gadget/Crea..." Questa funzione permette di raggruppare tutti i gadget @{"selezionati" link selection} in un "banco di gadget". Vedi la sezione @{"Parametri" link editgbank} per una descrizione del requester che apparirà dopo aver creato un banco. Per banco di gadget, intendo un gruppo di gadget che possono essere attaccati o staccati a piacere dalla finestra in cui sono posti. Lo scopo principale per cui ho inserito questa feature in IEditor, è per creare dei requester simili al requester delle preferenze di GoldEd o ai requester a "pagine" tipici di Word o Excel (aaargh! ;-). @ENDNODE @NODE delgbank "Finestre/Banco di gadget/Elimina..." Selezionando questa voce, verrà aperta una finestra contenente una lista dei banchi di gadget presenti nella finestra. Selezionandone uno, verrà eliminato e così pure tutti i gadget che lo formavano. Il simbolo "(---)" significa "nessun banco": scegliendolo si cancellerà l'operazione. @ENDNODE @NODE showgbank "Finestre/Banco di gadget/Mostra..." Selezionando questa voce, verrà aperta una finestra contenente una lista dei banchi di gadget presenti nella finestra. Selezionandone uno, verrà mostrato. Il simbolo "(---)" significa "nessun banco": scegliendolo si cancellerà l'operazione. @ENDNODE @NODE hidegbank "Finestre/Banco di gadget/Nascondi..." Selezionando questa voce, verrà aperta una finestra contenente una lista dei banchi di gadget presenti nella finestra. Selezionandone uno, verrà nascosto. Ciò può risultare molto utile per "liberare" la finestra e poter disegnare comodamente un altro banco di gadget al suo posto. Il simbolo "(---)" significa "nessun banco": scegliendolo si cancellerà l'operazione. @ENDNODE @NODE editgbank "Finestre/Banco di gadget/Parametri..." Selezionando questa voce, verrà aperta una finestra contenente una lista dei banchi di gadget presenti nella finestra. Il simbolo "(---)" significa "nessun banco": scegliendolo si cancellerà l'operazione. Scegliete quello che volete modificare e si aprirà una finestra contenente questi gadget: - Label Etichetta del banco di gadget - Mostra all'apertura Se è  settato,  il  banco  verrà mostrato automaticamente     all'apertura     della finestra che lo contiene. @ENDNODE @NODE getfont "Schermo/Font..." Questo aprirà il Font Req ASL in cui tu puoi selezionare un nuovo font per lo schermo. Nota che questo interesserà il codice sorgente solo se la generazione dello schermo è @{"attiva" link srcparams}. @ENDNODE @NODE dripens "Schermo/DriPens..." Questo aprirà un requester in cui puoi editare le DriPens, che sono una matrice di numeri di penne che sono usati per creare il nuovo aspetto del SO 2.0. In questo req troverai questi gadget: Pens In questo gadget ciclico puoi selezionare la pen da editare. Attualmente le seguenti penne sono supportate: DETAILPEN DetailPen compatibile 1.3 BLOCKPEN BlockPen compatibile 1.3 TEXTPEN Usato per il rendering dei testi dei gadget e i titoli delle finestra. SHINEPEN Usato per rappresentare il lato chiaro dei gadget e i bordi delle finestre. SHADOWPEN Usato per rappresentare il lato scuro dei gadget e i bordi delle finestre. FILLPEN Usato per rappresentare lo sfondo di un gadget selezionato e i bordi delle finestre quando sono attive. FILLTEXTPEN Usato per rappresentare i testi dei gadget selezionati e i titoli delle finestra attive. BACKGROUNDPEN Usato per rappresentare lo sfondo dei gadget selezionati. HIGHLIGHTTEXTPEN Usato per rappresentare i testi di gadget con il flag Highlight settato. NOTA: Le seguenti tre pens sono solo disponibili sotto 3.0. BARDETAILPEN Usato per rappresentare il testo dei menù NewLook. BARBLOCKPEN Usato per rappresentare lo sfondo dei menù NewLook. BARTRIMPEN Usato per rappresentare la linea sotto la barra dei menù. Palette Con questo gadget puoi cambiare la DriPen corrente. @ENDNODE @NODE palettemodify "Schermo/Colori/Modifica..." Questo aprirà un color requester standard ReqTools, che ti permetterà di cambiare la palette dello schermo. @ENDNODE @NODE paletteload "Schermo/Colori/Carica..." Questo aprirà un file-requester ASL in cui puoi selezionare un file IFF-ILBM. La palette di quel file sarà usata per lo schermo. @ENDNODE @NODE palettesave "Schermo/Colori/Salva..." Questo aprirà un file-requester ASL in cui puoi inserire il nome del file per i colori. IEditor salva la mappa di colore in un file in formato IFF-ILBM. @ENDNODE @NODE screentags "Schermo/Tags..." Nell'editor per le tags dello schermo troverai i seguenti gadget: Left, Top Questi specificano la posizione dell'angolo in alto a sinistra dello schermo. Title In questo gadget puoi scrivere il titolo dello schermo. Questo è il titolo che sarà mostrato quando non ci sono finestre attive che hanno il loro titolo di schermo. Show Title Se non è settata, lo schermo non avrà la barra del titolo. Behind Settando questo, lo schermo sarà aperto dietro gli altri. Questo ti permette di prepararlo prima di metterlo davanti. Quiet Dice ad Intuition di non disegnare i gadget di sistema dello schermo e il suo titolo. Type Questo gadget ti permetterà di cambiare il tipo di schermo per cui stai lavorando. I seguenti tipi sono supportati: CUSTOMSCREEN Lo schermo della tua GUI non può essere usato da altri programmi. PUBLICSCREEN Lo schermo della tua GUI può essere usato da qualsiasi altro programma. Overscan Se questo è settato, nel sorgente generato non ci sarà la definizione della dimensione dello schermo attraverso SA_Width & SA_Height, ma sarà usata SA_Overscan al loro posto. Pub Name Se inserisci qui una stringa, lo schermo sarà uno schermo pubblico, il cui nome è questo. Full Palette Se settata, quando lo schermo viene aperto, tutti i suoi colori saranno sovrascritti dalla serie di colori delle preferenze. Error Code Se settata, nel sorgente sarà generata una variabile in cui sarà messo un codice di errore esteso nel caso in cui OpenScreenTagList fallisca. Draggable Se non è settata, lo schermo non sarà spostabile con la barra del titolo. Questo funziona solo con kick v39+. Exclusive Settalo se non vuoi mai che il tuo schermo condivida il display con un altro. Questo significa che lo schermo non può essere abbassato e non apparirà dietro ad altri schermi che sono abbassati. Questo funziona solo con kick v39+. Share Pens Se settata, Intuition otterrà le penne per il tuo schermo in modo condiviso. Questo funziona solo con kick v39+. Interleaved Richiede ad Intuition di allocare una bitmap interleaved per il tuo schermo. Questo funziona solo con kick v39+. Like Workbench Settalo se vuoi uno schermo proprio come quello del Workbench. Questo funziona solo con kick v39+. MinimizeISG Dice ad Intuition di usare il più piccolo Inter Screen Gap possibile per il tuo schermo. Questo funziona solo con kick v40+. @ENDNODE @NODE screentype "Screen/Change Type..." Questo aprirà il requester di modo di schermo ASL. Nel requester di modo di schermo tu puoi cambiare tutte le cose importanti circa lo schermo. I MODI VGA E A2024 POSSONO SOLO ESSERE USATI CON MONITOR VGA/MULTISYNC O A2024! L'USO DI QUESTI MODI DI SCHERMATA SU UN MONITOR RGB STANDARD PU RISULTARE SERIAMENTE DANNOSO PER IL MONITOR! @ENDNODE @NODE savescr "Schermo/Salva..." Questo aprirà un ASL File-requester in cui tu puoi inserire il nome del file in cui tu vuoi salvare la definizione di schermo corrente. @ENDNODE @NODE loadscr "Schermo/Carica..." Questo aprirà un ASL File-requester in cui tu puoi selezionare un file da cui caricare la definizione di schermo. @ENDNODE @NODE localize "Varie/Localizzazione..." Questo aprirà un requester in cui troverai questi gadgets: Catalogo nome  del   catalogo   della    tua   applicazione (al nome verrà poi aggiunto ".catalog" da IE) Unisci Inserire qui il path  di  un  file .cd da unire al file generato da IE. In questo modo è possibile inserire  nel  catalogo  altre  stringhe  oltre  a quelle presenti nella GUI. Il file specificato verrà copiato  all'inizio  del nuovo  file .cd,  in  modo  da  evitare  di  dover ricompilare tutta la vostra applicazione quando si aggiunge  o   toglie   una   stringa   nella  GUI. Ovviamente sarà però poi necessario ricompilare la GUI del vostro programma qualora venga aggiunta  o rimossa una stringa dal file .cd (e .ct) prodotto. Nota: dalla versione 2.31 di IEditor, è fortemente consigliato l'uso   della  funzione "Importa..." al posto di questa. Built In Inserire qui  la  lingua  di  default  del  vostro programma. Versione Versione minima del catalogo da aprire.  0  indica che va bene una versione qualsiasi. Attivata Attiva la localizzazione della vostra GUI. Linguaggi Qui puoi vedere i linguaggi per i quali IE creerà i files di localizzazione. Nuovo Aggiungi un nuovo linguaggio. Devi specificare il nome  del  linguaggio  e  il  nome  del  file  di traduzione che verrà creato per esso. Nota  che   il  suffisso ".ct"   è   aggiunto automaticamente da IEditor. Elimina Questo  rimuoverà  il  linguaggio  selezionato  e tutte le traduzioni relative ad esso. Stringhe Qui puoi gestire tutte le  stringhe  per  le  tue applicazioni.   In   questo   modo  puoi  gestire l'intero processo di localizzazione da IEditor. Un doppio click su una stringa apre il  requester spiegato di seguito. Nuova Aggiunge una nuova stringa al database. Elimina Rimuove una stringa  dal  database.  Naturalmente non puoi rimuovere una stringa usata dalla GUI. Importa... Questo ti permette di  leggere  un  file .cd  ed importare tutte le stringhe che contiene in IE. Questi sono i gadget principali del requester per le stringhe: Stringa La stringa che stai editando. Nota che  qui  puoi modificare solo le stringhe che  non  sono  usate dalla GUI: cambiare una stringa usata  dalla  GUI non avrà alcun effetto. ID Etichetta per la stringa. Potrai quindi riferirti alla stringa usando "CatCompArray[ ID ].cca_Str" nel tuo codice. Le etichette per le stringhe usate nella GUI sono assegnate  da   IEditor   quando   si  genera  il sorgente. Traduzioni Traduzioni per la stringa. @ENDNODE @NODE requesters "Gadget Requesters" Seleziona il tipo di cui ti piacerebbe sapere di più: @{" BUTTON    " link "button"} @{" CHECKBOX  " link "checkbox"} @{" INTEGER   " link "integer"} @{" LISTVIEW  " link "listview"} @{" MX        " link "mx"} @{" NUMBER    " link "number"} @{" CYCLE     " link "cycle"} @{" PALETTE   " link "palette"} @{" SCROLLER  " link "scroller"} @{" SLIDER    " link "slider"} @{" STRING    " link "string"} @{" TEXT       " link "text"} @{" BOOLEAN    " link "boolean"} @ENDNODE @NODE button "BUTTON" Queste sono le tags che puoi specificare con IE: Disabled Quando questa opzione è attivata il gadget creato sarà creato disabilitato. Immediate Quando questa etichetta è settata, il gadget invierà un messaggio IDCMP_GADGETDOWN quando viene premuto. Questo funziona solo con kick v39+. @ENDNODE @NODE checkbox "CHECKBOX" Queste sono le tags che puoi specificare con IE: Disabled Quando questa opzione è attivata il gadget creato sarà creato disabilitato. Checked Per default il gadget creato è disattivato. Quando selezioni questa opzione il gadget sarà creato "checkato". Scaled Questa tag funziona solo con Kickstart 3.0+. Se è settata, sarai in grado di cambiare la dimensione del gadget checkbox. NOTA: se usi un font più alto di 8 punti, il gadget non sarà messo dove lo disegni, ma un po' più giù. Settando questa tag, esso sarà messo esattaamente. @ENDNODE @NODE integer "INTEGER" Queste sono le tags che puoi specificare con IE: Disabled Quando questa opzione è attivata il gadget creato sarà creato disabilitato. Tab Cycle Se questa tag è settata, quando l'utente preme il tasto TAB mentre il gadget è attivo, il gadget successivo sarà attivato. Immediate Quando questa tag è settata, il gadget invierà un messaggio IDCMP_GADGETDOWN quando viene premuto. Questo funziona solo con kick v39+. Exit Help Quando è settata e l'utente preme il tasto HELP mentre il gadget creato è attivo il tuo programma riceverà un messaggio speciale chiedendo un aiuto. Puoi identificare questo messaggio speciale quando il campo Code dell'IntuiMessage è 0x5F. Replace Mode Questo tipo di gadget è normalmente creato nel modo insert. Settando questa tag sarà creato nel modo di sostituzione, ciò significa che quando l'utente preme un tasto, sovrascriverà il carattere sotto il cursore. Number Normalmente il gadget è creato con 0 come il suo valore iniziale. Qui tu puoi inserire il valore con cui vuoi che sia creato. MaxChars In questo gadget tu puoi assegnare il massimo numero di cifre che possono essere inserite in questo gadget. Justification Con questo gadget tu puoi assegnare il posto dove i numeri dovrebbero apparire nel gadget. @ENDNODE @NODE listview "LISTVIEW" Queste sono le tags che puoi specificare con IE: Disabled Quando questa opzione è attivata il gadget creato sarà creato disabilitato. Con questo tipo di gadget, questa tag funziona solo col kick v39+. Read Only Quando setti questa tag il gadget creato sarà "a sola lettura" che significa che i nomi nella lista non potranno essere selezionati. Show Selected Con questa opzione attivata il nome che selezioni sarà mostrato in un piccolo box proprio sotto il gadget. NOTA: Sotto Kickstart 3.0 questo è stato cambiato! Sotto 3. 0 l'entrata selezionata sarà mostrata con un differente colore di sfondo. Top Voce che deve essere visibile in alto nel listview. Make Visible Numero della voce che deve essere forzata dentro l'area visibile del listivew facendo lo scroll minimo. Questa tag sovrascrive "Top" e funziona solo con kick v39+. MultiSelect Permette  di   usare    il    listview    in   modo multiselezione.  Questa  feature  funziona  solo  a partire dal kickstart v39. Leggi @{"questa sezione" link multiselectsrc} per informazioni su come usare le listview multiselect. Scroll Width In questo gadget tu puoi inserire la larghezza in pixel del gadget @{"SCROLLER" link "scroller"}. Max Pen Il massimo numero di penna usato per il rendering da un callback hook personale. Questo funziona solo con kick v39+. Selected Numero della voce che dovrebbe essere selezionata. Spacing In questo gadget puoi inserire il numero di pixel che saranno usati come spazio tra i nomi della lista. Item Height Inserisci qui l'esatta altezza di una voce. Questo è normalmente utile per listviews che usano la tag GTLV_CallBack. Questo funziona solo con kick v39+. @ENDNODE @NODE mx "MX" Queste sono le tags che puoi specificare con IE: Disabled Quando questa opzione è attivata il gadget creato sarà creato disabilitato. Con questo tipo di gadget, questa tag funziona solo col kick v39+. Scaled Questa tag funziona solo con Kickstart 3.0+. Se è settata, sarai in grado di cambiare la dimensione del gadget mx. NOTA: se usi un font più alto di 8 punti, il gadget non sarà messo dove lo disegni, ma un pò più giù. Settando questa tag, esso sarà messo esattaamente. Title Place Esso indica dove il titolo dovrebbe apparire. Active Questo gadget ti permette di assegnare l'opzione che sarà attiva quando il gadget verrà creato. Spacing In questo gadget tu puoi inserire il numero di pixel che saranno usati come spazio tra le opzioni. @ENDNODE @NODE number "NUMBER" Queste sono le tags che puoi specificare con IE: Number Per default il gadget mostra 0. Qui dentro tu puoi cambiare il valore che il gadget creato avrà. Border Quando è settata il gadget creato avrà un bordo recessed disegnato attorno esso. Front Pen La pen da usare per stampare il numero. -1 dice a IE di non usare questa tag nel sorgente. Questo funziona solo con kick v39+. Back Pen La pen da usare per disegnare lo sfondo del numero. -1 dice a IE di non usare questa tag nel sorgente. Questo funziona solo con kick v39+. Justification Determina dove rappresentare il numero all'interno del box del gadget. Questo funziona solo con kick v39+. Sotto v39, devi anche settare la tag Clipped, se setti questa, altrimenti il testo non sarà stampato. Format Stringa di formattazione in stile C da applicare al numero prima di mostrarlo. Assicurati di usare il modificatore 'l' (long). Questo funziona solo con kick v39+. Clipped Se è settata, il testo del gadget sarà clipped alle dimensioni del gadget. Questo funziona solo con kick v39+. Max Number Len Questo indica il massimo numero di byte che possono essere generati applicando la stringa "Format". @ENDNODE @NODE cycle "CYCLE" Queste sono le tags che puoi specificare con IE: Disabled Quando questa opzione è attivata il gadget creato sarà creato disabilitato. Active Questo gadget ti permette di assegnare l'opzione che sarà attiva quando il gadget verrà creato. @ENDNODE @NODE palette "PALETTE" Queste sono le tags che puoi specificare con IE: Disabled Quando questa opzione è attivata il gadget creato sarà creato disabilitato. Color In questo gadget tu puoi inserire il colore che è attivo nel gadget creato. Depth La profondità ti permette di controllare la quantità di colori che sono mostrati nel gadget creato. 1 = 2 colori 2 = 4 colori ...... 8 = 256 colori NOTA: Attualmente solo un valore tra 1 e 8 è permesso. Color Offset Ci potrebbero essere volte che vuoi avere solo una parte dei colori disponibili nel gadget palette. Questo gadget e il gadget Depth possono far ciò. Se tu vuoi avere il 2° e 3° colore su uno schermo di 4 colori fai quanto segue: Assegna Depth a 1 Assegna Color Offset a 1 In questo modo otterrai il gadget che vuoi. Indicator Width Questa etichetta indica la larghezza desiderata dell'indicatore del colore selezionato. Se è uguale a 0, l'indicatore non sarà creato. NOTA: Questa tag non funziona con kick v39+. Indicator Height Questa etichetta indica la l'altezza desiderata dell'indicatore del colore selezionato. Se è uguale a 0, l'indicatore non sarà creato. NOTA: Questa tag non funziona con kick v39+. Num Colors Numero di colori da mostrare nel gadget. Questo sovrascrive "Depth" e permette numeri che non sono potenze di 2. Questo funziona solo con kick v39+. @ENDNODE @NODE scroller "SCROLLER" Queste sono le tags che puoi specificare con IE: Disabled Quando questa opzione è attivata il gadget creato sarà creato disabilitato. Immediate Quando questa tag è settata, il gadget invierà un messaggio IDCMP_GADGETDOWN quando viene premuto. Questo funziona solo con kick v39+. Rel Verify Quando è settata la tua finestra riceverà un messaggio quando l'utente rilascia il tasto sinistro del mouse mentre il puntatore è ancora sul gadget. Top Inserire la posizione visibile nell'area che lo scroller rappresenta qui dentro. Total Inserire il numero totale di posizioni che lo scroller rappresenta qui dentro. Visible Inserire il numero di posizioni visibili che lo scroller rappresenta qui dentro. Arrows Quando è settata lo scroller creato avrà delle frecce. Inserisci qui la dimensione delle frecce. Freedom Con questo gadget tu puoi assegnare la direzione in cui lo scroller è regolabile. @ENDNODE @NODE slider "SLIDER" Queste sono le tags che puoi specificare con IE: Disabled Quando questa opzione è attivata il gadget creato sarà creato disabilitato. Rel Verify Quando è settata la tua finestra riceverà un messaggio quando l'utente rilascia il tasto sinistro del mouse mentre il puntatore è ancora sul gadget. Immediate Quando questa tag è settata, il gadget invierà un messaggio IDCMP_GADGETDOWN quando viene premuto. Questo funziona solo con kick v39+. Min Inserisci il minimo livello dello slider qui dentro. Max Inserisci il massimo livello dello slider qui dentro. Level Per default la posizione dello slider è 0. Qui dentro tu puoi inserire il livello che lo slider avrà quando verrà creato. Max Level Len Massima lunghezza in caratteri della stringa di livello quando è stampata vicino allo slider. Questo funziona solo con kick v39+. Level Format Qui dentro tu puoi inserire una stringa di formattazione in stile C per l'indicatore di livello. Level Place Con questo gadget determini la posizione in cui la freccia di livello è rappresentata. Max Pixel Len Indica la massima dimensione di pixel sfruttata dal l'indicatore di livello per qualsiasi valore dello slider. Questo è utile nel momento in cui si usano font proporzionali. Questo funziona solo con kick v39+. Justification Determina come la schermata di livello deve essere giustificata entro il suo spazio. Questo funziona solo con kick v39+. Freedom Con questo gadget tu puoi assegnare la direzione in cui lo slider è regolabile. @ENDNODE @NODE string "STRING" Queste sono le tags che puoi specificare con IE: Disabled Quando questa opzione è attivata il gadget creato sarà creato disabilitato. Immediate Quando questa tag è settata, il gadget invierà un messaggio IDCMP_GADGETDOWN quando viene premuto. Questo funziona solo con kick v39+. Tab Cycle Se questa tag è settata, quando l'utente preme il tasto TAB mentre il gadget è attivo, il gadget successivo sarà attivato. Exit Help Quando è settata e l'utente preme il tasto HELP mentre il gadget creato è attivo il tuo programma riceverà un messaggio speciale chiedendo un aiuto. Puoi identificare questo messaggio speciale quando il campo Code dell'IntuiMessage è 0x5F. Replace Mode Questo tipo di gadget è normalmente creato nel modo insert. Settando questa tag sarà creato nel modo di sostituzione, ciò significa che quando l'utente preme un tasto, sovrascriverà il carattere sotto il cursore. String Normalmente il gadget è creato vuoto. Qui tu puoi inserire la stringa con cui vuoi che sia creato. MaxChars In questo gadget tu puoi assegnare il massimo numero di caratteri che possono essere inseriti in questo gadget. Justification Con questo gadget tu puoi assegnare il posto dove il testo dovrebbe apparire nel gadget. @ENDNODE @NODE text "TEXT" Queste sono le tags che puoi specificare con IE: CopyText Quando è settata GadTools copierà il testo in un buffer interno cosicchè il programma può usarlo di nuovo. Border Quando è settata il gadget creato avrà un bordo recessed disegnato attorno esso. Clipped Se è settata, il testo del gadget sarà clippato alle dimensioni del gadget. Questo funziona solo con kick v39+. Text Per default il gadget è vuoto. Qui dentro tu puoi inserire il testo che il gadget creato avrà. Front Pen La pen da usare per stampare il testo. -1 dice a IE di non usare questa tag nel sorgente. Questo funziona solo con kick v39+. Back Pen La pen da usare per disegnare lo sfondo del testo. -1 dice a IE di non usare questa tag nel sorgente. Questo funziona solo con kick v39+. Justification Determina dove rappresentare il testo all'interno del box del gadget. Questo funziona solo con kick v39+. Sotto v39, devi anche settare la tag Clipped, se setti questa, altrimenti il testo non sarà stampato. @ENDNODE @NODE macros "Macros/Tasti funzione..." Questa voce aprirà una finestra in cui troverai 10 string gadget ed un cycle gadget. I gadget stringa sono chiamati F1...F10: lì puoi inserire i nomi degli script ARexx che vuoi associare ai rispettivi tasti funzione. Oppure puoi clickare sui gadget "get file" posti a fianco di ogni string gadget per aprire un file requester. Con il cycle gadget puoi specificare se lo script dovrà essere collegato al solo tasto funzione, oppure al tasto funzione più un qualificatore (nessuno, SHIFT, ALT): così puoi utilizzare fino a 30 script diversi. @{"Scripts forniti con IEditor" link scripts} @ENDNODE @NODE addmacro "Macros/Aggiungi..." Oltre a collegare script ARexx ai @{"tasti funzione" link macros}, puoi aggiungere delle voci al menu Macros. Selezionando questa voce apparirà un file requester con cui potrai scegliere uno script ARexx da aggiungere al menu. Una volta aggiunto, uno script ARexx può essere richiamato semplicemente selezionando il suo nome. @{"Scripts forniti con IEditor" link scripts} @ENDNODE @NODE remmacro "Macros/Rimuovi..." Selezionando questa voce, apparirà una finestra con la lista delle macro @{"aggiunte" link addmacro} al menu. Clickando su quella che desideri, la rimuoverai. @ENDNODE @NODE execmacro "Macros/Esegui..." Questa voce ti permetterà di eseguire istantaneamente uno script ARexx per IE. Apparirà infatti un file requester: scegli lo script che desideri e verrà eseguito. @{"Scripts forniti con IEditor" link scripts} @ENDNODE @NODE scripts "Scripts ARexx forniti con IEditor" Questi sono gli scripts che troverete nella distribuzione di IE: ShadowText.ie ------------- Permette di aggiungere un effetto ombra agli IntuiTexts. Save&Exit.ie ------------ Salva l'interfaccia corrente ed esce da IEditor. Shell.ie -------- Apre una Shell sullo schermo di IE. ImgBox.ie --------- Aggiunge un bevel box di contorno ad una immagine. CenterText.ie ------------- Centra un IntuiText nel lato superiore di un BevelBox. Ridge20.ie ---------- Trasforma un bevel box in un bevel del tipo Ridge, compatibile col kickstart 2.0 (il Ridge impostato tramite tag funziona solo dal 3.0). MoveImage.ie ------------ Sposta un'immagine alle coordinate indicate. AlignBoxRight.ie AlignBoxLeft.ie AlignBoxTop.ie AlignBoxBottom.ie ----------------- Eseguono allineamenti fra bevel box. @ENDNODE @NODE toolswindow "Preferenze/Finestra Strumenti" Questo aprirà/chiuderà la finestra degli @{"Strumenti" link toolbar}. @ENDNODE @NODE usegads "Preferenze/Usa i Gadgets" Se non è selezionato, i gadget nelle finestre di edit saranno creati e quindi staccati subito, rendendo la selezione più facile e veloce. @ENDNODE @NODE infront "Preferenze/Finestra corrente in primo piano" Seleziona questo per avere la finestra selezionata sempre di fronte alle altre. @ENDNODE @NODE usewflags "Preferenze/Usa i flags settati" Se impostato, le finestre che stai editando useranno i flag hai assegnato loro, altrimenti i miei ;) flag saranno usati. @ENDNODE @NODE createicons "Preferenze/Genera icone" Se è attivato, verrà creato un file .info quando @{"salvi" link "save"} una GUI. @ENDNODE @NODE genprefs "Preferenze/Generatore..." Questo aprirà una finestra in cui puoi scegliere/configurare il generatore di codice. Nella finestra troverai una listview che mostra la lista dei generatori installati: basta clickare su quello desiderato per attivarlo. Premendo sul gadget "Configura", si aprirà la finestra di configurazione del generatore. Per quanto riguarda i generatori forniti con IE, qui c'è la descrizione dei loro parametri, per altri generatori consultate la documentazione fornita: @{" C.generator " link cprefs} @ENDNODE @NODE asmprefs "Preferenze/Sorgente Asm..." Questo aprirà un requester in cui puoi editare alcuni parametri per il sorgente Asm: Data Section Se è settato, sarà creata una sezione DATA. BSS Section Prova ad indovinare... ;-) IntuiMsg Se è settato, nel sorgente verrà riservato dello spazio per gli IntuiMessage delle finestre. Es. Se hai una finestra la cui etichetta è "Win", nel sorgente troverai questa linea: WinMsg ds.b im_SIZEOF Clicked Ptr Se è settato, nel campo UserData di ogni gadget che può generare un messaggio IDCMP verrà posto un puntatore chiamato Clicked. Così, quando ricevi un messaggio IDCMP da una tua finestra, dovrai eseguire la routine puntata da esso. IDCMP Handler Questo attiva la generazione degli @{"IDCMP Handler" link handler}. Key Handler Questo attiva la generazione dei @{"Key Handler" link keyhandler}. Gadget Labels Se settato, ogni gadget avrà il suo proprio puntatore invece di un array globale. Raw Code Se settato, sarai in grado di assemblare il codice generato senza i file include. Intuition Base Inserisci qui il nome che normalmente usi nei tuoi sorgenti per identificare l'Intuition Base GadTools Base Lo sai già, non è vero? ;) @ENDNODE @NODE cprefs "Preferenze/Sorgente C..." Questo aprirà un requester in cui puoi editare alcuni parametri per il sorgente C: IntuiMessage Se settato, strutture chiamate Msg verranno create nel sorgente. Clicked Ptr Se è settato, nel sorgente un puntatore chiamato Clicked sarà messo nel campo userdata di ogni NewGadget. Così, puoi creare un gestore di IDCMP che, quando riceve un messaggio del tipo GADGETUP (o GADGETDOWN), esegue la routine puntata da gg_UserData. Naturalmente nel tuo sorgente dovrai avere delle routine chiamate Clicked( void ). IDCMP Handler Questo attiva la generazione degli @{"IDCMP Handler" link handler}. Key Handler Questo attiva la generazione dei @{"Key Handler" link keyhandler}. To Lower Se settato, il @{"Key Handler" link keyhandler} non  farà  differenze fra maiuscole e minuscole. Template Se settato, IE genererà un file chiamato _temp.c in cui troverai i template vuoti per le funzioni chiamate dal sorgente della GUI. Smart Str Se   settato,  il  generatore  non  scriverà  una una  stringa   più  di  una  volta,  risparmiando spazio. Use CatComp Se  settato,  il  generatore  userà  CatComp  per generare i files .ct e _locale.h (CatComp  deve essere nel path). Altrimenti, il generatore creerà questi files  da solo. NOTA: nel file _locale.h  creato  dal  generatore ci sono solo i dati  relativi  a  CATCOMP_NUMBERS e CATCOMP_ARRAY. UWORD chip Inserisci qui la sintassi usata dal tuo compilatore per mettere i dati in un hunk CHIP. Headers Qui puoi inserire il nome di un file in cui  sono definiti gli include  da  usare.  Questi  saranno usati al posto di quelli  di  default  usati  dal C.generator. Il gadget 'R' presente di fianco a questo apre un requester per selezionare il file. Questo è un @{"esempio" link headersexample} di file di  definizione  per gli include. Use Usa le preferenze settate. Save Salva ed usa le preferenze. Cancel Annulla le modifiche effettuate. @ENDNODE @NODE saveprefs "Preferenze/Memorizza" Questo salverà il corrente settaggio delle preferenze. @ENDNODE @NODE headersexample "Esempio di un file di definizione per gli headers" ##STANDARD #include #include #include #include #include #include #include #include #include #ifdef PRAGMAS #include #include #include #include #endif #include #include ##DISKFONT #include ##AREXX #include #include #include #include #include #include #include #include #include #ifdef PRAGMAS #include #include #endif ##LOCALE #include #include #ifdef PRAGMAS #include #endif ##end @ENDNODE @NODE fontadaptive "Font Adaptivity" IEditor è capace di creare GUI che automaticamente adatteranno le loro dimensioni al font usato nello schermo che useranno: cio significa che la posizione e la dimensione di tutti i gadget, bevel-box, immagini, etc... saranno adattati conformemente alla dimensione di font. Il sorgente adatterà anche la dimensione e la posizione delle finestre. Inoltre controllerà se le finestre staranno nello schermo: nel caso in cui risultino troppo grandi, il font "topaz 8" sarà usato. IE ti permette di usare qualsiasi font nel momento in cui stai progettando una GUI font-adaptive, ma io ti raccomando di non usarne uno troppo grande, altrimenti ci potranno essere alcuni problemi adattando i gadget. NOTA BENE: fà attenzione quando usi gadget di dimensione fissa come @{"MX" link mx}, @{"CHECKBOX" link checkbox}, @{"BOOLEAN" link boolean} e le @{"immagini" link imgbank}: la loro dimensione non sarà modificata per essere adattata al font! @ENDNODE @NODE handler "L'IDCMP Handler" L'IDCMP Handler è una piccola routine che gestisce tutti i messaggi che arrivano alla User Port della tua finestra: crea una copia dell'IntuiMessage, quindi chiama la routine appropriata. I nomi delle routine chiamate sono composti in questo modo: Esempio: Se arriva un messaggio IDCMP_CLOSEWINDOW alla finestra "Main", l'IDCMP Handler chiamerà la routine MainCloseWindow. Ci sono però due eccezioni: IDCMP_GADGETUP/DOWN e IDCMP_MENUPICK: in questi casi verrà chiamata la routine puntata dal campo UserData del gadget/menu. Inoltre i messaggi IDCMP_REFRESHWINDOW vengono gestiti completamente dall'handler. Nel linguaggio assembly, le routine verranno chiamate con un puntatore alla copia del messaggio in A5. Vedi il sorgente di "GMExample" per un esempio pratico. @ENDNODE @NODE keyhandler "Il Gadget Activation Key Handler" L' Activation Key Handler è una piccola routine che maneggia i messaggi IDCMP VanillaKey che si riferiscono al tasto di attivazione di un gadget... Così puoi assegnare i tuoi underscore senza preoccuparti di come maneggiarli! La routine funziona in questo modo: - con i gadget @{"INTEGER" link integer} e @{"STRING" link string}, esegue un ActivateGadget() - con altri tipi di gadget, chiama la routine KeyPressed(). NOTA: se setti il flag IDCMP_VANILLAKEY per la tua finestra, e usi l'@{"IDCMP Handler" link handler}, se il key handler non riconosce il tasto di attivazione, la routine VanillaKey sarà invocata, così puoi processare altri tasti oltre a quelli dei gadget. @ENDNODE @NODE source "Il Sorgente Generato" Per i linguaggi Asm e C, IEditor crea due file sorgenti. Il primo (.c|.s) conterrà tutte le routine e dati necessari per aprire la GUI. Il secondo (.h|.io) conterrà gli Extern o Xref e le costanti per i gadget ID. NOTA: se generi il sorgente Amiga E, ricordati che le iniziali di tutte le etichette verranno cambiate in minuscolo! Nel file principale sono generate le seguenti routine: ========================================================================== int SetupScreen( void ); ========================================================================== Questa routine aprirà o bloccherà lo schermo e otterrà il suo visual info. Questa routine può ritornare uno dei seguenti errori: 0 = Nessun errore. 1 = Non ha potuto aprire o bloccare lo schermo. 2 = Non ha potuto ottenere le visual info dello schermo. ========================================================================== void CloseDownScreen( void ); ========================================================================== Questa routine libererà le risorse prese da "SetupScreen()". Devi sempre chiamare questa routine quando "SetupScreen()" fallisce per chiudere e liberare le risorse che non ha fallito nell'aprire!!! ========================================================================== int OpenWindow( void ); ========================================================================== Ci sono tante di queste routine quante sono le finestre nella tua GUI. Queste routine creeranno i gadget e apriranno la finestra. Queste routine possono ritornare uno dei seguenti errori: 0 = Nessun errore. 1 = Non ha potuto creare il contesto. 2 = Errore durante la creazione di gadget. 3 = Non ha potuto creare i menu. 4 = Non ha potuto aprire la finestra. ========================================================================== void CloseWindow( void ); ========================================================================== Ci sono tante di queste routine quante sono le finestre nella tua GUI. Queste routine libereranno tutte le risorse che la routine "OpenWindow()" ha preso. Devi sempre chiamare questa routine se "OpenWindow()" ha fallito! Il file principale anche ha le seguenti definizioni globali che sono condivise da tutte le finestre del progetto: struct Screen *Scr; Un puntatore allo schermo aperto/bloccato. APTR VisualInfo; Un puntatore al visual info Le seguenti variabile globali sono generati solo quando il file contiene gadget o quando la finestra deve avere un gadget zoom o quando hai selezionato un font per un gadget: struct Gadget *GList; I gadget creati WORD Zoom[4]; Le posizioni alternative della finestra struct TextFont *_; Sono anche generati puntatori per ogni finestra che è in memoria: struct Window *Wnd; Inoltre, quando lo schermo è generato e la tag ErrorCode è settata, questo ULONG sarà incluso nel sorgente: ULONG ErrorCode = NULL; Qui tu troverai un codice di errore che ti dirà cos'è andato male nell'apertura dello schermo. Ultimo ma non meno importante, nel sorgente verrà generata una variabile chiamata YOffset: il suo valore è uguale a Scr->WBorTop + Scr->Font->YSize. Se modifichi il font dello schermo, * DEVI * aggiornare questa variabile! Inoltre, dovrai anche aggiornare la variabile XOffset = Scr->WBorLeft. Se sono presenti delle immagini nella tua GUI, verranno create strutture chiamate: struct Image Img = ... e hai messo qualche immagine direttamente nella finestra: struct Image _Image = ... Quando non setti la voce "Genera" nel menù Schermo, questo puntatore viene generato: UBYTE *PubScreenName = NULL; Questo ti permetterà di cambiare il nome dello schermo pubblico da aprire senza dover trafficare nel sorgente generato. Il file principale contiene anche l'array di Gadget per ogni finestra che sono definiti come segue: struct Gadget *Gadgets[]; Per accedere ai puntatori in quest'array il programma genera Define o EQU nel file di header che specificano la posizione di un certo gadget nell'array. Questi defini sono costruiti come segue: #define GD_ Se @{"richiesto" link srcparams}, IE genererà anche le seguenti routine: ========================================================================== BOOL OpenDiskFonts( void ); ========================================================================== Apre tutti i diskfont utilizzati nell'interfaccia. Restituisce FALSE (in asm, d0 = 0) se non ha potuto aprire uno dei font. In ogni caso, *dovrete* chiamare CloseDiskFonts prima di terminare il programma! I puntatori alle strutture TextFont restituite si chiameranno: Font dove è uguale a: _