Questa pagina è stata tradotta dall'API Cloud Translation.

Class EmbeddedTableChartBuilder

Strumento per la creazione di grafici a tabella. Per ulteriori dettagli, consulta la documentazione di Gviz.

Metodi

Metodo	Tipo restituito	Breve descrizione
`addRange(range)`	`EmbeddedChartBuilder`	Aggiunge un intervallo al grafico modificato da questo generatore.
`asAreaChart()`	`EmbeddedAreaChartBuilder`	Imposta il tipo di grafico su AreaChart e restituisce `EmbeddedAreaChartBuilder`.
`asBarChart()`	`EmbeddedBarChartBuilder`	Imposta il tipo di grafico su Grafico a barre e restituisce un `EmbeddedBarChartBuilder`.
`asColumnChart()`	`EmbeddedColumnChartBuilder`	Imposta il tipo di grafico su ColumnChart e restituisce un `EmbeddedColumnChartBuilder`.
`asComboChart()`	`EmbeddedComboChartBuilder`	Imposta il tipo di grafico su ComboChart e restituisce `EmbeddedComboChartBuilder`.
`asHistogramChart()`	`EmbeddedHistogramChartBuilder`	Imposta il tipo di grafico su IstogramChart e restituisce un `EmbeddedHistogramChartBuilder`.
`asLineChart()`	`EmbeddedLineChartBuilder`	Imposta il tipo di grafico su LineChart e restituisce `EmbeddedLineChartBuilder`.
`asPieChart()`	`EmbeddedPieChartBuilder`	Imposta il tipo di grafico su Grafico a torta e restituisce un `EmbeddedPieChartBuilder`.
`asScatterChart()`	`EmbeddedScatterChartBuilder`	Imposta il tipo di grafico su Grafico a dispersione e restituisce un valore `EmbeddedScatterChartBuilder`.
`asTableChart()`	`EmbeddedTableChartBuilder`	Imposta il tipo di grafico su TableChart e restituisce `EmbeddedTableChartBuilder`.
`build()`	`EmbeddedChart`	Crea il grafico per riflettere tutte le modifiche apportate.
`clearRanges()`	`EmbeddedChartBuilder`	Rimuove tutti gli intervalli dal grafico modificato da questo generatore.
`enablePaging(enablePaging)`	`EmbeddedTableChartBuilder`	Consente di impostare se attivare il paging tra i dati.
`enablePaging(pageSize)`	`EmbeddedTableChartBuilder`	Abilita il paging e imposta il numero di righe in ogni pagina.
`enablePaging(pageSize, startPage)`	`EmbeddedTableChartBuilder`	Abilita il paging, imposta il numero di righe in ogni pagina e la prima pagina della tabella da visualizzare (i numeri di pagina sono in base zero).
`enableRtlTable(rtlEnabled)`	`EmbeddedTableChartBuilder`	Aggiunge il supporto di base per le lingue con orientamento da destra a sinistra (come l'arabo o l'ebraico) invertendo l'ordine delle colonne della tabella, in modo che la colonna zero sia la colonna più a destra e l'ultima colonna sia quella più a sinistra.
`enableSorting(enableSorting)`	`EmbeddedTableChartBuilder`	Consente di scegliere se ordinare le colonne quando l'utente fa clic su un'intestazione di colonna.
`getChartType()`	`ChartType`	Restituisce il tipo di grafico corrente.
`getContainer()`	`ContainerInfo`	Restituisce il grafico `ContainerInfo`, che racchiude il punto in cui viene visualizzato sul foglio.
`getRanges()`	`Range[]`	Restituisce una copia dell'elenco di intervalli che attualmente forniscono dati per questo grafico.
`removeRange(range)`	`EmbeddedChartBuilder`	Rimuove l'intervallo specificato dal grafico modificato da questo generatore.
`setChartType(type)`	`EmbeddedChartBuilder`	Modifica il tipo di grafico.
`setFirstRowNumber(number)`	`EmbeddedTableChartBuilder`	Imposta il numero di riga per la prima riga nella tabella di dati.
`setHiddenDimensionStrategy(strategy)`	`EmbeddedChartBuilder`	Imposta la strategia da utilizzare per righe e colonne nascoste.
`setInitialSortingAscending(column)`	`EmbeddedTableChartBuilder`	Imposta l'indice della colonna in base al quale la tabella dovrebbe essere ordinata inizialmente (ordine crescente).
`setInitialSortingDescending(column)`	`EmbeddedTableChartBuilder`	Imposta l'indice della colonna in base al quale la tabella deve essere ordinata inizialmente (decrescente).
`setMergeStrategy(mergeStrategy)`	`EmbeddedChartBuilder`	Imposta la strategia di unione da utilizzare quando esiste più di un intervallo.
`setNumHeaders(headers)`	`EmbeddedChartBuilder`	Imposta il numero di righe o colonne dell'intervallo che devono essere trattate come intestazioni.
`setOption(option, value)`	`EmbeddedChartBuilder`	Imposta le opzioni avanzate per questo grafico.
`setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)`	`EmbeddedChartBuilder`	Imposta la posizione, modificando il punto in cui viene visualizzato il grafico sul foglio.
`setTransposeRowsAndColumns(transpose)`	`EmbeddedChartBuilder`	Consente di impostare se le righe e le colonne del grafico vengono trasposte.
`showRowNumberColumn(showRowNumber)`	`EmbeddedTableChartBuilder`	Consente di impostare se mostrare il numero di riga come prima colonna della tabella.
`useAlternatingRowStyle(alternate)`	`EmbeddedTableChartBuilder`	Consente di impostare se lo stile di colore alternato viene assegnato alle righe pari e dispari di un grafico tabella.

Documentazione dettagliata

`addRange(range)`

Aggiunge un intervallo al grafico modificato da questo generatore. Non aggiunge l'intervallo se è già stato aggiunto al grafico.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(sheet.getRange("A1:B8"))
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

Parametri

Nome	Tipo	Descrizione
`range`	`Range`	L'intervallo da aggiungere.

Ritorni

EmbeddedChartBuilder - questo generatore, per il concatenamento

`asAreaChart()`

Imposta il tipo di grafico su AreaChart e restituisce EmbeddedAreaChartBuilder.

Ritorni

EmbeddedAreaChartBuilder: uno strumento per la creazione di un grafico ad area

`asBarChart()`

Imposta il tipo di grafico su Grafico a barre e restituisce un EmbeddedBarChartBuilder.

Ritorni

EmbeddedBarChartBuilder: uno strumento per la creazione di un grafico a barre

`asColumnChart()`

Imposta il tipo di grafico su ColumnChart e restituisce un EmbeddedColumnChartBuilder.

Ritorni

EmbeddedColumnChartBuilder: uno strumento per la creazione di un grafico a colonne

`asComboChart()`

Imposta il tipo di grafico su ComboChart e restituisce EmbeddedComboChartBuilder.

Ritorni

EmbeddedComboChartBuilder: uno strumento per la creazione di un grafico combinato

`asHistogramChart()`

Imposta il tipo di grafico su IstogramChart e restituisce un EmbeddedHistogramChartBuilder.

Ritorni

EmbeddedHistogramChartBuilder: uno strumento per la creazione di un grafico a istogrammi

`asLineChart()`

Imposta il tipo di grafico su LineChart e restituisce EmbeddedLineChartBuilder.

Ritorni

EmbeddedLineChartBuilder: uno strumento per la creazione di un grafico a linee

`asPieChart()`

Imposta il tipo di grafico su Grafico a torta e restituisce un EmbeddedPieChartBuilder.

Ritorni

EmbeddedPieChartBuilder: uno strumento per la creazione di un grafico a torta

`asScatterChart()`

Imposta il tipo di grafico su Grafico a dispersione e restituisce un valore EmbeddedScatterChartBuilder.

Ritorni

EmbeddedScatterChartBuilder: uno strumento per la creazione di un grafico a dispersione

`asTableChart()`

Imposta il tipo di grafico su TableChart e restituisce EmbeddedTableChartBuilder.

Ritorni

EmbeddedTableChartBuilder: uno strumento per la creazione di un grafico a tabella

`build()`

Crea il grafico per riflettere tutte le modifiche apportate.

Questo metodo non consente di disegnare automaticamente il grafico nella parte superiore del foglio di lavoro. È necessario inserire un nuovo grafico tramite sheet.insertChart(chart) e aggiornarne uno esistente tramite sheet.updateChart(chart).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B5");
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

Ritorni

EmbeddedChart: il grafico creato, che deve essere comunque aggiunto al foglio di lavoro.

`clearRanges()`

Rimuove tutti gli intervalli dal grafico modificato da questo generatore.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This code updates the chart to use only the new ranges while preserving the existing
// formatting of the chart.
var chart = sheet.getCharts()[0];
var newChart = chart
    .modify()
    .clearRanges()
    .addRange(sheet.getRange("A1:A5"))
    .addRange(sheet.getRange("B1:B5"))
    .build();
sheet.updateChart(newChart);

Ritorni

EmbeddedChartBuilder - questo generatore, per il concatenamento

`enablePaging(enablePaging)`

Consente di impostare se attivare il paging tra i dati.

Il comportamento predefinito è il paging disabilitato. Se il paging è attivato, la dimensione predefinita della pagina è 10.

Parametri

Nome	Tipo	Descrizione
`enablePaging`	`Boolean`	`true` se deve essere attivato il paging, `false` in caso contrario.

Ritorni

EmbeddedTableChartBuilder: questo builder, utile per il concatenamento.

`enablePaging(pageSize)`

Abilita il paging e imposta il numero di righe in ogni pagina.

La dimensione predefinita della pagina è 10.

// Creates a table chart builder and enables paging with page size of 5.
var builder = Charts.newTableChart();
builder.enablePaging(5);

Parametri

Nome	Tipo	Descrizione
`pageSize`	`Integer`	Il numero di righe in ogni pagina della tabella.

Ritorni

EmbeddedTableChartBuilder: questo builder, utile per il concatenamento.

`enablePaging(pageSize, startPage)`

Abilita il paging, imposta il numero di righe in ogni pagina e la prima pagina della tabella da visualizzare (i numeri di pagina sono in base zero).

La dimensione predefinita della pagina è 10, mentre la pagina iniziale è 0.

// Creates a table chart builder and enables paging with page size of 5 and displays page 2
// first.
var builder = Charts.newTableChart();
builder.enablePaging(5, 2);

Parametri

Nome	Tipo	Descrizione
`pageSize`	`Integer`	Il numero di righe in ogni pagina della tabella.
`startPage`	`Integer`	La prima pagina della tabella da visualizzare (i numeri di pagina sono in base zero).

Ritorni

EmbeddedTableChartBuilder: questo builder, utile per il concatenamento.

`enableRtlTable(rtlEnabled)`

Aggiunge il supporto di base per le lingue con orientamento da destra a sinistra (come l'arabo o l'ebraico) invertendo l'ordine delle colonne della tabella, in modo che la colonna zero sia la colonna più a destra e l'ultima colonna sia quella più a sinistra.

Ciò non influisce sull'indice della colonna nei dati sottostanti, ma solo sull'ordine di visualizzazione. La visualizzazione della lingua Bidirezionale completa (BiDi) non è supportata dalla visualizzazione tabulare anche con questa opzione. Questa opzione viene ignorata se attivi il paging (utilizzando l'opzione Pagina) o se la tabella presenta barre di scorrimento perché hai specificato opzioni di altezza e larghezza inferiori alle dimensioni richieste per la tabella. Il comportamento predefinito è il supporto RTL disattivato.

Parametri

Nome	Tipo	Descrizione
`rtlEnabled`	`Boolean`	`true` se è necessario attivare il supporto da destra a sinistra, `false` in caso contrario.

Ritorni

EmbeddedTableChartBuilder: questo builder, utile per il concatenamento.

`enableSorting(enableSorting)`

Consente di scegliere se ordinare le colonne quando l'utente fa clic su un'intestazione di colonna.

Se l'ordinamento è attivato, quando gli utenti fanno clic sull'intestazione di colonna, le righe vengono ordinate automaticamente. Il comportamento predefinito è l'ordinamento abilitato.

Parametri

Nome	Tipo	Descrizione
`enableSorting`	`Boolean`	`true` per attivare l'ordinamento facendo clic sulle intestazioni di colonna, altrimenti `false`.

Ritorni

EmbeddedTableChartBuilder: questo builder, utile per il concatenamento.

`getChartType()`

Restituisce il tipo di grafico corrente.

Ritorni

ChartType: il tipo di grafico

`getContainer()`

Restituisce il grafico ContainerInfo, che racchiude il punto in cui viene visualizzato sul foglio.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var chartBuilder = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(sheet.getRange("A1:B8"))
    .setPosition(5, 5, 0, 0);

// This method returns the exact same data as Chart#getContainerInfo()
var containerInfo = chartBuilder.getContainer();

// Logs the values we used in setPosition()
Logger.log("Anchor Column: %s\r\nAnchor Row %s\r\nOffset X %s\r\nOffset Y %s",
          containerInfo.getAnchorColumn(),
          containerInfo.getAnchorRow(),
          containerInfo.getOffsetX(),
          containerInfo.getOffsetY());

Ritorni

ContainerInfo: un oggetto contenente la posizione del contenitore del grafico

`getRanges()`

Restituisce una copia dell'elenco di intervalli che attualmente forniscono dati per questo grafico. Utilizza addRange(range) e removeRange(range) per modificare questo elenco.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var chartBuilder = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(sheet.getRange("A1:B8"))
    .setPosition(5, 5, 0, 0);

var ranges = chartBuilder.getRanges();

// There's only one range as a data source for this chart,
// so this logs "A1:B8"
for (var i in ranges) {
  var range = ranges[i];
  Logger.log(range.getA1Notation());
}

Ritorni

Range[]: un array di intervalli che fungono da grafico da creare come origine dati

`removeRange(range)`

Rimuove l'intervallo specificato dal grafico modificato da questo generatore. Non genera un errore se l'intervallo non è in questo grafico.

L'intervallo rimosso deve corrispondere a un intervallo aggiunto tramite addRange(range); in caso contrario non viene apportata alcuna modifica al grafico. Questo metodo non può essere utilizzato per rimuovere parzialmente i valori da un intervallo.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var firstRange = sheet.getRange("A1:B5");
var secondRange = sheet.getRange("A6:B8");

var chartBuilder = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(firstRange)
    // This range will render in a different color
    .addRange(secondRange)
    .setPosition(5, 5, 0, 0);

// Note that you can use either of these two formats, but the range
// MUST match up with a range that was added via addRange(), or it
// will not be removed, and will not throw an exception
chartBuilder.removeRange(firstRange);
chartBuilder.removeRange(sheet.getRange("A6:B8"));

var chart = chartBuilder.build();

sheet.insertChart(chart);

Parametri

Nome	Tipo	Descrizione
`range`	`Range`	L'intervallo da rimuovere.

Ritorni

EmbeddedChartBuilder - questo generatore, per il concatenamento

`setChartType(type)`

Modifica il tipo di grafico. Al momento non sono supportati tutti i tipi di grafici incorporati. Leggi i ChartType.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B5");
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

Parametri

Nome	Tipo	Descrizione
`type`	`ChartType`	Il tipo in cui modificare questo grafico.

Ritorni

EmbeddedChartBuilder - questo generatore, per il concatenamento

`setFirstRowNumber(number)`

Imposta il numero di riga per la prima riga nella tabella di dati.

Il numero predefinito della prima riga è 1.

// Creates a table chart builder and sets the first row to be 2.
var builder = Charts.newTableChart();
builder.setFirstRowNumber(2);

Parametri

Nome	Tipo	Descrizione
`number`	`Integer`	Il numero di riga per la prima riga nella tabella di dati.

Ritorni

EmbeddedTableChartBuilder: questo builder, utile per il concatenamento.

`setHiddenDimensionStrategy(strategy)`

Imposta la strategia da utilizzare per righe e colonne nascoste. Il valore predefinito è IGNORE_ROWS.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B5");
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .setHiddenDimensionStrategy(Charts.ChartHiddenDimensionStrategy.IGNORE_COLUMNS)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

Parametri

Nome	Tipo	Descrizione
`strategy`	`ChartHiddenDimensionStrategy`	La strategia da utilizzare per righe e colonne nascoste.

Ritorni

EmbeddedChartBuilder - questo generatore, per il concatenamento

`setInitialSortingAscending(column)`

Imposta l'indice della colonna in base al quale la tabella dovrebbe essere ordinata inizialmente (ordine crescente).

Il sistema operativo della colonna è ordinato in ordine crescente ed è contrassegnato da una piccola freccia che lo indica.

// Creates a table chart builder and sorts it by the second column (ascending).
var builder = Charts.newTableChart();
builder.setInitialSortingAscending(2);

Parametri

Nome	Tipo	Descrizione
`column`	`Integer`	Il numero della colonna in base alla quale deve essere ordinata inizialmente la tabella.

Ritorni

EmbeddedTableChartBuilder: questo builder, utile per il concatenamento.

`setInitialSortingDescending(column)`

Imposta l'indice della colonna in base al quale la tabella deve essere ordinata inizialmente (decrescente).

Il sistema operativo della colonna è ordinato in ordine decrescente ed è contrassegnato da una piccola freccia che lo indica.

// Creates a table chart builder and sorts it by the second column (descending).
var builder = Charts.newTableChart();
builder.setInitialSortingDescending(2);

Parametri

Nome	Tipo	Descrizione
`column`	`Integer`	Il numero della colonna in base alla quale deve essere ordinata inizialmente la tabella.

Ritorni

EmbeddedTableChartBuilder: questo builder, utile per il concatenamento.

`setMergeStrategy(mergeStrategy)`

Imposta la strategia di unione da utilizzare quando esiste più di un intervallo. Con MERGE_ROWS le righe vengono unite; con MERGE_COLUMNS le colonne vengono unite. Il valore predefinito è MERGE_COLUMNS.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B10");
var range2 = sheet.getRange("C:C10");
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .addRange(range2)
    .setMergeStrategy(Charts.ChartMergeStrategy.MERGE_ROWS)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

Parametri

Nome	Tipo	Descrizione
`mergeStrategy`	`ChartMergeStrategy`	La strategia di unione da utilizzare.

Ritorni

EmbeddedChartBuilder - questo generatore, per il concatenamento

`setNumHeaders(headers)`

Imposta il numero di righe o colonne dell'intervallo che devono essere trattate come intestazioni.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B5");
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .setNumHeaders(1)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

Parametri

Nome	Tipo	Descrizione
`headers`	`Integer`	Il numero di righe o colonne da considerare come intestazioni. I valori negativi determinano il rilevamento automatico delle intestazioni.

Ritorni

EmbeddedChartBuilder - questo generatore, per il concatenamento

`setOption(option, value)`

Imposta le opzioni avanzate per questo grafico. Per visualizzare un elenco delle opzioni disponibili, vedi Opzioni di configurazione dei grafici.

Questo metodo non convalida che l'opzione specificata sia valida per questo tipo di grafico né se il valore abbia il formato/la struttura corretta.

Questo esempio mostra come modificare il titolo e impostare una legenda.

builder.setOption('title', 'Earnings projections');
builder.setOption('legend', {position: 'top', textStyle: {color: 'blue', fontSize: 16}});

Parametri

Nome	Tipo	Descrizione
`option`	`String`	Il nome dell'opzione.
`value`	`Object`	Il valore dell'opzione.

Ritorni

EmbeddedChartBuilder - Questo builder, per il concatenamento.

`setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)`

Imposta la posizione, modificando il punto in cui viene visualizzato il grafico sul foglio. anchorRowPos e anchorColPos hanno un indice indicizzato di 1.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B5");
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

Parametri

Nome	Tipo	Descrizione
`anchorRowPos`	`Integer`	Il lato superiore del grafico è ancorato a questa riga.
`anchorColPos`	`Integer`	Il lato sinistro del grafico è ancorato a questa colonna.
`offsetX`	`Integer`	L'angolo in alto a destra del grafico è offset da questo numero di pixel.
`offsetY`	`Integer`	L'angolo inferiore sinistro del grafico è offset da questo numero di pixel.

Ritorni

EmbeddedChartBuilder - questo generatore, per il concatenamento

`setTransposeRowsAndColumns(transpose)`

Consente di impostare se le righe e le colonne del grafico vengono trasposte. Se impostato su true, le righe e le colonne vengono scambiate. Il valore predefinito è false.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B5");
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(range)
    .setTransposeRowsAndColumns(true)
    .setPosition(5, 5, 0, 0)
    .build();

sheet.insertChart(chart);

Parametri

Nome	Tipo	Descrizione
`transpose`	`Boolean`	Se `true`, le righe e le colonne utilizzate per costruire il grafico vengono trasposte.

Ritorni

EmbeddedChartBuilder - questo generatore, per il concatenamento

`showRowNumberColumn(showRowNumber)`

Consente di impostare se mostrare il numero di riga come prima colonna della tabella.

Il comportamento predefinito non mostra i numeri di riga.

Parametri

Nome	Tipo	Descrizione
`showRowNumber`	`Boolean`	`true` se la prima colonna della tabella deve mostrare il numero di riga, `false` in caso contrario.

Ritorni

EmbeddedTableChartBuilder: questo builder, utile per il concatenamento.

`useAlternatingRowStyle(alternate)`

Consente di impostare se lo stile di colore alternato viene assegnato alle righe pari e dispari di un grafico tabella.

Il comportamento predefinito è che le righe hanno uno stile di colore alternato.

Parametri

Nome	Tipo	Descrizione
`alternate`	`Boolean`	`true` se gli stili di colore devono alternare, `false` in caso contrario.

Ritorni

EmbeddedTableChartBuilder: questo builder, utile per il concatenamento.