DEFWEDITOR
La specifica '@DEFWEDITOR consente di definire le informazioni di posizionamento, dimensione ecc. di un editor di documenti Word rispetto alla videata a cui si riferisce.
La definizione dell'editor Word deve essere posta tra '@DEFVID e '@RUNVID.
Al termine dell'esecuzione la specifica valorizza due variabili d'ambiente:
- ZWSTATUS con lo stato di modifica del documento WORD (se il documento è stato modificato la variabile vale 1, altrimenti vale 0)
- ZWZOOM con la percentuale di zoom corrente
Parametri
| Parametro | Definizione | I/O | Versione traduttore | SMP | |
|---|---|---|---|---|---|
| ID | Stringa | ||||
| IDWDOC | Stringa | ||||
| FILE | Stringa | ||||
| MODELLO | Stringa | ||||
| RET | |||||
| POS | |||||
| DIM | |||||
| SOLALETTURA | Intero | ||||
| NASCOSTO | Condizione | ||||
| DISABILITATO | Condizione | ||||
| ZOOM | Intero | ||||
| VISUALIZZAZIONE | Intero | ||||
| DROP | |||||
| GRID | |||||
| STACK | |||||
| EXPANDER | |||||
| DOCK | |||||
| PERSONALIZZABILE | Intero | ||||
| LINKTO | |||||
| AZIONEINCOLLA | Azione | 33.0 |
ID
Variabile o costante di programma che contiene l'identificatore univoco del controllo.
IDWDOC
Definisce la variabile o la costante di programma che contiene l'identificatore univoco del controllo.
Viene utilizzato dall'ambiente per gestire le personalizzazioni effettuate durante l'esecuzione del programma.
FILE
Nome del file Word, comprensivo di percorso, da caricare all'interno dell'Editor.
Se non specificato o se il file non esiste, l'editor apre un documento nuovo usando il modello specificato dall'attributo MODELLO.
Variabile di tipo stringa o costante racchiusa tra doppi apici.
MODELLO
Nome del file modello (.dot), comprensivo di percorso, da utilizzare per un documento nuovo da utilizzare come modello per il documento Word.
Variabile di tipo stringa oppure costante racchiusa tra doppi apici.
RET
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.
POS
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]]
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
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]]
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.
SOLALETTURA
Flag indicante se il testo deve essere di sola lettura.
Qualora non venga indicato, si assume che il documento sia editabile (non sola lettura).
Costante o variabile di tipo intero.
Può assumere i valori:
Fino a BC/X v.16.2, il parametro SOLALETTURA = 1 consentiva la modifica del documento, ma ne impediva il successivo salvataggio. A partire da BC/X v. 16.3, SOLALETTURA = 1 impedisce anche la modifica del documento.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
NASCOSTO
Attributo che consente di nascondere e visualizzare il controllo.
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.
DISABILITATO
Attributo di disabilitazione del controllo.
Se l'espressione risulta vera il controllo viene disabilitato.
Costante o variabile di tipo intero.
ZOOM
Permette di definire la percentuale di ZOOM per la visualizzazione di un documento.
I valori ammessi sono i numeri da 0 a 100.
Se non indicato, il fattore di ZOOM assume il valore d'ufficio previsto per l'installazione di WORD.
VISUALIZZAZIONE
Permette di scegliere la modalità di visualizzazione del documento tra normale, layout di stampa e struttura.
Costante o variabile di tipo intero.
Valori ammessi:
| Valore | Descrizione |
|---|---|
| 1 | Normale |
| 2 | Layout di struttura |
| 3 | Layout di stampa |
| 5 | Struttura documento |
Se non indicato, il valore assume quello della modalità di visualizzazione d'ufficio prevista per l'installazione di WORD.
DROP
Consente di definire il comportamento da attenere nel caso in cui venga rilasciato sul controllo un oggetto del tipo indicato. Il nome dell'oggetto ha una duplice funzione:
- Consente di riconoscere l'oggetto trascinato sul controllo al fine di modificare il cursore del mouse, indicando che è possibile un'operazione di DROP
- Consente di riconoscere l'oggetto rilasciato sul controllo al fine di eseguire la corrispondente azione
Sintassi:
-
NomeOggetto: identifica il nome dell'oggetto che deve essere riconosciuto dal controllo. È una costante o una variabile di tipo stringa.
-
Azione: È il nome della subroutine di programma che contiene il codice di gestione dell'operazione di DROP. Eventualmente può essere una sequenza di istruzioni (senza GOTO). Questa routine è richiamata direttamente dall'editor a fronte del rilascio dell'oggetto sul controllo.
All'interno della subroutine di DROP dovrà essere indicata la specifica '@GETDROPPEDOBJECT.
EXPANDER
Attached Property per pannello di tipo Expander
DOCK
Consente di indicare se l'oggetto deve occupare tutto lo spazio del DockPanel in verticale e/o in orizzontale (possono essere indicati entrambi).
PERSONALIZZABILE
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
[ID[IdentificativoControllo] PRINCIPALE[FlagSiNo]]
Permette di creare un legame tra due controlli esistenti all'interno della stessa videata.
AZIONEINCOLLA
Azione da eseguire all'intercettazione dell'azione 'incolla' su Word da parte dell'utente
Esempi
Definizione controllo
' ZoomValue impostato alla prima apertura del programma
ZoomValue = 80
' In caso di salvataggio precedente - lettura di ZoomValue
GetZoom()
DIM fileName[TIPO[BCFILE]]
DIM model[STRING]
DIM onlyRead[INT]
DIM hiddenEditor[INT]
DIM disabledEditor[INT]
DIM IdDoc[INT]
'@DEFVID DIM[20, 75] NOME[Videata] ID["IDVIDEATA"] TIT["Titolo Videata"] TOOLBAR[IDTOOLBAR["TOOLBAR"]]
'@DEFTOOLBAR IDTOOLBAR["TOOLBAR"] _
BOTTONE[IDBOTTONE["SYS_EXIT"] AZIONE[Exit()]] _
BOTTONE[IDBOTTONE["SYS_EXIT_ESC"] AZIONE[Exit()] NASCOSTO[1]] _
BOTTONE[IDBOTTONE["SYS_SAVE"] AZIONE[GoSub Save]] _
'@DEFGRIDPANEL NOME[GridPanel] ID["GridPanel"] _
RIGA[ALTEZZA[0.5] LAYOUT[#FISSO]] _
RIGA[ALTEZZA[18] LAYOUT[#FISSO]] _
RIGA[ALTEZZA[0.5] LAYOUT[#FISSO]] _
COLONNA[LUNGHEZZA[0.5] LAYOUT[#FISSO]] _
COLONNA[LUNGHEZZA[68] LAYOUT[#DINAMICO]] _
COLONNA[LUNGHEZZA[0.5] LAYOUT[#FISSO]]
'@DEFWEDITOR ID["IDEDITOR"] _
IDWDOC[IdDoc] _
FILE[fileName] _
MODELLO[model] _
SOLALETTURA[onlyRead] _
NASCOSTO[hiddenEditor] _
DISABILITATO[disabledEditor] _
RET[1,1] POS[2,1] DIM[1,1] _
VISUALIZZAZIONE[3] _
ZOOM[ZoomValue] _
GRID[RIGA[2] COL[2] RIGADIN[1] COLDIN[1]]
'@ENDGRIDPANEL NOME[GridPanel]
'@RUNVID
...
'@SRP Exit()
'@EXITWINDOW
Return
...
'@SR Save
' Salvataggio valore di zoom corrente
ZoomValue = ZWZOOM
' SalvaZoom()
' Logica per salvataggio documento
Return
...
'@SRP GetZoom()
' Lettura valore di zoom salvato precedentemente
Return