Questa pagina è stata tradotta dall'API Cloud Translation.

Class PieChartBuilder

Uno strumento di creazione per grafici a torta. Per ulteriori dettagli, consulta la documentazione di Google Graph.

Ecco un esempio che mostra come creare un grafico a torta. I dati vengono importati da un foglio di lavoro Google.

  // Get sample data from a spreadsheet.
  var dataSourceUrl = 'https://docs.google.com/spreadsheet/tq?range=A1%3AB8' +
      '&key=0Aq4s9w_HxMs7dHpfX05JdmVSb1FpT21sbXd4NVE3UEE&gid=3&headers=-1';

  var chartBuilder = Charts.newPieChart()
      .setTitle('World Population by Continent')
      .setDimensions(600, 500)
      .set3D()
      .setDataSourceUrl(dataSourceUrl);

  var chart = chartBuilder.build();

Metodi

Metodo	Tipo restituito	Breve descrizione
`build()`	`Chart`	Crea il grafico.
`reverseCategories()`	`PieChartBuilder`	Inverte il disegno di una serie nell'asse del dominio.
`set3D()`	`PieChartBuilder`	Imposta il grafico in modo che sia tridimensionale.
`setBackgroundColor(cssValue)`	`PieChartBuilder`	Imposta il colore di sfondo per il grafico.
`setColors(cssValues)`	`PieChartBuilder`	Imposta i colori delle linee nel grafico.
`setDataSourceUrl(url)`	`PieChartBuilder`	Imposta l'URL dell'origine dati utilizzato per estrarre i dati da una sorgente esterna, come Google Google.
`setDataTable(tableBuilder)`	`PieChartBuilder`	Imposta la tabella di dati da utilizzare per il grafico con un oggetto DataTableBuilder.
`setDataTable(table)`	`PieChartBuilder`	Imposta la tabella di dati che contiene le linee del grafico e le etichette dell'asse X.
`setDataViewDefinition(dataViewDefinition)`	`PieChartBuilder`	Consente di impostare la definizione della vista dati da utilizzare per il grafico.
`setDimensions(width, height)`	`PieChartBuilder`	Imposta le dimensioni del grafico.
`setLegendPosition(position)`	`PieChartBuilder`	Imposta la posizione della legenda rispetto al grafico.
`setLegendTextStyle(textStyle)`	`PieChartBuilder`	Imposta lo stile del testo della legenda del grafico.
`setOption(option, value)`	`PieChartBuilder`	Imposta le opzioni avanzate per questo grafico.
`setTitle(chartTitle)`	`PieChartBuilder`	Imposta il titolo del grafico.
`setTitleTextStyle(textStyle)`	`PieChartBuilder`	Imposta lo stile del testo del titolo del grafico.

Documentazione dettagliata

`build()`

Crea il grafico.

Invio

Chart: un oggetto Chart, che può essere incorporato in documenti, elementi UI o utilizzato come elemento statico dell'immagine.

`reverseCategories()`

Inverte il disegno di una serie nell'asse del dominio. Per i grafici a intervallo verticale (come i grafici a linee, grafici ad area o a colonne), significa che l'asse orizzontale è tracciato da destra a sinistra. Per i grafici con intervallo orizzontale (come quelli a barre), ciò significa che l'asse verticale è tracciato dall'alto verso in basso. Per i grafici a torta, le sezioni vengono tracciate in senso antiorario.

// Creates a pie chart builder and sets drawing of the slices in a counter-clockwise manner.
var builder = Charts.newPieChart();
builder.reverseCategories();

Invio

PieChartBuilder: questo builder, utile per il concatenamento.

`set3D()`

Imposta il grafico in modo che sia tridimensionale.

Invio

PieChartBuilder: questo builder, utile per il concatenamento.

`setBackgroundColor(cssValue)`

Imposta il colore di sfondo per il grafico.

// Creates a line chart builder and sets the background color to gray
var builder = Charts.newLineChart();
builder.setBackgroundColor("gray");

Parametri

Nome	Tipo	Descrizione
`cssValue`	`String`	Il valore CSS del colore (ad esempio `"blue"` o `"#00f"`).

Invio

PieChartBuilder: questo builder, utile per il concatenamento.

`setColors(cssValues)`

Imposta i colori delle linee nel grafico.

// Creates a line chart builder and sets the first two lines to be drawn in green and red,
// respectively.
var builder = Charts.newLineChart();
builder.setColors(["green", "red"]);

Parametri

Nome	Tipo	Descrizione
`cssValues`	`String[]`	Un array di valori CSS per il colore, come `["red", "#acf"]`. L'ennesimo elemento nell'array rappresenta il colore dell'ennesima linea nel grafico.

Invio

PieChartBuilder: questo builder, utile per il concatenamento.

`setDataSourceUrl(url)`

Imposta l'URL dell'origine dati utilizzato per estrarre i dati da una sorgente esterna, come Google Google. Se vengono forniti un URL dell'origine dati e una tabella di dati, l'URL dell'origine dati viene ignorato.

Per ulteriori informazioni sull'esecuzione di query sulle origini dati, consulta la documentazione di Google Graph.

Parametri

Nome	Tipo	Descrizione
`url`	`String`	L'URL dell'origine dati, inclusi gli eventuali parametri di query.

Invio

PieChartBuilder: questo builder, utile per il concatenamento.

`setDataTable(tableBuilder)`

Imposta la tabella di dati da utilizzare per il grafico con un oggetto DataTableBuilder. Questo è un metodo pratico per impostare la tabella di dati senza dover chiamare build().

Parametri

Nome	Tipo	Descrizione
`tableBuilder`	`DataTableBuilder`	Un generatore di tabelle di dati. Viene creata immediatamente una nuova tabella di dati nell'ambito di questo pertanto eventuali ulteriori aggiornamenti al builder non verranno riportati nel grafico.

Invio

PieChartBuilder: questo builder, utile per il concatenamento.

`setDataTable(table)`

Imposta la tabella di dati che contiene le linee del grafico e le etichette dell'asse X. La la prima colonna deve essere una stringa e contenere le etichette dell'asse orizzontale. Qualsiasi numero di colonne possono seguire, tutti devono essere numerici. Ogni colonna viene visualizzata come una riga separata.

Parametri

Nome	Tipo	Descrizione
`table`	`DataTableSource`	La tabella di dati da utilizzare per il grafico.

Invio

PieChartBuilder: questo builder, utile per il concatenamento.

`setDataViewDefinition(dataViewDefinition)`

Consente di impostare la definizione della vista dati da utilizzare per il grafico.

Parametri

Nome	Tipo	Descrizione
`dataViewDefinition`	`DataViewDefinition`	Un oggetto di definizione della vista dati che definisce la vista da utilizzare derivata dall'origine dati specificata per il disegno del grafico.

Invio

PieChartBuilder: questo builder, utile per il concatenamento.

`setDimensions(width, height)`

Imposta le dimensioni del grafico.

Parametri

Nome	Tipo	Descrizione
`width`	`Integer`	La larghezza del grafico, in pixel.
`height`	`Integer`	L'altezza del grafico, in pixel.

Invio

PieChartBuilder: questo builder, utile per il concatenamento.

`setLegendPosition(position)`

Imposta la posizione della legenda rispetto al grafico. Per impostazione predefinita, non esiste una legenda.

// Creates a line chart builder and sets the legend position to right.
var builder = Charts.newLineChart();
builder.setLegendPosition(Charts.Position.RIGHT);

Parametri

Nome	Tipo	Descrizione
`position`	`Position`	La posizione della legenda.

Invio

PieChartBuilder: questo builder, utile per il concatenamento.

`setLegendTextStyle(textStyle)`

Imposta lo stile del testo della legenda del grafico.

// Creates a line chart builder and sets it up for a  blue, 26-point legend.
var textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
var style = textStyleBuilder.build();
var builder = Charts.newLineChart();
builder.setLegendTextStyle(style);

Parametri

Nome	Tipo	Descrizione
`textStyle`	`TextStyle`	Lo stile di testo da utilizzare per la legenda del grafico.

Invio

PieChartBuilder: questo builder, utile per il concatenamento.

`setOption(option, value)`

Imposta le opzioni avanzate per questo grafico. Scopri le opzioni disponibili per questo grafico. Questo metodo non ha effetto se l'opzione specificata non è valida.

// Build a pie chart with a pretty legend.
var builder = Charts.newPieChart();
builder.setOption('legend', {textStyle: {color: 'blue', fontSize: 16}});
var chart = builder.build();

Parametri

Nome	Tipo	Descrizione
`option`	`String`	L'opzione da impostare.
`value`	`Object`	Il valore da impostare.

Invio

PieChartBuilder: questo builder, utile per il concatenamento.

`setTitle(chartTitle)`

Imposta il titolo del grafico. Il titolo viene visualizzato al centro del grafico.

// Creates a line chart builder and title to 'My Line Chart'.
var builder = Charts.newLineChart();
builder.setTitle('My Line Chart')

Parametri

Nome	Tipo	Descrizione
`chartTitle`	`String`	il titolo del grafico.

Invio

PieChartBuilder: questo builder, utile per il concatenamento.

`setTitleTextStyle(textStyle)`

Imposta lo stile del testo del titolo del grafico.

// Creates a line chart builder and sets it up for a  blue, 26-point title.
var textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
var style = textStyleBuilder.build();
var builder = Charts.newLineChart();
builder.setTitleTextStyle(style);

Parametri

Nome	Tipo	Descrizione
`textStyle`	`TextStyle`	Lo stile di testo da utilizzare per il titolo del grafico. Puoi creare un oggetto `TextStyleBuilder` chiamando `Charts.newTextStyle()`.

Invio

PieChartBuilder: questo builder, utile per il concatenamento.