40tude Dialog - script editor
Uno degli aspetti più appassionanti di Dialog è, secondo me, la sua "malleabilità".
Generalmente i programmi sono piuttosto rigidi: hanno determinate caratteristiche, fanno certe cose, l'utente ha a sua disposizione un certo numero di comandi che impara abbastanza in fretta. Ma in seguito può capitare di aver bisogno di una determinata funzione e quella non c'è: allora o se ne fa a meno o si cerca un altro software che ce l'abbia. Con Dialog invece si ha la possibilità, almeno fino a un certo punto, di espanderne le funzioni mediante gli script, il cui linguaggio è basato sull'Object Pascal.
Non è necessario essere grandi programmatori: Dialog implementa anche la possibilità di "drag and drop" dei comandi nello script editor, e questo permette di realizzare semplici script senza scrivere una linea di codice.
Comunque, chi non ha voglia di impegnarsi troppo può trovare molti script già pronti o può chiederne di nuovi nei newsgroup: nuove idee saranno sicuramente benvenute!
Per capire bene i diversi tipi di script dobbiamo aver chiaro che cosa significa evento: in poche parole, un evento è un'azione, nostra o del programma, che accade in un certo momento e che il programma riconosce.
Per esempio un nostro clic su una voce di menu è un evento, oppure, se c'è un timer attivo, allo scadere del suo intervallo si genera un evento... Sta a noi, se vogliamo, programmare nuove azioni per questi eventi.
Inoltre, viceversa, possiamo programmare un nostro script personale per compiere determinate azioni ed associarlo ad un pulsante o ad una hotkey che creeremo apposta per esso: da quel momento un nostro clic su quel pulsante, o l'uso di quella hotkey, sarà un evento che farà scattare l'esecuzione del nostro script.
I tre tipi di script
Col menu "Impostazioni - Script - Script..." si apre lo Script editor:
fig.1
Gli script possono essere di tre tipi, che corrispondono ai tre diversi tab che vedete sulla sinistra:
Script di Windows Message: Sono gli script che vengono eseguiti quando Windows riceve determinati messaggi dovuti ad una nostra azione, per esempio aver cliccato sull'header di un articolo.
Script eventi: Sono gli script che vengono eseguiti in determinati momenti dell'attività di Dialog, per esempio all'avvio, o mentre si sta ricevendo un messaggio. Gli eventi possibili sono già tutti elencati in questo tab e non possiamo crearne altri. Possiamo però selezionare uno di questi eventi e per esso creare uno script.
Script personali: Sono gli script che vengono eseguiti quando siamo noi a chiamarli, con una hotkey o cliccando su un pulsante che avremo predisposto allo scopo.
I comandi dello script editor
Il comando Nuovo, eseguibile col primo pulsante in alto a sinistra o dal menu "File - Nuovo script..." o con Ctr+N, è abilitato nei tab Script di Windows Message e Script personali ma non, come abbiamo già accennato sopra, nel tab Script eventi per altri script oltre quelli elencati.
Se ci si trova in Script personali, il comando Nuovo apre una piccola finestra di dialogo in cui inseriremo il nome del nostro nuovo script. Se ci si trova in Script di Windows Message, il comando Nuovo apre un'altra finestra di dialogo con due liste a discesa: Controllo e Messaggio, da cui sceglieremo il controllo e il messaggio coi quali il nostro script dovrà interagire.
In entrambi i casi, cliccando all fine su OK, si otterrà una nuova pagina sulla destra dello script editor, dove potremo inserire il nostro nuovo script.
Non mi soffermo sugli altri due comandi che si spiegano da soli: Salva, e Elimina.
Esaminiamo invece più in dettaglio i seguenti:
Esegui lo script attivo (F9). Con questo pulsante lo script attualmente visualizzato nell'editor viene compilato ed eseguito. Spesso però, mentre si scrive uno script, non si desidera eseguirlo, ma semplicemente controllare se viene compilato senza errori (notate in figura la parte bassa della finestra, intitolata "Output per il debug").
In questi casi è bene allora usare:
Compila lo script attivo (Ctrl+F9). Lo script viene compilato senza essere eseguito. Possiamo così osservare nell'output per il debug l'eventuale presenza di un errore, che viene segnalato col numero di riga e di colonna in cui compare:
fig.2
Gli errori vengono segnalati uno alla volta, perché il compilatore si interrompe appena ne trova uno.
Quando non riceviamo più errori, eseguiamo lo script col pulsante verde (o con F9) e vediamo attentamente come si comporta: infatti possiamo aver creato uno script correttissimo dal punto di vista sintattico ma che poi non esegue in realtà quello che vogliamo (colpa nostra, ovviamente!).
Quando alla fine siamo soddisfatti, ricordiamoci di salvarlo.
Esegui lo script cronometrato attivo (Shift+F9). Usiamo questo comando se vogliamo eseguire lo script e conoscere anche il tempo di esecuzione, che vedremo indicato nell'output per il debug:
fig.3
Elimina la versione compilata dello script attivo. Normalmente in Dialog si tengono sempre gli script abilitati (menu "Impostazioni - Script - Script abilitati") e questo significa che tutti gli script che abbiamo compilato sono eseguibili o in esecuzione. Quella opzione di menu però è del tipo "o tutti o niente": allora come faccio se voglio disabilitare solo uno script? Cancellarlo sarebbe una scelta troppo drastica e anche molto scomoda, se poi ho intenzione di tornare ad usarlo. Questo comando serve proprio a questo scopo: eliminando solo la versione compilata dello script, lo disabilita automaticamente, senza eliminarne la versione di testo. Per renderlo di nuovo attivo basterà ricompilarlo.
Associare un'icona a uno script personale
Quando avete scritto un vostro script, per poterlo avere a disposizione come pulsante su una toolbar dovete prima associargli un'icona. Sulla sinistra dello script editor c'è la lista a discesa denominata "Icona:", da cui potete scegliere un'icona tra quelle già disponibili in Dialog. Ma potete anche aggiungerne di nuove:
Scegliete delle immagini di formato bmp e di grandezza 20x20 pixel.
Copiatele nella subdirectory \Scripts\Icons di Dialog.
Riavviate Dialog.
Ora in fondo al menu a discesa troverete anche le vostre nuove icone.
Se poi volete che compaia anche un tooltip quando passerete il mouse sul vostro pulsante, aggiungete il testo desiderato nel campo Hint: .
La finestra dei "drag and drop"
No, in Dialog non esiste una finestra chiamata così! ;-)
L'ho soprannominata in questo modo perché in essa, col drag and drop, si possono fare due diverse operazioni:
- Aggiungere comandi agli script
- Aggiungere o eliminare pulsanti dalle toolbar.
Questa finestra, che in realtà si chiama "Personalizza le barre degli strumenti", si apre dallo script editor cliccando sul pulsante "Mostra config. pulsanti", oppure dal menu "Impostazioni - Configura pulsanti/scorciatoie...", oppure ancora cliccando col tasto destro su un qualunque pulsante di una toolbar.
fig.4
Aggiungere comandi agli script
Mentre state scrivendo uno script, se dovete aggiungere un comando tra quelli disponibili in Dialog, selezionatelo in questa finestra, nella sua categoria, e trascinate la selezione nello script editor.
Se per esempio state scrivendo uno script che deve effettuare, tra altre operazioni, la stampa di un articolo, selezionate la categoria File, poi sulla destra il comando Stampa articolo... e trascinatelo nello script editor; rilasciando il pulsante del mouse vedrete che nel vostro script è stato aggiunto il comando ADo('PrintArticle'); .
Aggiungere o eliminare pulsanti dalle toolbar
Nella finestra "Personalizza le barre degli strumenti" (fig.4) scegliete un comando o un vostro script personale dotato di un'icona, trascinatelo sul pannello che preferite e rilasciate il mouse.
Per cancellare un pulsante, trascinate il pulsante Canc su quello che volete cancellare e rilasciate il mouse.
Potete aggiungere anche dei separatori, che trovate all'inizio della lista sotto ogni categoria.
Per distanziare maggiormente i pulsanti tra loro esiste anche lo "Spazio di separazione" che potete trovare nella categoria "File", all'inizio della lista dopo "Separatore".
fig.5
Nella pagina seguente potete trovare alcuni script, ciascuno preceduto da brevi note:
autore, tipo, descrizione, avvertenze, codice.
Quando l'autore non è determinabile (perché ignoto, o perché lo script è frutto di vari riaggiustamenti fatti da tante persone) viene indicato come "n.d.".
Il tipo indica in quale tab dello script editor dovete inserire lo script.
Cliccando sul link per il codice si apre una nuova finestra del browser.
Per copiare il codice nella clipboard, cliccate in questa nuova finestra col tasto destro, scegliete "Seleziona tutto" e premete Ctrl+C.
Naturalmente non sono riportati qui tutti gli script presenti su Wiki o altri siti, ma solo quelli di maggiore uso e per i quali è utile una traduzione italiana.
