Questa pagina è stata tradotta dall'API Cloud Translation.

Class ScatterChartBuilder

Strumento per la creazione di grafici a dispersione. Per ulteriori informazioni, consulta la documentazione di Google Chart.

Ecco un esempio che mostra come creare un grafico a dispersione. 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=C1%3AD' +
    '&key=0Aq4s9w_HxMs7dHpfX05JdmVSb1FpT21sbXd4NVE3UEE&gid=4&headers=-1';

var chartBuilder = Charts.newScatterChart()
    .setTitle('Adjusted GDP & U.S. Population')
    .setXAxisTitle('U.S. Population (millions)')
    .setYAxisTitle('Adjusted GDP ($ billions)')
    .setDimensions(600, 500)
    .setLegendPosition(Charts.Position.NONE)
    .setDataSourceUrl(dataSourceUrl);

var chart = chartBuilder.build();

Metodi

Metodo	Tipo restituito	Breve descrizione
`build()`	`Chart`	Crea il grafico.
`setBackgroundColor(cssValue)`	`ScatterChartBuilder`	Imposta il colore di sfondo del grafico.
`setColors(cssValues)`	`ScatterChartBuilder`	Imposta i colori delle linee nel grafico.
`setDataSourceUrl(url)`	`ScatterChartBuilder`	Imposta l'URL dell'origine dati utilizzato per estrarre i dati da un'origine esterna, ad esempio Fogli Google.
`setDataTable(tableBuilder)`	`ScatterChartBuilder`	Imposta la tabella di dati da utilizzare per il grafico utilizzando un DataTableBuilder.
`setDataTable(table)`	`ScatterChartBuilder`	Imposta la tabella di dati che contiene le linee per il grafico e le etichette dell'asse X.
`setDataViewDefinition(dataViewDefinition)`	`ScatterChartBuilder`	Imposta la definizione della vista dati da utilizzare per il grafico.
`setDimensions(width, height)`	`ScatterChartBuilder`	Imposta le dimensioni del grafico.
`setLegendPosition(position)`	`ScatterChartBuilder`	Imposta la posizione della legenda rispetto al grafico.
`setLegendTextStyle(textStyle)`	`ScatterChartBuilder`	Imposta lo stile di testo della legenda del grafico.
`setOption(option, value)`	`ScatterChartBuilder`	Imposta le opzioni avanzate per questo grafico.
`setPointStyle(style)`	`ScatterChartBuilder`	Imposta lo stile per i punti nella linea.
`setTitle(chartTitle)`	`ScatterChartBuilder`	Imposta il titolo del grafico.
`setTitleTextStyle(textStyle)`	`ScatterChartBuilder`	Imposta lo stile di testo del titolo del grafico.
`setXAxisLogScale()`	`ScatterChartBuilder`	Imposta l'asse orizzontale in una scala logaritmica (richiede che tutti i valori siano positivi).
`setXAxisRange(start, end)`	`ScatterChartBuilder`	Imposta l'intervallo per l'asse orizzontale del grafico.
`setXAxisTextStyle(textStyle)`	`ScatterChartBuilder`	Imposta lo stile di testo dell'asse orizzontale.
`setXAxisTitle(title)`	`ScatterChartBuilder`	Aggiunge un titolo all'asse orizzontale.
`setXAxisTitleTextStyle(textStyle)`	`ScatterChartBuilder`	Imposta lo stile del testo del titolo dell'asse orizzontale.
`setYAxisLogScale()`	`ScatterChartBuilder`	Imposta l'asse verticale in una scala logaritmica (richiede che tutti i valori siano positivi).
`setYAxisRange(start, end)`	`ScatterChartBuilder`	Imposta l'intervallo per l'asse verticale del grafico.
`setYAxisTextStyle(textStyle)`	`ScatterChartBuilder`	Imposta lo stile del testo dell'asse verticale.
`setYAxisTitle(title)`	`ScatterChartBuilder`	Aggiunge un titolo all'asse verticale.
`setYAxisTitleTextStyle(textStyle)`	`ScatterChartBuilder`	Imposta lo stile del testo del titolo dell'asse verticale.

Documentazione dettagliata

`build()`

Crea il grafico.

Ritorni

Chart: oggetto Chart che può essere incorporato in documenti ed elementi dell'interfaccia utente o utilizzato come immagine statica.

`setBackgroundColor(cssValue)`

Imposta il colore di sfondo del 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"`).

Ritorni

ScatterChartBuilder: 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 di colore, ad esempio `["red", "#acf"]`. L'ennesimo elemento nell'array rappresenta il colore dell'n-esima linea nel grafico.

Ritorni

ScatterChartBuilder: questo builder, utile per il concatenamento.

`setDataSourceUrl(url)`

Imposta l'URL dell'origine dati utilizzato per estrarre i dati da un'origine esterna, ad esempio Fogli Google. Se vengono forniti un URL di origine dati e una DataTable, l'URL dell'origine dati viene ignorato.

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

Parametri

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

Ritorni

ScatterChartBuilder: questo builder, utile per il concatenamento.

`setDataTable(tableBuilder)`

Imposta la tabella di dati da utilizzare per il grafico utilizzando un 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. Nell'ambito di questa chiamata viene creata immediatamente una nuova tabella di dati, pertanto eventuali ulteriori aggiornamenti al builder non saranno visualizzati nel grafico.

Ritorni

ScatterChartBuilder: questo builder, utile per il concatenamento.

`setDataTable(table)`

Imposta la tabella di dati che contiene le linee per il grafico e le etichette dell'asse X. La prima colonna deve essere una stringa e contenere le etichette dell'asse orizzontale. Può seguire un numero qualsiasi di colonne, tutte devono essere numeriche. Ogni colonna viene visualizzata come una riga separata.

Parametri

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

Ritorni

ScatterChartBuilder: questo builder, utile per il concatenamento.

`setDataViewDefinition(dataViewDefinition)`

Imposta la definizione della vista dati da utilizzare per il grafico.

Parametri

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

Ritorni

ScatterChartBuilder: 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.

Ritorni

ScatterChartBuilder: questo builder, utile per il concatenamento.

`setLegendPosition(position)`

Imposta la posizione della legenda rispetto al grafico. Per impostazione predefinita, non è presente 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.

Ritorni

ScatterChartBuilder: questo builder, utile per il concatenamento.

`setLegendTextStyle(textStyle)`

Imposta lo stile di 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.

Ritorni

ScatterChartBuilder: questo builder, utile per il concatenamento.

`setOption(option, value)`

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

// Build a scatter chart with a 1-second animation duration.
var builder = Charts.newScatterChart();
builder.setOption('animation.duration', 1000);
var chart = builder.build();

Parametri

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

Ritorni

ScatterChartBuilder: questo builder, utile per il concatenamento.

`setPointStyle(style)`

Imposta lo stile per i punti nella linea. Per impostazione predefinita, i punti non hanno stili particolari e solo la linea è visibile.

// Creates a line chart builder and sets large point style.
var builder = Charts.newLineChart();
builder.setPointStyle(Charts.PointStyle.LARGE);

Parametri

Nome	Tipo	Descrizione
`style`	`PointStyle`	Lo stile da utilizzare per i punti nella linea.

Ritorni

ScatterChartBuilder: questo builder, utile per il concatenamento.

Vedi anche

PointStyle

`setTitle(chartTitle)`

Imposta il titolo del grafico. Il titolo viene visualizzato centrato sopra il 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`	titolo del grafico.

Ritorni

ScatterChartBuilder: questo builder, utile per il concatenamento.

`setTitleTextStyle(textStyle)`

Imposta lo stile di 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()`.

Ritorni

ScatterChartBuilder: questo builder, utile per il concatenamento.

`setXAxisLogScale()`

Imposta l'asse orizzontale in una scala logaritmica (richiede che tutti i valori siano positivi).

Ritorni

ScatterChartBuilder: questo builder, utile per il concatenamento.

`setXAxisRange(start, end)`

Imposta l'intervallo per l'asse orizzontale del grafico.

Se alcuni punti dati non rientrano nell'intervallo, l'intervallo viene espanso per includere questi punti dati.

// Creates a scatter chart builder and sets the X-axis range to be 0 to 100.
var builder = Charts.newTableChart();
builder.setXAxisRange(0, 100);

Parametri

Nome	Tipo	Descrizione
`start`	`Number`	Il valore della linea della griglia più bassa dell'asse orizzontale.
`end`	`Number`	Il valore della linea della griglia più alta dell'asse orizzontale.

Ritorni

ScatterChartBuilder: questo builder, utile per il concatenamento.

`setXAxisTextStyle(textStyle)`

Imposta lo stile di testo dell'asse orizzontale.

// Creates a line chart builder and sets the X-axis text style to blue, 18-point font.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setXAxisTextStyle(textStyle);

Parametri

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

Ritorni

ScatterChartBuilder: questo builder, utile per il concatenamento.

`setXAxisTitle(title)`

Aggiunge un titolo all'asse orizzontale. Il titolo è centrato e viene visualizzato sotto le etichette dei valori dell'asse.

// Creates a line chart builder and sets the X-axis title.
var builder = Charts.newLineChart();
builder.setTitle('X-axis Title')

Parametri

Nome	Tipo	Descrizione
`title`	`String`	Il titolo dell'asse X.

Ritorni

ScatterChartBuilder: questo builder, utile per il concatenamento.

`setXAxisTitleTextStyle(textStyle)`

Imposta lo stile del testo del titolo dell'asse orizzontale.

// Creates a line chart builder and sets the X-axis title text style to blue, 18-point font.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setXAxisTitleTextStyle(textStyle);

Parametri

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

Ritorni

ScatterChartBuilder: questo builder, utile per il concatenamento.

`setYAxisLogScale()`

Imposta l'asse verticale in una scala logaritmica (richiede che tutti i valori siano positivi).

Ritorni

ScatterChartBuilder: questo builder, utile per il concatenamento.

`setYAxisRange(start, end)`

Imposta l'intervallo per l'asse verticale del grafico. Se alcuni punti dati non rientrano nell'intervallo, l'intervallo viene espanso per includere questi punti dati.

// Creates a scatter chart builder and sets the Y-axis range to be 0 to 100.
var builder = Charts.newTableChart();
builder.setYAxisRange(0, 100);

Parametri

Nome	Tipo	Descrizione
`start`	`Number`	Il valore della linea della griglia più bassa dell'asse verticale.
`end`	`Number`	Il valore della linea della griglia più alta dell'asse verticale.

Ritorni

ScatterChartBuilder: questo builder, utile per il concatenamento.

`setYAxisTextStyle(textStyle)`

Imposta lo stile del testo dell'asse verticale.

// Creates a line chart builder and sets the Y-axis text style to blue, 18-point font.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setYAxisTextStyle(textStyle);

Parametri

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

Ritorni

ScatterChartBuilder: questo builder, utile per il concatenamento.

`setYAxisTitle(title)`

Aggiunge un titolo all'asse verticale. Il titolo è centrato e viene visualizzato a sinistra delle etichette dei valori.

// Creates a line chart builder and sets the Y-axis title.
var builder = Charts.newLineChart();
builder.setYAxisTitle('Y-axis Title')

Parametri

Nome	Tipo	Descrizione
`title`	`String`	Il titolo dell'asse Y.

Ritorni

ScatterChartBuilder: questo builder, utile per il concatenamento.

`setYAxisTitleTextStyle(textStyle)`

Imposta lo stile del testo del titolo dell'asse verticale.

// Creates a line chart builder and sets the Y-axis title text style to blue, 18-point font.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setYAxisTitleTextStyle(textStyle);

Parametri

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

Ritorni

ScatterChartBuilder: questo builder, utile per il concatenamento.