Esta página foi traduzida pela API Cloud Translation.

Class EmbeddedPieChartBuilder

Builder para gráficos de pizza. Para mais detalhes, consulte a documentação da Gviz.

Métodos

Método	Tipo de retorno	Breve descrição
`addRange(range)`	`EmbeddedChartBuilder`	Adiciona um intervalo ao gráfico que este builder modifica.
`asAreaChart()`	`EmbeddedAreaChartBuilder`	Define o tipo de gráfico como AreaChart e retorna um `EmbeddedAreaChartBuilder`.
`asBarChart()`	`EmbeddedBarChartBuilder`	Define o tipo de gráfico como BarChart e retorna um `EmbeddedBarChartBuilder`.
`asColumnChart()`	`EmbeddedColumnChartBuilder`	Define o tipo de gráfico como "ColumnChart" e retorna um `EmbeddedColumnChartBuilder`.
`asComboChart()`	`EmbeddedComboChartBuilder`	Define o tipo de gráfico como "ComboChart" e retorna um `EmbeddedComboChartBuilder`.
`asHistogramChart()`	`EmbeddedHistogramChartBuilder`	Define o tipo de gráfico como HistogramChart e retorna um `EmbeddedHistogramChartBuilder`.
`asLineChart()`	`EmbeddedLineChartBuilder`	Define o tipo de gráfico como LineChart e retorna um `EmbeddedLineChartBuilder`.
`asPieChart()`	`EmbeddedPieChartBuilder`	Define o tipo de gráfico como PieChart e retorna um `EmbeddedPieChartBuilder`.
`asScatterChart()`	`EmbeddedScatterChartBuilder`	Define o tipo de gráfico como "ScatterChart" e retorna um `EmbeddedScatterChartBuilder`.
`asTableChart()`	`EmbeddedTableChartBuilder`	Define o tipo de gráfico como TableChart e retorna um `EmbeddedTableChartBuilder`.
`build()`	`EmbeddedChart`	Cria o gráfico para refletir todas as mudanças feitas nele.
`clearRanges()`	`EmbeddedChartBuilder`	Remove todos os intervalos do gráfico que este builder modifica.
`getChartType()`	`ChartType`	Retorna o tipo de gráfico atual.
`getContainer()`	`ContainerInfo`	Retorna o gráfico `ContainerInfo`, que encapsula onde ele aparece na planilha.
`getRanges()`	`Range[]`	Retorna uma cópia da lista de intervalos que fornecem dados para este gráfico.
`removeRange(range)`	`EmbeddedChartBuilder`	Remove o intervalo especificado do gráfico que este builder modifica.
`reverseCategories()`	`EmbeddedPieChartBuilder`	Inverte a ordem das séries no eixo de domínio.
`set3D()`	`EmbeddedPieChartBuilder`	Define o gráfico como tridimensional.
`setBackgroundColor(cssValue)`	`EmbeddedPieChartBuilder`	Define a cor do plano de fundo do gráfico.
`setChartType(type)`	`EmbeddedChartBuilder`	Muda o tipo de gráfico.
`setColors(cssValues)`	`EmbeddedPieChartBuilder`	Define as cores das linhas no gráfico.
`setHiddenDimensionStrategy(strategy)`	`EmbeddedChartBuilder`	Define a estratégia a ser usada para linhas e colunas ocultas.
`setLegendPosition(position)`	`EmbeddedPieChartBuilder`	Define a posição da legenda em relação ao gráfico.
`setLegendTextStyle(textStyle)`	`EmbeddedPieChartBuilder`	Define o estilo do texto da legenda do gráfico.
`setMergeStrategy(mergeStrategy)`	`EmbeddedChartBuilder`	Define a estratégia de mesclagem a ser usada quando houver mais de um intervalo.
`setNumHeaders(headers)`	`EmbeddedChartBuilder`	Define o número de linhas ou colunas do intervalo que devem ser tratados como cabeçalhos.
`setOption(option, value)`	`EmbeddedChartBuilder`	Define opções avançadas para este gráfico.
`setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)`	`EmbeddedChartBuilder`	Define a posição, mudando onde o gráfico aparece na planilha.
`setTitle(chartTitle)`	`EmbeddedPieChartBuilder`	Define o título do gráfico.
`setTitleTextStyle(textStyle)`	`EmbeddedPieChartBuilder`	Define o estilo do texto do título do gráfico.
`setTransposeRowsAndColumns(transpose)`	`EmbeddedChartBuilder`	Define se as linhas e colunas do gráfico são transpostas.

Documentação detalhada

`addRange(range)`

Adiciona um intervalo ao gráfico que este builder modifica. Não adiciona o intervalo se ele já foi adicionado ao gráfico.

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

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

sheet.insertChart(chart);

Parâmetros

Nome	Tipo	Descrição
`range`	`Range`	O intervalo a ser adicionado.

Retornar

EmbeddedChartBuilder: este builder, para encadeamento.

`asAreaChart()`

Define o tipo de gráfico como AreaChart e retorna um EmbeddedAreaChartBuilder.

Retornar

EmbeddedAreaChartBuilder: um builder para um gráfico de área.

`asBarChart()`

Define o tipo de gráfico como BarChart e retorna um EmbeddedBarChartBuilder.

Retornar

EmbeddedBarChartBuilder: um criador de gráficos de barras.

`asColumnChart()`

Define o tipo de gráfico como "ColumnChart" e retorna um EmbeddedColumnChartBuilder.

Retornar

EmbeddedColumnChartBuilder: um builder para um gráfico de colunas.

`asComboChart()`

Define o tipo de gráfico como "ComboChart" e retorna um EmbeddedComboChartBuilder.

Retornar

EmbeddedComboChartBuilder: um builder para um gráfico de combinação.

`asHistogramChart()`

Define o tipo de gráfico como HistogramChart e retorna um EmbeddedHistogramChartBuilder.

Retornar

EmbeddedHistogramChartBuilder: um criador de histograma.

`asLineChart()`

Define o tipo de gráfico como LineChart e retorna um EmbeddedLineChartBuilder.

Retornar

EmbeddedLineChartBuilder: um criador para um gráfico de linhas.

`asPieChart()`

Define o tipo de gráfico como PieChart e retorna um EmbeddedPieChartBuilder.

Retornar

EmbeddedPieChartBuilder: um builder para um gráfico de pizza.

`asScatterChart()`

Define o tipo de gráfico como "ScatterChart" e retorna um EmbeddedScatterChartBuilder.

Retornar

EmbeddedScatterChartBuilder: um builder para um gráfico de dispersão.

`asTableChart()`

Define o tipo de gráfico como TableChart e retorna um EmbeddedTableChartBuilder.

Retornar

EmbeddedTableChartBuilder: um criador de gráficos de tabela.

`build()`

Cria o gráfico para refletir todas as mudanças feitas nele.

Esse método não desenha automaticamente o gráfico na parte de cima da planilha. Um novo gráfico precisa ser inserido usando sheet.insertChart(chart), e um gráfico atual precisa ser atualizado usando sheet.updateChart(chart).

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

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

sheet.insertChart(chart);

Retornar

EmbeddedChart: o gráfico criado, que ainda precisa ser adicionado à planilha.

`clearRanges()`

Remove todos os intervalos do gráfico que este builder modifica.

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

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

Retornar

EmbeddedChartBuilder: este builder, para encadeamento.

`getChartType()`

Retorna o tipo de gráfico atual.

Retornar

ChartType: o tipo de gráfico.

`getContainer()`

Retorna o gráfico ContainerInfo, que encapsula onde ele aparece na planilha.

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

const 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()
const containerInfo = chartBuilder.getContainer();

// Logs the values 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(),
);

Retornar

ContainerInfo: um objeto que contém a posição do contêiner do gráfico.

`getRanges()`

Retorna uma cópia da lista de intervalos que fornecem dados para este gráfico. Use addRange(range) e removeRange(range) para modificar essa lista.

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

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

const ranges = chartBuilder.getRanges();

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

Retornar

Range[]: uma matriz de intervalos que servem como fonte de dados do gráfico a ser criado.

`removeRange(range)`

Remove o intervalo especificado do gráfico que este builder modifica. Não gera um erro se o intervalo não estiver no gráfico.

O intervalo removido precisa corresponder a um intervalo adicionado via addRange(range). Caso contrário, nenhuma mudança será feita no gráfico. Esse método não pode ser usado para remover parcialmente valores de um intervalo.

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

const firstRange = sheet.getRange('A1:B5');
const secondRange = sheet.getRange('A6:B8');

const chartBuilder = sheet.newChart()
                         .setChartType(Charts.ChartType.BAR)
                         .addRange(firstRange)
                         // This range renders 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
// is not removed, and does not throw an exception
chartBuilder.removeRange(firstRange);
chartBuilder.removeRange(sheet.getRange('A6:B8'));

const chart = chartBuilder.build();

sheet.insertChart(chart);

Parâmetros

Nome	Tipo	Descrição
`range`	`Range`	O intervalo a ser removido.

Retornar

EmbeddedChartBuilder: este builder, para encadeamento.

`reverseCategories()`

Inverte a ordem das séries no eixo de domínio. Para gráficos de intervalo vertical (como de linhas, áreas ou colunas), isso significa que o eixo horizontal é desenhado da direita para a esquerda. Para gráficos de intervalo horizontal (como gráficos de barras), isso significa que o eixo vertical é desenhado de cima para baixo. Para gráficos de pizza, isso significa que as fatias são desenhadas no sentido anti-horário.

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

Retornar

EmbeddedPieChartBuilder: esse builder, útil para encadeamento.

`set3D()`

Define o gráfico como tridimensional.

Retornar

EmbeddedPieChartBuilder: esse builder, útil para encadeamento.

`setBackgroundColor(cssValue)`

Define a cor do plano de fundo do gráfico.

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

Parâmetros

Nome	Tipo	Descrição
`cssValue`	`String`	O valor CSS da cor (como `"blue"` ou `"#00f"`).

Retornar

EmbeddedPieChartBuilder: esse builder, útil para encadeamento.

`setChartType(type)`

Muda o tipo de gráfico. No momento, nem todos os tipos de gráficos incorporados são compatíveis. Consulte ChartType.

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

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

sheet.insertChart(chart);

Parâmetros

Nome	Tipo	Descrição
`type`	`ChartType`	O tipo para mudar este gráfico.

Retornar

EmbeddedChartBuilder: este builder, para encadeamento.

`setColors(cssValues)`

Define as cores das linhas no gráfico.

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

Parâmetros

Nome	Tipo	Descrição
`cssValues`	`String[]`	Uma matriz de valores CSS de cor, como `["red", "#acf"]`. O n-ésimo elemento na matriz representa a cor da n-ésima linha no gráfico.

Retornar

EmbeddedPieChartBuilder: esse builder, útil para encadeamento.

`setHiddenDimensionStrategy(strategy)`

Define a estratégia a ser usada para linhas e colunas ocultas. O valor padrão é IGNORE_ROWS.

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

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

sheet.insertChart(chart);

Parâmetros

Nome	Tipo	Descrição
`strategy`	`ChartHiddenDimensionStrategy`	A estratégia a ser usada para linhas e colunas ocultas.

Retornar

EmbeddedChartBuilder: este builder, para encadeamento.

`setLegendPosition(position)`

Define a posição da legenda em relação ao gráfico. Por padrão, não há legenda.

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

Parâmetros

Nome	Tipo	Descrição
`position`	`Position`	A posição da legenda.

Retornar

EmbeddedPieChartBuilder: esse builder, útil para encadeamento.

`setLegendTextStyle(textStyle)`

Define o estilo do texto da legenda do gráfico.

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

Parâmetros

Nome	Tipo	Descrição
`textStyle`	`TextStyle`	O estilo de texto a ser usado na legenda do gráfico.

Retornar

EmbeddedPieChartBuilder: esse builder, útil para encadeamento.

`setMergeStrategy(mergeStrategy)`

Define a estratégia de mesclagem a ser usada quando houver mais de um intervalo. Se MERGE_ROWS, as linhas serão mescladas. Se MERGE_COLUMNS, as colunas serão mescladas. O valor padrão é MERGE_COLUMNS.

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

const range = sheet.getRange('A1:B10');
const range2 = sheet.getRange('C:C10');
const 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);

Parâmetros

Nome	Tipo	Descrição
`mergeStrategy`	`ChartMergeStrategy`	A estratégia de fusão a ser usada.

Retornar

EmbeddedChartBuilder: este builder, para encadeamento.

`setNumHeaders(headers)`

Define o número de linhas ou colunas do intervalo que devem ser tratados como cabeçalhos.

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

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

sheet.insertChart(chart);

Parâmetros

Nome	Tipo	Descrição
`headers`	`Integer`	O número de linhas ou colunas a serem tratadas como cabeçalhos. Valores negativos fazem com que os cabeçalhos sejam detectados automaticamente.

Retornar

EmbeddedChartBuilder: este builder, para encadeamento.

`setOption(option, value)`

Define opções avançadas para este gráfico. Para conferir uma lista das opções disponíveis, consulte Opções de configuração de gráficos.

Esse método não valida se a opção especificada é válida para esse tipo de gráfico nem se o valor está no formato/estrutura correto.

Este exemplo mostra como mudar o título e definir uma legenda.

const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
const sheet = spreadsheet.getSheets()[0];
const chart = sheet.newChart()
 .setOption('title', 'Earnings projections')
 .setOption('legend', {
   position: 'top',
   textStyle: { color: 'blue', fontSize: 16 },
 }).build();

Parâmetros

Nome	Tipo	Descrição
`option`	`String`	O nome da opção.
`value`	`Object`	O valor da opção.

Retornar

EmbeddedChartBuilder: este builder, para encadeamento.

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

Define a posição, mudando onde o gráfico aparece na planilha. anchorRowPos e anchorColPos são indexados em 1.

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

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

sheet.insertChart(chart);

Parâmetros

Nome	Tipo	Descrição
`anchorRowPos`	`Integer`	A parte superior do gráfico fica ancorada nessa linha.
`anchorColPos`	`Integer`	O lado esquerdo do gráfico está fixado nessa coluna.
`offsetX`	`Integer`	O canto superior direito do gráfico é deslocado por essa quantidade de pixels.
`offsetY`	`Integer`	O canto inferior esquerdo do gráfico é deslocado por esse número de pixels.

Retornar

EmbeddedChartBuilder: este builder, para encadeamento.

`setTitle(chartTitle)`

Define o título do gráfico. O título é exibido centralizado acima do gráfico.

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

Parâmetros

Nome	Tipo	Descrição
`chartTitle`	`String`	o título do gráfico.

Retornar

EmbeddedPieChartBuilder: esse builder, útil para encadeamento.

`setTitleTextStyle(textStyle)`

Define o estilo do texto do título do gráfico.

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

Parâmetros

Nome	Tipo	Descrição
`textStyle`	`TextStyle`	O estilo de texto a ser usado para o título do gráfico. Chame `Charts.newTextStyle()` para criar um objeto `TextStyleBuilder`.

Retornar

EmbeddedPieChartBuilder: esse builder, útil para encadeamento.

`setTransposeRowsAndColumns(transpose)`

Define se as linhas e colunas do gráfico são transpostas. Se definido como true, as linhas e colunas serão trocadas. O padrão é false.

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

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

sheet.insertChart(chart);

Parâmetros

Nome	Tipo	Descrição
`transpose`	`Boolean`	Se `true`, as linhas e colunas usadas para construir o gráfico serão transpostas.

Retornar

EmbeddedChartBuilder: este builder, para encadeamento.

Class EmbeddedPieChartBuilder Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Métodos

Documentação detalhada

addRange(range)

Parâmetros

Retornar

asAreaChart()

Retornar

asBarChart()

Retornar

asColumnChart()

Retornar

asComboChart()

Retornar

asHistogramChart()

Retornar

asLineChart()

Retornar

asPieChart()

Retornar

asScatterChart()

Retornar

asTableChart()

Retornar

build()

Retornar

clearRanges()

Retornar

getChartType()

Retornar

getContainer()

Retornar

getRanges()

Retornar

removeRange(range)

Parâmetros

Retornar

reverseCategories()

Retornar

set3D()

Retornar

setBackgroundColor(cssValue)

Parâmetros

Retornar

setChartType(type)

Parâmetros

Retornar

setColors(cssValues)

Parâmetros

Retornar

setHiddenDimensionStrategy(strategy)

Parâmetros

Retornar

setLegendPosition(position)

Parâmetros

Retornar

setLegendTextStyle(textStyle)

Parâmetros

Retornar

setMergeStrategy(mergeStrategy)

Parâmetros

Retornar

setNumHeaders(headers)

Parâmetros

Retornar

setOption(option, value)

Parâmetros

Retornar

setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

Parâmetros

Retornar

setTitle(chartTitle)

Parâmetros

Retornar

setTitleTextStyle(textStyle)

Parâmetros

Retornar

setTransposeRowsAndColumns(transpose)

Parâmetros

Retornar

Class EmbeddedPieChartBuilder

`addRange(range)`

`asAreaChart()`

`asBarChart()`

`asColumnChart()`

`asComboChart()`

`asHistogramChart()`

`asLineChart()`

`asPieChart()`

`asScatterChart()`

`asTableChart()`

`build()`

`clearRanges()`

`getChartType()`

`getContainer()`

`getRanges()`

`removeRange(range)`

`reverseCategories()`

`set3D()`

`setBackgroundColor(cssValue)`

`setChartType(type)`

`setColors(cssValues)`

`setHiddenDimensionStrategy(strategy)`

`setLegendPosition(position)`

`setLegendTextStyle(textStyle)`

`setMergeStrategy(mergeStrategy)`

`setNumHeaders(headers)`

`setOption(option, value)`

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

`setTitle(chartTitle)`

`setTitleTextStyle(textStyle)`

`setTransposeRowsAndColumns(transpose)`