DEFDOCKPANEL

Desktop

Consente di definire un pannello con layout dinamico di tipo Dock.

Devono essere definiti sulla videata e devono essere 'fissati' ad uno dei suoi lati, non possono essere contenuti in un altro tipo di pannello, sono dei contenitori di altri pannelli o di controlli a video.

note

• Bisogna richiamare la specifica di chiusura @ENDDOCKPANEL.
• I metodi sono richiamabili nella callback specificata nel parametro ONLOAD della @DEFVID per le impostazioni della prima visualizzazione oppure in una qualsiasi azione per modificare le impostazioni in un secondo momento.

Parametri

Parametro	Definizione	I/O		Versione traduttore	SMP
NOME	Intero
DIM
RET
MARGINI
ID	Stringa
TIT	Variabile
IMMAGINE	Variabile
STATO	Intero
DOCK	Enumerazione
ALLINEAMENTO	Enumerazione
PERSONALIZZABILE	Intero
LINKTO
NASCOSTO	Condizione
DISABILITATO	Condizione
OUTPUT	Condizione
AZIONEINVIO

NOME

InteroInputObbligatorioValore non necessarioDesktopWebMobile

Nome del controllo

DIM

InputObbligatorioValore non necessarioDesktop

Consente di definire le dimensioni del pannello.

note

Se il parametro DIM è omesso il dimensionamento coincide con la videata o il contenitore al cui interno stiamo inserendo il nuovo pannello, possiamo quindi definire un dimensionamento fisso oppure ereditarlo dal contenitore 'padre'.

RET

InputObbligatorioValore non necessarioDesktop

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.

MARGINI

InputValore non necessarioDesktop

Consente di definire un margine (padding) a sinistra e sopra (left e top) dei componenti inseriti al suo interno.

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.

TIT

VariabileInputObbligatorioValore non necessarioDesktop

Consente di indicare il titolo del pannello.

Indicando tale parametro viene definita in testa al pannello una riga di intestazione con il testo al suo interno.

IMMAGINE

VariabileInputValore non necessarioDesktop

Consentire di definire il nome dell'immagine da utilizzare sul titolo del pannello.

STATO

InteroInputValore non necessarioDesktop

Consente di definire lo stato del pannello, da programma BC è possibile pilotare se impostare il pannello nello stato aperto o nello stato chiuso.

DOCK

EnumerazioneInputObbligatorioValore non necessarioDesktop

Consente di definire su quale lato della videata deve essere 'dockato' il pannello.

Parametro enumerato, può assumere i seguenti valori:

Valore	Descrizione
SINISTRA	Allineamento a sinistra
ALTO	Allineamento in alto
DESTRA	Allineamento a destra
BASSO	Allineamento in basso

ALLINEAMENTO

EnumerazioneInputValore non necessarioDesktop

Consente di definire l'allineamento in caso di definizione di più pannelli di tipo dock sullo stesso lato di docking.

Il parametro è obbligatorio sul secondo dock se sono stati definiti due pannelli sullo stesso lato di docking.

Viene applicato sul pannello di tipo dock che lo precede nella definizione della videata.

Parametro enumerato, può assumere i seguenti valori:

Valore	Descrizione
SINISTRA	Allineamento a sinistra
ALTO	Allineamento in alto
DESTRA	Allineamento a destra
BASSO	Allineamento in basso

PERSONALIZZABILE

InteroInputBinarioValore non necessarioDesktop

Consente di definire 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 necessarioDesktop

SottoParametri

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

NASCOSTO

CondizioneInputValore non necessarioDesktop

Permette di indicare la condizione per nascondere il controllo.

note

La condizione viene applicata solo in fase di creazione della videata (in contesto desktop).

DISABILITATO

CondizioneInputValore non necessarioDesktop

Permette di indicare la condizione per disabilitare il controllo.

OUTPUT

CondizioneInputValore non necessarioDesktop

Permette di indicare la condizione per rendere in output il controllo.

AZIONEINVIO

InputValore non necessarioDesktop

SottoParametri

Consente di indicare il tasto da simulare alla pressione del tasto INVIO.

L'utilizzo del parametro implica l'utilizzo del parametro ID

Metodi

Metodo	Descrizione	SMP
Apri	Apre il DockPanel
Chiudi	Chiude il DockPanel

Esempi

Definizione DockPanel

    '@DEFVID DIM[20,70] TIT["Videata"] ID["IDVideata"]
    
       '@DEFGRIDPANEL NOME[Gridpanel] ID["IDGridPanel"]_
                      RIGA[ALTEZZA[1] LAYOUT[#FISSO]] _
                      COLONNA[LUNGHEZZA[70] LAYOUT[#DINAMICO]]
          
          '@DEFLABEL ID["IDLabelFuoriDock"] VAR["Fuori dock"] DIM[1,1] POS[1,1] _
                     GRID[COL[1] RIGA[1] COLDIN[1]]               
       
       '@ENDGRIDPANEL NOME[Gridpanel]
       
       'Definizione DockPanel sul lato sinistro della videata
       '@DEFDOCKPANEL NOME[DockPanel] ID["IDDockPanel"] TIT["Dock 1"] DOCK[#SINISTRA] DIM[10,30] RET[1,1]
       
          '@DEFGRIDPANEL NOME[Gridpanel2] ID["IDGridPanel2"] _
                         RIGA[ALTEZZA[1] LAYOUT[#FISSO]] _
                         RIGA[ALTEZZA[1] LAYOUT[#FISSO]] _
                         COLONNA[LUNGHEZZA[1] LAYOUT[#FISSO]] _
                         COLONNA[LUNGHEZZA[28] LAYOUT[#DINAMICO]] _
                         COLONNA[LUNGHEZZA[1] LAYOUT[#FISSO]]
                         
             '@DEFLABEL ID["IDLabelDentroDock"] VAR["Dentro dock"] DIM[1,1] POS[1,1] _
                        GRID[COL[1] RIGA[1] COLDIN[1]]     
          
          '@ENDGRIDPANEL NOME[Gridpanel2]
       
       '@ENDDOCKPANEL NOME[DockPanel]
       
    '@RUNVID