Bu sayfa, Cloud Translation API ile çevrilmiştir.

Class EmbeddedPieChartBuilder

Pasta grafikler için oluşturucu. Daha fazla bilgi için Gviz dokümanlarını inceleyin.

Yöntemler

Yöntem	Dönüş türü	Kısa açıklama
`addRange(range)`	`EmbeddedChartBuilder`	Bu derleyicinin değiştirdiği grafiğe bir aralık ekler.
`asAreaChart()`	`EmbeddedAreaChartBuilder`	Grafik türünü AreaChart olarak ayarlar ve bir `EmbeddedAreaChartBuilder` döndürür.
`asBarChart()`	`EmbeddedBarChartBuilder`	Grafik türünü BarChart olarak ayarlar ve bir `EmbeddedBarChartBuilder` döndürür.
`asColumnChart()`	`EmbeddedColumnChartBuilder`	Grafik türünü ColumnChart olarak ayarlar ve bir `EmbeddedColumnChartBuilder` döndürür.
`asComboChart()`	`EmbeddedComboChartBuilder`	Grafik türünü ComboChart olarak ayarlar ve bir `EmbeddedComboChartBuilder` döndürür.
`asHistogramChart()`	`EmbeddedHistogramChartBuilder`	Grafik türünü HistogramChart olarak ayarlar ve bir `EmbeddedHistogramChartBuilder` döndürür.
`asLineChart()`	`EmbeddedLineChartBuilder`	Grafik türünü LineChart olarak ayarlar ve bir `EmbeddedLineChartBuilder` döndürür.
`asPieChart()`	`EmbeddedPieChartBuilder`	Grafik türünü PieChart olarak ayarlar ve bir `EmbeddedPieChartBuilder` döndürür.
`asScatterChart()`	`EmbeddedScatterChartBuilder`	Grafik türünü ScatterChart olarak ayarlar ve bir `EmbeddedScatterChartBuilder` döndürür.
`asTableChart()`	`EmbeddedTableChartBuilder`	Grafik türünü TableChart olarak ayarlar ve bir `EmbeddedTableChartBuilder` döndürür.
`build()`	`EmbeddedChart`	Grafik, üzerinde yapılan tüm değişiklikleri yansıtacak şekilde oluşturulur.
`clearRanges()`	`EmbeddedChartBuilder`	Bu oluşturucunun değiştirdiği grafikteki tüm aralıkları kaldırır.
`getChartType()`	`ChartType`	Geçerli grafik türünü döndürür.
`getContainer()`	`ContainerInfo`	E-tabloda grafiğin nerede göründüğünü kapsayan grafik `ContainerInfo` değerini döndürür.
`getRanges()`	`Range[]`	Şu anda bu grafik için veri sağlayan aralıkların listesinin bir kopyasını döndürür.
`removeRange(range)`	`EmbeddedChartBuilder`	Belirtilen aralığı, bu oluşturucunun değiştirdiği grafikten kaldırır.
`reverseCategories()`	`EmbeddedPieChartBuilder`	Alan eksenindeki serilerin çizimini tersine çevirir.
`set3D()`	`EmbeddedPieChartBuilder`	Grafiği üç boyutlu olarak ayarlar.
`setBackgroundColor(cssValue)`	`EmbeddedPieChartBuilder`	Grafiğin arka plan rengini ayarlar.
`setChartType(type)`	`EmbeddedChartBuilder`	Grafik türünü değiştirir.
`setColors(cssValues)`	`EmbeddedPieChartBuilder`	Grafikteki çizgilerin renklerini ayarlar.
`setHiddenDimensionStrategy(strategy)`	`EmbeddedChartBuilder`	Gizli satırlar ve sütunlar için kullanılacak stratejiyi belirler.
`setLegendPosition(position)`	`EmbeddedPieChartBuilder`	Açıklamanın grafiğe göre konumunu ayarlar.
`setLegendTextStyle(textStyle)`	`EmbeddedPieChartBuilder`	Grafik açıklamasının metin stilini ayarlar.
`setMergeStrategy(mergeStrategy)`	`EmbeddedChartBuilder`	Birden fazla aralık olduğunda kullanılacak birleştirme stratejisini belirler.
`setNumHeaders(headers)`	`EmbeddedChartBuilder`	Aralığın başlık olarak değerlendirilmesi gereken satır veya sütun sayısını ayarlar.
`setOption(option, value)`	`EmbeddedChartBuilder`	Bu grafik için gelişmiş seçenekleri belirler.
`setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)`	`EmbeddedChartBuilder`	Grafiğin e-tabloda göründüğü yeri değiştirerek konumu belirler.
`setTitle(chartTitle)`	`EmbeddedPieChartBuilder`	Grafiğin başlığını ayarlar.
`setTitleTextStyle(textStyle)`	`EmbeddedPieChartBuilder`	Grafiğin başlığının metin stilini belirler.
`setTransposeRowsAndColumns(transpose)`	`EmbeddedChartBuilder`	Grafiğin satır ve sütunlarının transpoze edilip edilmeyeceğini belirler.

Ayrıntılı dokümanlar

`addRange(range)`

Bu derleyicinin değiştirdiği grafiğe bir aralık ekler. Grafike zaten eklenmişse aralığı eklemez.

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);

Parametreler

Ad	Tür	Açıklama
`range`	`Range`	Eklenecek aralık.

Return

EmbeddedChartBuilder: zincirleme için bu oluşturucu

`asAreaChart()`

Grafik türünü AreaChart olarak ayarlar ve bir EmbeddedAreaChartBuilder döndürür.

Return

EmbeddedAreaChartBuilder: Alan grafiği oluşturucu

`asBarChart()`

Grafik türünü BarChart olarak ayarlar ve bir EmbeddedBarChartBuilder döndürür.

Return

EmbeddedBarChartBuilder: Çubuk grafik oluşturucu

`asColumnChart()`

Grafik türünü ColumnChart olarak ayarlar ve bir EmbeddedColumnChartBuilder döndürür.

Return

EmbeddedColumnChartBuilder: sütun grafiği oluşturucu

`asComboChart()`

Grafik türünü ComboChart olarak ayarlar ve bir EmbeddedComboChartBuilder döndürür.

Return

EmbeddedComboChartBuilder: Karma grafik oluşturucu

`asHistogramChart()`

Grafik türünü HistogramChart olarak ayarlar ve bir EmbeddedHistogramChartBuilder döndürür.

Return

EmbeddedHistogramChartBuilder: histogram grafiği oluşturucu

`asLineChart()`

Grafik türünü LineChart olarak ayarlar ve bir EmbeddedLineChartBuilder döndürür.

Return

EmbeddedLineChartBuilder: Çizgi grafik oluşturucu

`asPieChart()`

Grafik türünü PieChart olarak ayarlar ve bir EmbeddedPieChartBuilder döndürür.

Return

EmbeddedPieChartBuilder: Pasta grafiği oluşturucu

`asScatterChart()`

Grafik türünü ScatterChart olarak ayarlar ve bir EmbeddedScatterChartBuilder döndürür.

Return

EmbeddedScatterChartBuilder: Dağılım grafiği oluşturucu

`asTableChart()`

Grafik türünü TableChart olarak ayarlar ve bir EmbeddedTableChartBuilder döndürür.

Return

EmbeddedTableChartBuilder: Tablo grafiği oluşturucu

`build()`

Grafik, üzerinde yapılan tüm değişiklikleri yansıtacak şekilde oluşturulur.

Bu yöntem, grafiği e-tablonun üzerine otomatik olarak çizmez. Yeni bir grafik sheet.insertChart(chart) aracılığıyla, mevcut bir grafik ise sheet.updateChart(chart) aracılığıyla eklenmelidir.

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);

Return

EmbeddedChart: Oluşturulan grafik (e-tabloya eklenmelidir)

`clearRanges()`

Bu oluşturucunun değiştirdiği grafikteki tüm aralıkları kaldırır.

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);

Return

EmbeddedChartBuilder: zincirleme için bu oluşturucu

`getChartType()`

Geçerli grafik türünü döndürür.

Return

ChartType: Grafik türü

`getContainer()`

E-tabloda grafiğin nerede göründüğünü kapsayan grafik ContainerInfo değerini döndürür.

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(),
);

Return

ContainerInfo: Grafik kapsayıcısının konumunu içeren bir nesne

`getRanges()`

Şu anda bu grafik için veri sağlayan aralıkların listesinin bir kopyasını döndürür. Bu listeyi değiştirmek için addRange(range) ve removeRange(range) simgesini kullanın.

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());
}

Return

Range[]: Oluşturulacak grafiğin veri kaynağı olarak kullanılan bir aralık dizisi

`removeRange(range)`

Belirtilen aralığı, bu oluşturucunun değiştirdiği grafikten kaldırır. Aralık bu grafikte yoksa hata vermez.

Kaldırılan aralık, addRange(range) aracılığıyla eklenen bir aralıkla eşleşmelidir. Aksi takdirde grafikte herhangi bir değişiklik yapılmaz. Bu yöntem, bir aralıktaki değerleri kısmen kaldırmak için kullanılamaz.

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 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'));

const chart = chartBuilder.build();

sheet.insertChart(chart);

Parametreler

Ad	Tür	Açıklama
`range`	`Range`	Kaldırılacağı aralık.

Return

EmbeddedChartBuilder: zincirleme için bu oluşturucu

`reverseCategories()`

Alan eksenindeki serilerin çizimini tersine çevirir. Dikey aralık grafiklerinde (ör. çizgi, alan veya sütun grafikleri) bu, yatay eksenin sağdan sola doğru çizildiği anlamına gelir. Yatay aralık grafiklerinde (ör. çubuk grafikler) bu, dikey eksenin yukarıdan aşağıya doğru çizildiği anlamına gelir. Pasta grafiklerde bu, dilimlerin saat yönünün tersine çizildiği anlamına gelir.

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

Return

EmbeddedPieChartBuilder: Zincirleme için yararlı olan bu oluşturucu.

`set3D()`

Grafiği üç boyutlu olarak ayarlar.

Return

EmbeddedPieChartBuilder: Zincirleme için yararlı olan bu oluşturucu.

`setBackgroundColor(cssValue)`

Grafiğin arka plan rengini ayarlar.

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

Parametreler

Ad	Tür	Açıklama
`cssValue`	`String`	Rengin CSS değeri (`"blue"` veya `"#00f"` gibi).

Return

EmbeddedPieChartBuilder: Zincirleme için yararlı olan bu oluşturucu.

`setChartType(type)`

Grafik türünü değiştirir. Şu anda tüm yerleşik grafik türleri desteklenmiyor. Şu sayfaya göz atın: 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);

Parametreler

Ad	Tür	Açıklama
`type`	`ChartType`	Bu grafiğin dönüştürüleceği tür.

Return

EmbeddedChartBuilder: zincirleme için bu oluşturucu

`setColors(cssValues)`

Grafikteki çizgilerin renklerini ayarlar.

// 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']);

Parametreler

Ad	Tür	Açıklama
`cssValues`	`String[]`	`["red", "#acf"]` gibi bir renk CSS değerleri dizisi. Dizideki n. öğe, grafikteki n. satırın rengini temsil eder.

Return

EmbeddedPieChartBuilder: Zincirleme için yararlı olan bu oluşturucu.

`setHiddenDimensionStrategy(strategy)`

Gizli satırlar ve sütunlar için kullanılacak stratejiyi belirler. Varsayılan olarak IGNORE_ROWS değerine ayarlanır.

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);

Parametreler

Ad	Tür	Açıklama
`strategy`	`ChartHiddenDimensionStrategy`	Gizli satırlar ve sütunlar için kullanılacak strateji.

Return

EmbeddedChartBuilder: zincirleme için bu oluşturucu

`setLegendPosition(position)`

Açıklamanın grafiğe göre konumunu ayarlar. Varsayılan olarak bir açıklama yoktur.

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

Parametreler

Ad	Tür	Açıklama
`position`	`Position`	Açıklama bölümünün konumu.

Return

EmbeddedPieChartBuilder: Zincirleme için yararlı olan bu oluşturucu.

`setLegendTextStyle(textStyle)`

Grafik açıklamasının metin stilini ayarlar.

// 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);

Parametreler

Ad	Tür	Açıklama
`textStyle`	`TextStyle`	Grafikle ilgili açıklama metni için kullanılacak metin stili.

Return

EmbeddedPieChartBuilder: Zincirleme için yararlı olan bu oluşturucu.

`setMergeStrategy(mergeStrategy)`

Birden fazla aralık olduğunda kullanılacak birleştirme stratejisini belirler. MERGE_ROWS ise satırlar, MERGE_COLUMNS ise sütunlar birleştirilir. Varsayılan olarak MERGE_COLUMNS değerine ayarlanır.

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);

Parametreler

Ad	Tür	Açıklama
`mergeStrategy`	`ChartMergeStrategy`	Kullanılacak birleştirme stratejisi.

Return

EmbeddedChartBuilder: zincirleme için bu oluşturucu

`setNumHeaders(headers)`

Aralığın başlık olarak değerlendirilmesi gereken satır veya sütun sayısını ayarlar.

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);

Parametreler

Ad	Tür	Açıklama
`headers`	`Integer`	Üstbilgi olarak değerlendirilecek satır veya sütun sayısı. Negatif değerler, başlıkların otomatik olarak algılanmasına neden olur.

Return

EmbeddedChartBuilder: zincirleme için bu oluşturucu

`setOption(option, value)`

Bu grafik için gelişmiş seçenekleri belirler. Mevcut seçeneklerin listesini görüntülemek için Grafiğin yapılandırma seçenekleri başlıklı makaleyi inceleyin.

Bu yöntem, belirttiğiniz seçeneğin bu grafik türü için geçerli olup olmadığını veya değerin doğru biçim/yapıda olup olmadığını doğrulamaz.

Bu örnekte, başlığın nasıl değiştirileceği ve bir açıklamanın nasıl ayarlanacağı gösterilmektedir.

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();

Parametreler

Ad	Tür	Açıklama
`option`	`String`	Seçeneğin adı.
`value`	`Object`	Seçeneğin değeri.

Return

EmbeddedChartBuilder: Zincirleme için bu oluşturucu.

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

Grafiğin e-tabloda göründüğü yeri değiştirerek konumu belirler. anchorRowPos ve anchorColPos 1'den başlar.

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);

Parametreler

Ad	Tür	Açıklama
`anchorRowPos`	`Integer`	Grafiğin üst tarafı bu satıra sabitlenir.
`anchorColPos`	`Integer`	Grafiğin sol tarafı bu sütuna sabitlenir.
`offsetX`	`Integer`	Grafiğin sağ üst köşesi bu kadar piksel kaydırılır.
`offsetY`	`Integer`	Grafiğin sol alt köşesi bu kadar piksel kaydırılır.

Return

EmbeddedChartBuilder: zincirleme için bu oluşturucu

`setTitle(chartTitle)`

Grafiğin başlığını ayarlar. Başlık, grafiğin üst kısmında ortalanıp gösterilir.

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

Parametreler

Ad	Tür	Açıklama
`chartTitle`	`String`	grafik başlığı.

Return

EmbeddedPieChartBuilder: Zincirleme için yararlı olan bu oluşturucu.

`setTitleTextStyle(textStyle)`

Grafiğin başlığının metin stilini belirler.

// 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);

Parametreler

Ad	Tür	Açıklama
`textStyle`	`TextStyle`	Grafik başlığı için kullanılacak metin stili. `Charts.newTextStyle()` işlevini çağırarak bir `TextStyleBuilder` nesnesi oluşturabilirsiniz.

Return

EmbeddedPieChartBuilder: Zincirleme için yararlı olan bu oluşturucu.

`setTransposeRowsAndColumns(transpose)`

Grafiğin satır ve sütunlarının transpoze edilip edilmeyeceğini belirler. true olarak ayarlanırsa satırlar ve sütunlar değiştirilir. Varsayılan olarak false değerine ayarlanır.

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);

Parametreler

Ad	Tür	Açıklama
`transpose`	`Boolean`	`true` ise grafiği oluşturmak için kullanılan satırlar ve sütunlar transpoze edilir.

Return

EmbeddedChartBuilder: zincirleme için bu oluşturucu