Spesso, quando si crea una tabella, può essere necessario unire due o più celle per creare un titolo centrato su una particolare sezione della tabella. A partire da 4D v18 R4, è disponibile una nuova serie di comandi che consentono di unire e disunire un gruppo di celle mediante la programmazione. Vediamo alcuni esempi.
Celle unite
Per creare una cella unita, è sufficiente definire un intervallo con tutte le celle che si desidera unire. Passare l’intervallo come parametro al comando VP ADD SPAN e il gioco è fatto!
Ad esempio, utilizziamo il documento qui sotto:
Se si desidera unire le celle del Primo trimestre e del Secondo trimestre nelle celle adiacenti e unire la cella dell’area Sud nelle due righe sottostanti, è sufficiente utilizzare questo codice:
// First quarter range
$q1:=VP Cells ("ViewProArea";2;3;3;1)
// Second quarter range
$q2 :=VP Cells ("ViewProArea";5;3;3;1)
// South area range
$south :=VP Cells ("ViewProArea";0;5;1;3)
VP ADD SPAN (VP Combine ranges ($q1;$q2;$south))
Ecco il risultato:
recuperare le celle unite
Se ora si desidera centrare il testo di tutte le celle unite nel documento, è possibile utilizzare il comando VP Get spans per recuperare tutte le celle unite:
// Search all the merge cells in the spreadsheet
$range:=VP Get spans (VP All ("ViewProArea"))
//applica uno stile a tutte le campate
$style :=New object("vAlign";vk vertical align center; "hAlign";vk horizontal align center)
VP SET CELL STYLE ($range;$style)
rimuovere le celle unite
Se per qualsiasi motivo è necessario rimuovere gli intervalli di celle (ovvero unire le celle) nel documento, basta utilizzare il comando VP REMOVE SPAN:
// Search all the merge cells in the spreadsheet
$range:=VP Get spans (VP All ("ViewProArea"))
// rimuovere le celle unite trovate
VP REMOVE SPAN ($range)
Avete bisogno di ulteriori informazioni? Consultate la documentazione.