DEFBUTTON

DesktopWebMobileResponsive

Obsoleti

Definisce le caratteristiche del bottone che si vuole inserire nella videata.

Parametri

Parametro	Definizione	I/O		Versione traduttore	SMP
ID	Stringa
VAR	Variabile
POS
DIM
AZIONE
ACCELERATORE	Stringa
CONVARIABILI	Intero
STILE	Stringa
NASCOSTO	Condizione
INVISIBILE	Intero			30.2
DISABILITATO	Condizione
IMMAGINE	Variabile
IMMAGINEDIS	Variabile
VARIMMAGINEENUMERATO	Variabile			30.2
POSIMMAGINE	Enumerazione
MARGINEIMMAGINE	Intero
COMMENTO	Variabile
TASTOINTERRUZIONE	Intero
EVIDENZIATO	Condizione
ANCORA	Stringa
GRID
STACK
EXPANDER
DOCK
PERSONALIZZABILE	Intero
LINKTO
BADGE	Variabile
VALIDADATI	Enumerazione
RET				27.2
RILEVANZA	Enumerazione			29.3

ID

StringaInputValore non necessarioDesktopWebMobileResponsive

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.

VAR

VariabileInputObbligatorioValore non necessarioDesktopWebMobileResponsive

Attributo di associazione di un testo costante o variabile al bottone visualizzato nella cella.

POS

InputValore non necessarioDesktopWebMobile

Posizionamento del controllo.

Consente di indicare la riga e la colonna. Per entrambi è possibile specificare l'unità di misura.

POS[RigaVid [UnitàMisura], ColonnaVid [UnitàMisura]]

note

L'unità di misura può essere: 'C' per il posizionamento a caratteri e 'P' per il posizionamento in pixel. L'indicazione è opzionale, se omesso si assume 'C' come default.

DIM

InputObbligatorioValore non necessarioDesktopWebMobile

Dimensione del controllo.

Consente di indicare l'altezza e la larghezza. Per entrambi è possibile specificare l'unità di misura.

DIM[Altezza [UnitàMisura], Larghezza [UnitàMisura]]

note

L'unità di misura può essere: 'C' per il posizionamento a caratteri e 'P' per il posizionamento in pixel. L'indicazione è opzionale, se omesso si assume 'C' come default.

AZIONE

InputValore non necessarioDesktopWebMobileResponsive

SottoParametri

Definisce l'azione da eseguire quando il bottone viene premuto con il mouse.

L'utilizzo del parametro esclude l'utilizzo del parametro TASTOINTERRUZIONE

ACCELERATORE

StringaInputValore non necessarioDesktop

Definizione del tasto che, se premuto, ha lo stesso effetto del click sul bottone.
I tasti ammessi sono combinazioni di <Ctrl+Alt> oppure solo <Alt> e un carattere della tastiera; il formalismo prevede la notazione 'Ctrl-Alt+' oppure 'Alt+' seguita dal carattere scelto (es.: 'Ctrl+Alt+G', 'Alt+H'). I caratteri ammessi sono: lettere, numeri e i seguenti caratteri speciali '+-*/'.

note

• Alcune combinazioni di tasti sono state riservate per il richiamo rapido da tastiera delle funzionalità messe a disposizione dall’ambiente di sviluppo.
• Dalla versione 26.1 del traduttore, il valore del parametro va indicato tra doppi apici.

CONVARIABILI

InteroInputValore non necessarioDesktopWebMobileResponsive

La presenza del parametro istruisce il programma ad acquisire le variabili della videata prima di eseguire l'azione richiesta.
Consente, prima di eseguire l'azione associata al bottone, di produrre le decodifiche della videata e i relativi controlli di validità sui valori immessi, bloccando l'esecuzione dell'azione nel caso di errore.

Parametro con valori ammessi, si possono utilizzare i seguenti valori:

Valore	Descrizione
0	No
1	Si

STILE

StringaInputValore non necessarioDesktopWebMobileResponsive

Attributo di definizione dello stile da applicare al controllo.

Può essere una delle costanti definite in BC per gli stili oppure uno stile precedentemente definito tramite @DEFSTYLE.

NASCOSTO

CondizioneInputValore non necessarioDesktopWebMobileResponsive

Attributo che consente di nascondere il controllo.

note

All'interno dell'espressione è possibile utilizzare gli operatori 'AND' e 'OR' per generare istruzioni condizionali composte.
Se l'espressione risulta vera il controllo viene nascosto, in caso contrario viene visualizzato.

INVISIBILE

30.2InteroInputValore non necessarioDesktop

Attributo che permette di rendere invisibile il bottone.

note

Il bottone si nasconde ma rimane richiamabile attraverso uno shortcut.

DISABILITATO

CondizioneInputValore non necessarioDesktopWebMobileResponsive

Variabile che gestisce la disabilitazione del controllo

IMMAGINE

VariabileInputValore non necessarioDesktopWebMobileResponsive

Specifica il nome del file contenente l'immagine o la risorsa immagine da visualizzare.

note

Sono supportate solo immagini di tipo BMP e PNG.

IMMAGINEDIS

VariabileInputValore non necessarioDesktop

Nome dell'immagine da associare quando il bottone è disabilitato. Se non specificato si utilizza l'immagine definita con IMMAGINE.

note

Sono supportate solo immagini di tipo BMP e PNG

VARIMMAGINEENUMERATO

30.2VariabileInputValore non necessarioDesktop

Da utilizzare in sostituzione del parametro IMMAGINE. Attraverso la gestione del tipo dato <Immagine> è possibile assegnare un'immagine specifica al controllo. Alla variazione del tipo dato, varierà automaticamente l'immagine sul bottone.

L'utilizzo del parametro esclude l'utilizzo dei parametri: IMAGE, IMMAGINE, IMMAGINEDIS

POSIMMAGINE

EnumerazioneInputValore non necessarioDesktopWebMobile

Indica la posizione dell'immagine rispetto al testo del bottone.
I valori ammessi sono:
<tabella> Valore Descrizione SINISTRA Immagine a sinistra e testo a destra (default) DESTRA Immagine a destra e testo a sinistra </tabella>

Parametro enumerato, può assumere i seguenti valori:

Valore	Descrizione
ALTO	Immagine sopra e testo sotto
BASSO	Immagine sotto e testo sopra
SINISTRA	Immagine a sinistra e testo a destra (DEFAULT)
DESTRA	Immagine a destra e testo a sinistra
CENTRO	Immagine a destra e testo a sinistra

MARGINEIMMAGINE

InteroInputValore non necessarioDesktop

Indica il margine che deve essere presente tra l'icona del pulsante e il suo testo descrittivo.

note

• Perde di significato se non è presente il parametro IMMAGINE.
• Attraverso la gestione del tipo dato <Immagine> è possibile assegnare un'immagine specifica al controllo.

COMMENTO

VariabileInputValore non necessarioDesktopWebMobileResponsive

SottoParametri

Definizione del tip multilinea di commento da associare al pulsante.
Il commento rimarrà visibile per il tempo in cui il mouse punterà sul pulsante interessato.

TASTOINTERRUZIONE

InteroInputValore non necessarioDesktop

Definisce il bottone come bottone di interruzione.
Se presente è necessario che:

• la finestra sia di solo output.
• ci sia un solo bottone di interruzione sulla finestra.

Parametro con valori ammessi, si possono utilizzare i seguenti valori:

Valore	Descrizione
0	Nessuna tasto interruzione
1	Inserisci tasto interruzione

L'utilizzo del parametro esclude l'utilizzo del parametro AZIONE

EVIDENZIATO

CondizioneInputValore non necessarioDesktopWebMobileResponsive

Attributo di evidenziazione del bottone. Quando evidenziato, nell'angolo inferiore destro è visualizzato un triangolino colorato, segno di evidenziazione.

ANCORA

StringaInputValore non necessarioDesktop

Permette di ancorare la posizione dell'immagine ad un lato della finestra, in modo che al ridimensionamento di questa la posizione relativa dell'immagine non cambi

Parametro con valori ammessi, si possono utilizzare i seguenti valori:

Valore	Descrizione
'DESTRA'	L'immagine è ancorata al lato destro della finestra
'SOTTO'	L'immagine è ancorata al lato inferiore della finestra
'SOTTODESTRA'	L'immagine è ancorata al lato inferiore e destro della finestra
'DESTRACLIP'	L'immagine è ancorata al lato destro della finestra. Se la finestra è ridimensionata meno della dimensione iniziale, l'immagine rimane nella posizione iniziale prevista dal programma
'SOTTOCLIP'	L'immagine è ancorata al lato inferiore della finestra. Se la finestra è ridimensionata meno della dimensione iniziale, l'immagine rimane nella posizione iniziale prevista dal programma
'SOTTODESTRACLIP'	L'immagine è ancorata al lato inferiore e destro della finestra. Se la finestra è ridimensionata meno della dimensione iniziale, l'immagine rimane nella posizione iniziale prevista dal programma

GRID

InputValore non necessarioDesktopWebMobile

SottoParametri

Attached Property per pannello di tipo Grid

STACK

InputValore non necessarioDesktop

SottoParametri

Attached Property per pannello di tipo Stack

EXPANDER

InputValore non necessarioDesktop

SottoParametri

Attached Property per pannello di tipo Expander

DOCK

InputValore non necessarioDesktop

SottoParametri

Consente di indicare se l'oggetto deve occupare tutto lo spazio del DockPanel in verticale e/o in orizzontale (possono essere indicati entrambi).

PERSONALIZZABILE

InteroInputBinarioValore non necessarioDesktop

Definisce l'oggetto grafico come personalizzabile dall'utente in fase di runtime.

Parametro con valori ammessi, si possono utilizzare i seguenti valori:

Valore	Descrizione
0	No
1	Si

LINKTO

InputValore non necessarioDesktopResponsive

SottoParametri

Permette di creare un legame tra due controlli esistenti all'interno della stessa videata.

BADGE

VariabileInputValore non necessarioDesktop

Visualizza un contatore sul controllo

VALIDADATI

EnumerazioneInputValore non necessarioDesktopWebMobileResponsive

Effettua la validazione prima dell'azione definita sul tasto.

Parametro enumerato, può assumere i seguenti valori:

Valore	Descrizione
PROPRIETA
OGGETTO
NESSUNA
PROPRIETANORIGA

RET

27.2InputValore non necessarioWebMobile

Coordinate della cella del reticolo da associare al controllo.
Queste informazioni hanno lo scopo di inserire il controllo nella logica di gestione degli spostamenti sulla videata.

RILEVANZA

29.3EnumerazioneInputValore non necessarioWebMobileResponsive

Definisce la rilevanza del bottone.

note

• Ad ogni rilevanza corrisponde una grafica differente.
• Per i bottoni il default è #SECONDARIO, per toolbar e messageBox è #LEGGERO.

Parametro enumerato, può assumere i seguenti valori:

Valore	Descrizione
PRIMARIO
SECONDARIO
LEGGERO
ATTENZIONE
CONTESTUALE
SISTEMIAI

Esempi

Esempio

 '@DEFVID DIM[20,70] TIT["Videata"] ID["IdVideata"]
 
    '@DEFGRIDPANEL NOME[GridPanel] ID["IDGrid"] _
                   RIGA[ALTEZZA[0.5] LAYOUT[#FISSO]] _
                   RIGA[ALTEZZA[1] LAYOUT[#FISSO]] _
                   RIGA[ALTEZZA[0.5] LAYOUT[#FISSO]] _
                   COLONNA[LUNGHEZZA[0.5] LAYOUT[#FISSO]] _
                   COLONNA[LUNGHEZZA[69] LAYOUT[#DINAMICO]] _
                   COLONNA[LUNGHEZZA[0.5] LAYOUT[#FISSO]] _
                   
       '@DEFBUTTON ID["IDBottone"] VAR["Configurazione"] POS[1,1] DIM[1,1] _
                   AZIONE[Configurazione()] IMMAGINE["configurazione.bmp"] POSIMMAGINE[ALTO] _
                   GRID[COL[2] RIGA[2] COLDIN[1]]
    
    '@ENDGRIDPANEL NOME[GridPanel]
 
 '@RUNVID