[Guida], Autoit

GUIDA : Autoit – Il linguaggio di automatizzazione per eccellenza (IMHO)

______________________________________________________________________________

--Installazione--

Innanzitutto scaricate il Pacchetto Completo qui : Autoit Full Installation

Questo pacchetto installerà nel vostro sistema:
- File essenziali al Funzionamento di Autoit v3
- Aut2Exe : ottima Utility per convertire i vostri script AutoIt in Exe compilati.
- L'addon AutoItX per gestire i controlli sulle DLL e sulle COM
- Una versione dell'editor SciTE con il riconoscimento automatico della sintassi di AutoIt.

Vi consiglio, durante l'Installazione, di modificare gli Script Autoit.
Ora andate su Start / Tutti i programmi / AutoIt v3 / SciTE Script Editor

Vi si aprirà dunque l'Interfaccia grafica dell'editor.

Cliccate su File / New, si aprirà un foglio virtuale. Qui è dove scrivere il vostro Script.
Nota : I files dello SciTE verranno salvati con estensione *.au3

Per eseguire il codice dovrete salvare in un file(*.au3) e poi andare in Tools / Go (o F5).


--Iniziare a programmare--

--Hello World, l'inizio--

Cominciamo subito a programmare (anzi, scriptare :-D).

Lo script in questione non fa altro che stampare a schermo, in una MsgBox (vedremo più avanti), il messaggio “Hello Word !”.

Vi consiglio, comunque, di scrivere la seguente Riga anziché copiarla ed incollarla :




Se, anziché copiare ed incollare, avete scritto il comando MsgBox correttamente, avrete certamente notato che lo SciTE ha riconosciuto la sintassi e fornito la lista di tutti i parametri necessari.

I parametri sono sempre divisi tra virgole ed inseriti tra parentesi, inoltre sono tutti obbligatori tranne quelli compresi tra parentesi quadre;

Es. : ( $ciao[,$var])
Va da sé, quindi, che la variabile $ciao sarà obbligatoria, mentre la variabile $var sarà opzionale.





Analizziamo dunque lo Script “Hello Word”.



Come avrete notato, il primo valore è 0.
Il valore si riferisce al Parametro “flag”, che settato a 0 non restituisce icone o tasti.

Come seconda e terza stringa, “Titolo” e “Hello Word !”, abbiamo passato invece -come già detto- una Stringa Alfanumerica. Le stringhe sono comprese tra gli apici " ".

Il quarto parametro opzionale indica il timeout, ovvero il tempo che deve passare prima che la finestra si chiuda.
In questo caso il valore default non restituisce nulla, infatti sarà necessario premere il tasto “OK” per far sì che la MsgBox vada via.

----Variabili e Macro--
Le variabili in AutoIt sono facilmente riconoscibili: cominciano sempre con il simbolo del dollaro, $ , e vengono riconosciute dalla sintassi dello SciTE con un colore vicino al bordeaux.
Le variabili possono essere considerate “scatole” contenenti un determinato valore.
Il valore può essere cambiato durante l'esecuzione dello Script.

Per assegnare un valore a una variabile è sufficiente scrivere:





Nel primo caso la $var assumerà il valore 6, nel secondo caso la $var2 assumerà valore "stringa".

LE VARIABILI GIOCANO UN RUOLO ESSENZIALE ALL'INTERNO DI QUALSIASI SCRIPT.

Perchè ? Perchè anche le funzioni si servono di variabili.
Come esempio prenderemo StringUpper, che ritorna la stringa inserita con i caratteri in maiuscolo.






Assegniamo quindi al Value di ritorno della funzione la variabile $upped.

Vogliamo fare prima ? Il processo si può abbreviare in questo modo :







Le macro invece cominciano sempre con la @ e, al contrario delle variabili, hanno un valore predefinito non modificabile dallo scripter.
Le macro possono rappresentare valori costanti o variabili nel tempo.
Un esempio di Macro è dato da @ScriptName.




Una variabile può assumere anche il valore di una macro :

@YEAR, ad esempio, restituisce l'Anno in quattro cifre :




Vi inserisco, quindi, una lista di tutte le Macros di Autoit (in italiano) :



--Array--

Se la variabile è una scatola contenente un valore, l'Array allora è un insieme di scatole.
L'Array, in pratica, è un contenitore di più variabili.
Per riempire un Array di valori (in gergo si tende ad usare l'espressione “popolare un array”), si può fare in questo modo :





In questo caso dichiariamo (Dim) un array($array) composto da cinque elementi([5]), equivalenti a 5 numeri ([8, 4, 5, 9, 1]).




----Operazioni-con-i-files--


Le funzioni che agiscono sui files iniziano sempre con *File o *_File.


1. Aprire un file:

FileOpen

Da una funzione FileOpen ritorna sempre la directory (handle) di un file che potrà essere usato in altre funzioni.

Autoit ci richiede il metodo di apertura del file (mode) :

0 = Read mode
1 = Write mode (aggiunge alla fine del file)
2 = Write mode (elimina dati precedenti e sovrascrivi)
4 = Read raw mode
8 = Crea la struttura di una Directory se quella specificata non esiste.




2. Scrivere in un file:

FileWrite o FileWriteLine.

Le due funzioni sono uguali, ma la seconda aggiunge un @CRLF e va a capo riga.

3. Leggere un file:

FileRead


Il primo parametro richiede l'Handle del file.
Il secondo parametro richiede il numero di caratteri da leggere.
Se il secondo parametro è omesso verranno letti tutti i caratteri.

4. Chiudere un file:

FileClose

Devo anche spiegarvelo ? :-D


5. Cancellare un file:

FileDelete

Anche questo non ha bisogno di spiegazioni :-D


_______________________________________________________________
PROSSIMO ARGOMENTO : STRUTTURE SELETTIVE.______________

-- Strutture Selettive --
----If|Then|Else|ElseIf|EndIf--

Innanzitutto, per chiarire meglio il funzionamento del Ciclo If, analizziamolo secondo il suo significato :-P

Parole chiave :
If = "Se"
Then = letteralmente "dopo", ma si può intendere come "allora".
Else = "altrimenti".
ElseIf = "altrimenti se".
EndIf = "fine dell'If".

If ... Endif, quindi, verifica l'avverarsi -o meno- di una condizione posta tra If e Then.

Se la condizione risulta vera (= True) esegue il codice dopo Then.
Se la condizione, invece, risulta vera verrà eseguito (indovinate un po' ? :-P) il codice sotto a Else.
ElseIf è una particolare condizione. Essa non richiede solo il value di ritorno della prima condizione Falso (=False), visto che affinchè venga eseguito il codice sotto di esso la condizione tra If e Then deve essere falsa mentre la condizione tra ElseIf e Then deve essere vera.
EndIf chiude il ciclo If e quindi il codice sotto di esso non sarà compreso tra le condizioni.



----Select|Case|EndSelect--







Select ... EndSelect verifica le condizioni sotto ogni Case ed esegue il codice non appena la condizione risulta vera in uno dei Case.


----Switch|Case|EndSwitch--







In questa struttura viene preso in esame una sola variabile, che viene precisamente citata dopo Switch.
Durante l'esecuzione viene verificato se il valore contenuto dentro alla variabile equivale ad un valore specificato.
Questo valore è definito dopo ogni Case.



--------Strutture-Iterative----
----For|To|Step|Next--







Esegue il codice compreso tra For e Next fino a che $i=5 non raggiunge $i = 35. In questo caso il ciclo For incrementa di Cinque (Step 5).
Definire Step non è obbligatorio, l'incremento di Default sarà 1.

----While|WEnd--






Stabiliamo che la variabile $num è uguale a 0.
Poi all'inizio del Ciclo While incrementiamo la variabile di 1 e la mostriamo in una MsgBox.

In questo caso, essendo While 1 = 1 (abbreviato anche in While 1) una condizione sempre vera (ma và ? :-D) il Ciclo risulterà infinito.


--Do|Until--






Esegue il codice inserito dopo Do -incrementa la variabile $var di uno- finchè non si verifica la condizione posta dopo Until.

_______________________________________________________________
PROSSIMO ARGOMENTO : CREARE UNA GUI.______________

--Creare una GUI--

Bene, abbiamo i rudimenti base per la programmazione in Autoit.
La domanda ora sorge spontanea .. "Sì, so fare queste cose ma .. la Grafica ?"

Il vostro desiderio è esaudito. u.u








La creazione di una GUI, in Autoit, è forse l'elemento più semplice tra tutti.
Infatti i creatori del linguaggio offrono una vasta gamma sotto questo punto di vista e ci forniscono alcune variabili preimpostate dal Team.
Un esempio, inserito nel precedente codice, è proprio il termine #include.
Chi ha conoscenze in C/C++ riconoscerebbe facilmente il comando, ma anche chi è agli inizi potrà comprendere il significato della parola ! :-P
La libreria <guiconstants.au3>, invece, include le funzioni principali per una GUI.




_________


Ora passiamo alla creazione vera e propria del Form, la finestra del nostro programma.
A questo proposito utilizziamo la funzione GUICreate().





Il primo parametro indica il titolo della finestra, che risulterà "La mia GUI".

Il secondo e il terzo parametro indicano rispettivamente larghezza e altezza della nostra finestra.

Il quarto e quinto parametro, facoltativi, indicano invece la posizione della finestra nello schermo; di Default questa apparirà centrata allo Schermo.

Il sesto e settimo parametro indicano gli stili della finestra, ovvero dei parametri che abilitano la vostra GUI a possedere alcune "particolarità". L'Help di Autoit contiene una lista dettagliata di tutte le possibilità.
L'ottavo parametro consente di indicare un form che funga da Finestra Principale per la finestra creata.

Ovviamente tra tutti questi l'unico valore obbligatorio è il Testo della GUI, mentre tutti gli altri valori avranno di Default dei parametri scelti dal Team di Autoit.


Bene, abbiamo la nostra GUI.
Ora procediamo con l'inserimento di controlli (Tasti , Label , Input , TextBox , etc.).
Il metodo è piuttosto semplice.
Il comando è GUICtrlCreate*, dove * è il controllo che vorremo creare.





Il primo parametro indica il testo all'interno del tasto.
Il secondo e il terzo parametro ne stabiliscono la posizione.
Il quarto e il quinto parametro stabiliscono la grandezza del controllo.
Il sesto e settimo parametro indicano gli stili del controllo,ovvero dei parametri che abilitano il vostro tasto a possedere alcune "particolarità". - La stessa cosa della GUI :-D - L'Help di Autoit contiene una lista dettagliata di tutte le possibilità.


IMPORTANTE: Dalle variabili dei controlli ritorna sempre lo stato dello stesso, è ESSENZIALE ricordarlo per affrontare i prossimi argomenti.


Abbiamo dunque costruito la nostra GUI.
Ora dovremo precisare lo stato della GUI stessa.






La macro @SW_SHOW stabilisce che la finestra selezionata deve essere visibile.
In questo caso abbiamo omesso un valore all'interno di GUISetState, che non trovandolo avrà come Default l'ultimo controllo creato.


Giungiamo dunque alla parte più "divertente" della GUI, ossia gli eventi legati ad un tasto o ad un altro controllo :-D
Procediamo con il creare un ciclo infinito ( ricordate ? :-P)




Poi utilizziamo la funzione GUIGetMsg(), che rileva qualsiasi "cambiamento" all'interno della GUI e possibili Value di ritorno dai controlli. Dichiariamo il risultato in una Variabile :






Creiamo dunque un controllo Switch sulla variabile $nMsg (che equivarrà al controllo che ha restituito una value) e confrontiamolo con i nostri, in questo caso, tasti.

Impostiamo così il codice :



Concludiamo dunque con una precisazione.
In AutoIt vengono attribuiti dei valori particolari ai tasti per ridimensionare, minimizzare e chiudere la finestra.
Questi necessitano dell'#include <guiconstants.au3> per essere utilizzati e possono essere considerati semplici tasti.


$GUI_EVENT_CLOSE = Il tasto di chiusura della GUI (la X rossa in alto a destra :-D).
$GUI_EVENT_MINIMIZE = Il tasto per minimizzare la GUI.
$GUI_EVENT_RESTORE = Il Click sulla Barra di Windows per ripristinare una GUI minimizzata.
$GUI_EVENT_MAXIMIZE = Il tasto per massimizzare la finestra.

Il codice completo, dunque, sarà questo.




_______________________________________________________________
PROSSIMO ARGOMENTO : INTERAZIONE ED EVENTI TASTIERA._______

----Eventi Tastiera--

Con Autoit è possibile, attraverso alcuni comandi, simulare attività umane come la pressione dei tasti, il movimento del Mouse, etc..

In questo caso, il primo comando che prenderemo in considerazione è Send()

Secondo Parametro di Send impostato a 1 : I caratteri verranno inviati come sono scritti.



Output : "asd!°°#a(/"

--

Secondo Parametro di Send impostato a 0 (Default) : Tutti i caratteri verranno inviati come sono scritti, tranne:

! = ALT
+ = SHIFT
^ = CTRL
# = WIN


.. ed altre combinazioni per “tasti speciali”.




Output : CTRL+ALT+X

Utilizzando l'Help Ufficiale si possono trovare tutte le combinazioni “speciali”.


Istruzioni Particolari :



Invia “A” 4 volte.




Il tasto “a” viene tenuto premuto finchè non entra in gioco il comando ..




.. che rilascerà il tasto “a”.

Guida made by Danyez from HackShare.