DEFVIDMSG

DesktopWeb

La specifica DEFVIDMSG permette di emettere un messaggio a video.

Parametri

Parametro	Definizione	I/O		Versione traduttore	SMP
MSG	Stringa
TIT	Stringa
TIPO	Enumerazione
MODELLO	Enumerazione			30.7
ABBANDONA				30.7
CONFERMA				30.7
SALVA				30.7
VAR	Variabili
CELLA
CANVID	Intero
PAG	Intero
TASTIVID
T
TASTODEFAULT	Intero
ID	Stringa
BOTTONE
DIMENSIONE	Enumerazione			29.3

MSG

StringaInputObbligatorioRipetibileValore non necessarioDesktopWeb

È possibile indicare più messaggi, fino a 20, elencando più attributi MSG[] separati da uno spazio.
Il testo visualizzato è un testo in formato HTML, se si utilizzano i caratteri '<' e '>' il sistema li riconoscerà automaticamente come dei tag html interpretando quanto scritto.
Se all'interno del testo è necessario inserire i caratteri maggiore e minore sarà necessario scrivere come segue:

• '<' si scrive con '&lt'; (senza apici)
• '>' si scrive con '&gr;' (senza apici)

TIT

StringaInputValore non necessarioDesktopWeb

Titolo della videata di messaggio. Se non indicato deriva il titolo della videata sottostante. Può essere una costante o una variabile di tipo stringa.

TIPO

EnumerazioneInputValore non necessarioDesktopWeb

Tipo della videata di messaggio. Il tipo indicato incide sull'icona della videata di messaggio Dev'essere una macro tra quelle disponibili, indicata senza doppi apici.

Parametro enumerato, può assumere i seguenti valori:

Valore	Descrizione
WARNING	Visualizza un triangolo giallo con un punto esclamativo
ERRORE	Visualizza un cerchio rosso con una X
INFO	Visualizza un cerchio blu con una i

MODELLO

30.7EnumerazioneInputValore non necessarioDesktopWeb

Parametro utile per definire le caratteristiche del messaggio da presentare conforme agli standard di interfaccia utente definiti da Sistemi.
Permette di applicare al messaggio un set di informazioni predefinite quali: Titolo della videata, numero di bottoni ed icona. L'utilizzo del modello permette di uniformare l'utilizzo delle videate di messaggio all'interno del programma

Parametro enumerato, può assumere i seguenti valori:

Valore	Descrizione
ERRORE	Messaggio di tipo errore
INFO	Messaggio di tipo Info
WARNING	Messaggio di tipo warning (2 tasti)
ABBANDONASALVAMODIFICA	Messaggio con tre tasti: abbandona, salva e non salvare
ABBANDONACONFERMAMODIFICA	Messaggio con tre tasti: abbandona, conferma e non confermare
ELIMINA	Messaggio di eliminazione
ABBANDONAANNULLA	Messaggio di abbandono operazione

L'utilizzo del parametro esclude l'utilizzo dei parametri: TIPO, BOTTONE, TASTODEFAULT

ABBANDONA

30.7InputValore non necessarioDesktopWeb

SottoParametri

[callback] Callback richiamata alla pressione del tasto F1. Il suo utilizzo è esclusivo per la gestione dei modelli, non verrà più gestita la variabile ABCPRB.

L'utilizzo del parametro implica l'utilizzo del parametro MODELLO

CONFERMA

30.7InputValore non necessarioDesktopWeb

SottoParametri

[callback] Callback richiamata alla pressione dei tasti F4/F8 a seconda del modello corrente. Il suo utilizzo è esclusivo per la gestione dei modelli, non verrà più gestita la variabile ABCPRB

L'utilizzo del parametro implica l'utilizzo del parametro MODELLO

SALVA

30.7InputValore non necessarioDesktopWeb

SottoParametri

[IDBOTTONE[IdentificativoBottone]]
Identificativo del bottone che scatena la sua AZIONE dopo la pressione del tasto Salva/Conferma (End)

L'utilizzo del parametro implica l'utilizzo del parametro MODELLO

VAR

VariabiliInputValore non necessarioDesktopWeb

Definisce la variabile che è associata al controllo su cui si intende assegnare il fuoco.
Questa variabile può fare riferimento ad un controllo di tipo edit, griglia o albero.

CELLA

InputValore non necessarioDesktop

[<riga>, <colonna>|<variabile-cella>] [<riga>, <colonna>]: definisce le coordinate della cella della griglia su cui si intende attivare il fuoco; in questa situazione <variabile-controllo> deve riferire la variabile della griglia. [<variabile-cella>]: definisce la variabile associata alla cella su cui si vuole attivare il fuoco; questa opzione è alternativa all'indicazione [<riga>, <colonna>] ed ha il limite di lavorare sulla riga corrente. Questo significa che la variabile viene ricercata tra le variabili associate alle celle della riga corrente.

CANVID

InteroInputValore non necessarioDesktop

Definisce il valore che deve assumere la variabile CANVID prima del ritorno alla videata.

Il parametro consente di fare in modo che al rientro nella videata questa venga rieseguita, e quindi siano eseguite anche le decodifiche dei campi (CANVID=1) oppure evitare che la videata sia completamente ridisegnata.

Il parametro DEVE essere valorizzato =1 (uno) nei casi di videate composte e sincronizzate.

PAG

InteroInputValore non necessarioDesktop

Numero identificativo della pagina di una videata multipagina su cui eseguire il posizionamento.

TASTIVID

InputValore non necessarioDesktop

Elenco dei tasti presenti nell'attributo T[] che se premuti consentono di eseguire il posizionamento sulla videata. Il posizionamento sulla videata verrà eseguito solo se è presente il parametro TASTIVID[]. Il parametro può essere indicato solo se la specifica '@DEFVIDMSG[] è indicata sotto una videata. Nel caso in cui, invece, venga indicata ad esempio in una callback di uscita riga, non può essere indicato l'attributo TASTIVID[]. In questo caso, se sono presenti entrambi i tasti funzione, deve essere specificato, per il tasto che ritorna alla videata, il posizionamento attraverso la '@DEFVIDPOS[].

T

InputValore non necessarioDesktop

• Tasto: è il tasto funzione da attivare. Possono essere attivati solo i tasti <F1> o <F4>, con il significato standard, rispettivamente di 'Ripristino' e 'Conferma'.
• Descr (Opzionale): è la descrizione associata al tasto funzione abilitata; se non si indica nulla, i tasti avranno associata la descrizione di default.
• Azione (Opzionale) è l'istruzione o la sequenza di istruzioni Basic-like che devono essere eseguite nel caso in cui il tasto specificato venga premuto. Può avere le due seguenti forme:

1. Numero Linea: indica la linea a cui saltare in caso il tasto sia stato premuto.
2. Istruzioni: Viene specificata una serie di istruzioni da eseguire se il tasto viene premuto.

informazioni

Non è ammesso l'utilizzo di istruzioni IF. Se questo parametro non è presente, ma il tasto è indicato nell'attributo TASTIVID[], verrà eseguito un posizionamento alla videata precedente. Alla pressione dei tasti funzione abilitati sulla specifica viene valorizzata la variabile d'ambiente ABCPRB%, che può essere successivamente testata nel programma.

L'utilizzo del parametro esclude l'utilizzo del parametro BOTTONE

TASTODEFAULT

InteroInputValore non necessarioDesktop

Permette di scegliere su quale tasto posizionare il fuoco.
Di default il tasto predefinito è sempre il primo. Per posizionarsi sul secondo tasto, indicare 2. Per le azioni volontarie, come le conferme di eliminazioni, i salvataggi ecc, il tasto predefinito dovrebbe essere sempre quello di conferma, a vantaggio dell'operatività. Per le azioni involontarie, come i controlli di uscita dal campo, il tasto predefinito dovrebbe essere quello di annullamento dell'azione. Può essere una costante o una variabile di tipo intero.

ID

StringaInputValore non necessarioDesktop

Definisce la variabile o la costante di programma che contiene l'identificatore univoco del controllo.

note

Viene utilizzato dall'ambiente per gestire le personalizzazioni effettuate durante l'esecuzione del programma.

BOTTONE

InputRipetibileValore non necessarioDesktopWeb

SottoParametri

TITOLO[TitoloVar] [AZIONE[AzioneBottone]] ACCELERATORE[Acceleratore] [IDBOTTONE[IdentificativoBottone]]

Elenco dei bottoni presenti nella videata di messaggio visualizzata.

L'utilizzo del parametro esclude l'utilizzo dei parametri: CANVID, TASTIVID, PAG, T, CELLA, VAR, ID

DIMENSIONE

29.3EnumerazioneInputValore non necessarioWeb

Dimensione in larghezza del messaggio.

Parametro enumerato, può assumere i seguenti valori:

Valore	Descrizione
PICCOLA
MEDIA
GRANDE

Esempi

Videata con bottoni standard

 ' Il parametro MODELLO può assumere i valori riportati nella documentazione  
 '@DEFVIDMSG MSG["Messaggio"] MODELLO[#INFO] CONFERMA[ActionConfirm()]

Videata con bottoni personalizzati

 ' Il parametro TIPO può assumere i valori riportati nella documentazione
 '@DEFVIDMSG MSG["Messaggio"] TIPO[#INFO] _
             BOTTONE[TITOLO["Conferma"]  ACCELERATORE["F4"] AZIONE[ActionConfirm()]]