Per creare documenti di facile consultazione, spesso è necessario nascondere una linea di griglia o un’intestazione, proteggere alcune celle o semplicemente cambiare il colore delle linee per rispettare l’identità aziendale. Con 4D v18 R3, è possibile fare tutto questo e altro ancora con il nuovo comando VP SET SHEET OPTIONS e molto altro ancora.
Proteggere un foglio
La protezione di un foglio di lavoro impedisce la modifica delle celle al suo interno. Per impostazione predefinita, tutte le celle di un documento 4D View Pro sono contrassegnate come bloccate. Se si desidera proteggere l’intero foglio di lavoro, è sufficiente scrivere:
$options:=New object
// Activate protection
$options .isProtected:=True
// Apply protection on the current sheet
VP SET SHEET OPTIONS ("ViewProArea";$options)
Se si desidera consentire agli utenti di modificare celle specifiche, è possibile proteggere il foglio di lavoro e sbloccare solo le celle che l’utente può modificare.
Come dimostrato dall’esempio precedente, impostando l’opzione isProtected a Vero protegge l’intero foglio di lavoro. Se si desidera proteggere tutte le celle tranne l’intervallo C5:D10, è sufficiente contrassegnare l’intervallo come sbloccato:
$options:=New object
// Activate protection
$options .isProtected:=True
// Apply protection on the current sheet
VP SET SHEET OPTIONS ("ViewProArea";$options)
// mark cells C5:D10 as 'unlocked'
VP SET CELL STYLE (VP Cells ("ViewProArea";2;4;2;6);New object("locked";False))
La proprietà protectionOptions può essere utilizzata per specificare le modifiche consentite all’utente, come il ridimensionamento, il trascinamento, l’inserimento o l’eliminazione di righe e colonne e così via.
Volete proteggere il vostro documento ma permettere agli utenti di ridimensionare righe e colonne? Potete scrivere questo:
$options:=New object
// Activate protection
$options .isProtected:=True
$options .protectionOptions:=New object
// Allow user to resize rows
$options .protectionOptions.allowResizeRows=True;
// Allow user to resize columns
$options .protectionOptions.allowResizeColumns=True;
// Apply protection on the current sheet
VP SET SHEET OPTIONS ("ViewProArea";$options)
Modificare l’aspetto del foglio di lavoro
Modifica dei colori
Il comando VP SET SHEET OPTIONS consente inoltre di personalizzare i colori delle schede del foglio di lavoro, delle linee congelate, delle linee della griglia o dello sfondo e del bordo di una selezione.
$options:=New object
// Customize color of Sheet 1 tab
$options .sheetTabColor:="Nero"
$options .gridline:=New object("colore"; "Viola")
$options .selectionBackColor:="rgba(255,128,0,0.4)"
// Use rgba() for the transparency. Here : 40% transparency
$options.selectionBorderColor:="Giallo"
$options .frozenlineColor:="Oro"
VP SET SHEET OPTIONS ("ViewProArea";$options;0)
// Customize color of Sheet 2 tab
$options.sheetTabColor:="rosso"
VP SET SHEET OPTIONS ("ViewProArea";$options;1)
// Customize color of Sheet 3 tab
$options.sheetTabColor:="blu"
VP SET SHEET OPTIONS ("ViewProArea";$options;2)
Ecco il risultato:
Nascondi elementi
VP SET SHEET OPTIONS Il comando consente anche di gestire la visibilità delle linee della griglia e delle intestazioni di riga e colonna del foglio di lavoro:
$options:=New object
$options .gridline:=New object()
$options .gridline.showVerticalGridline:=False
$options .gridline.showHorizontalGridline:=False
$options .rowHeaderVisible:=False
$options .colHeaderVisible:=False
VP SET SHEET OPTIONS ("ViewProArea";$options)
Osservate il risultato:
foglio di lavoro Area Offset
Poiché i bordi vengono disegnati all’esterno delle celle, è possibile utilizzare la proprietà sheetAreaOffset per assicurarsi che l’intero foglio di lavoro venga visualizzato:
$options:=New object
$options .sheetAreaOffset:=New object
$options .sheetAreaOffset.left:=2
$options .sheetAreaOffset.top:=2
VP SET SHEET OPTIONS ("ViewProArea";$options)
Trovate ulteriori informazioni nel doc center e non dimenticate di provare questo comando con l’HDI di cui sopra.