Funzionamento (selezione su lista)

Descrizione

Questo modello viene chiamato dal menù contestuale di un campo inseribile, per aprire una finestra di selezione o nella prima parte di un programma standard, o inoltre da una funzione. Nel caso di una selezione su menù contestuale di un campo, questa finestra conterrà tutti i valori possibili del campo ed un testo associato per ognuno di questi valori. Se questo modello viene inserito nella fase iniziale del programma standard, le azioni vanno scritte nel programma contenente le azioni del programma standard.

Questa finestra va costruita alimentando alcune variabili nell'azione SEL_LISTE.

Le righe della finestra sono da costituire. La finestra può contenere da 1 a 5 colonne al massimo. Di default le righe sono visualizzate tutte contemporaneamente nella finestra, con un limite di 200 righe.

Su questo modello non sono supportate la selezione rapida e la paginazione.

I programmi

Il modello è un programma supervisore che fa riferimento a due programmi allegati: il programma standard ed il programma specifico, se sono presenti nel dizionario dell'azione. Questi due programmi sono strutturati allo stesso modo, ovvero iniziano con un'etichetta ACTION che gestisce diversi eventi in grado di verificarsi durante l'esecuzione della funzione.

Il programma standard
Questo programma, fornito da ADONIX, non deve assolutamente essere modificato dallo specifico. 

Il programma specifico
Questo programma non è fornito da Adonix, ma può essere sviluppato in specifico (sia per funzioni standard per le quali si desidera effettuare delle implementazioni che per funzioni specifiche). 

Le Azioni

Il programma standard o specifico inizia quindi con questa etichetta $ACTION da scrivere nel seguente modo (dove XXXXXX è il codice dell'evento): 

$ ACTION
Case ACTION
   When "XXXXXX" : Gosub XXXXXX
   When default
Endcase
Return

Ogni evento viene identificato da un codice alfanumerico, contenuto nella variabile ACTION. Se non vi è codice per un evento, il funzionamento della funzione non sarà di ostacolo. Nel sotto-programma $ACTION si gestisce l'indirizzamento all'etichetta aggiunta. In questa sintassi "case ACTION" si indicheranno tante righe quanti sono gli eventi da completare. La $ACTION viene chiamata dal programma supervisore tramite GOSUB; ciò permette di conseguenza di utilizzare delle variabili locali nel programma supervisore.

In allegato viene presentato l'elenco delle azioni. Sarà poi presente la descrizione dettagliata di queste azioni. Viene descritto il contesto chiamante e l'obiettivo di queste azioni.

Aggiunta di azioni specifiche sullo standard

Di default, per uno stesso evento, l'azione specifica è chiamata prima dell'azione standard.

Questa può annullare e sostituire l'azione standard se posiziona la variabile GPE al valore 1.

Per eseguire l'azione standard prima dell'azione specifica, in questo caso, si duplica il programma standard nell'azione specifica, si aggiunge il programma specifico e poi si posiziona la variabile GPE al valore 1. Esempio:

Programma supervisore
GPE=0
Gosub  ACTION  From  pgm_std             ( chiamata dello standard)
If GPE=0
   Gosub  ACTION  From  pgm_spe.            ( chiamata dello specifico)
Endif

Programma specifico
$ ACTION
Case ACTION
   When "OUVRE" : Gosub OUVRE
   When default
Endcase
Return

$OUVRE
...                                                                ( azione specifica OUVRE)
GPE = 1                                                     (nessuna chiamata dello standard a seguito dello specifico)
Return