Class ColumnChartBuilder

ColumnChartBuilder

Sütun grafikler için oluşturucu. Daha ayrıntılı bilgi için Google Grafikler dokümanlarına bakın.

Bu örnekte, bir veri tablosundaki verileri kullanarak nasıl sütun grafik oluşturulacağı gösterilmektedir.

var sampleData = Charts.newDataTable()
    .addColumn(Charts.ColumnType.STRING, "Year")
    .addColumn(Charts.ColumnType.NUMBER, "Sales")
    .addColumn(Charts.ColumnType.NUMBER, "Expenses")
    .addRow(["2004", 1000, 400])
    .addRow(["2005", 1170, 460])
    .addRow(["2006", 660, 1120])
    .addRow(["2007", 1030, 540])
    .addRow(["2008", 800, 600])
    .addRow(["2009", 943, 678])
    .addRow(["2010", 1020, 550])
    .addRow(["2011", 910, 700])
    .addRow(["2012", 1230, 840])
    .build();

var chart = Charts.newColumnChart()
    .setTitle('Sales & Expenses')
    .setXAxisTitle('Year')
    .setYAxisTitle('Amount (USD)')
    .setDimensions(600, 500)
    .setDataTable(sampleData)
    .build();

Yöntemler

YöntemDönüş türüKısa açıklama
build()ChartGrafiği oluşturur.
reverseCategories()ColumnChartBuilderAlan eksenindeki seri çizimini tersine çevirir.
setBackgroundColor(cssValue)ColumnChartBuilderGrafiğin arka plan rengini ayarlar.
setColors(cssValues)ColumnChartBuilderGrafikteki çizgilerin renklerini ayarlar.
setDataSourceUrl(url)ColumnChartBuilderGoogle E-Tablolar gibi harici bir kaynaktan veri çekmek için kullanılan veri kaynağı URL'sini ayarlar.
setDataTable(tableBuilder)ColumnChartBuilderDataTableBuilder kullanarak grafik için kullanılacak veri tablosunu ayarlar.
setDataTable(table)ColumnChartBuilderGrafiğin çizgilerini ve X ekseni etiketlerini içeren veri tablosunu ayarlar.
setDataViewDefinition(dataViewDefinition)ColumnChartBuilderGrafik için kullanılacak veri görünümü tanımını ayarlar.
setDimensions(width, height)ColumnChartBuilderGrafiğin boyutlarını ayarlar.
setLegendPosition(position)ColumnChartBuilderGöstergenin grafiğe göre konumunu ayarlar.
setLegendTextStyle(textStyle)ColumnChartBuilderGrafik açıklamasının metin stilini ayarlar.
setOption(option, value)ColumnChartBuilderBu grafik için gelişmiş seçenekleri belirler.
setRange(start, end)ColumnChartBuilderGrafik için aralığı ayarlar.
setStacked()ColumnChartBuilderYığılmış çizgiler kullanır, yani çizgi ve çubuk değerlerinin yığılması (toplandığı) anlamına gelir.
setTitle(chartTitle)ColumnChartBuilderGrafiğin başlığını ayarlar.
setTitleTextStyle(textStyle)ColumnChartBuilderGrafik başlığının metin stilini ayarlar.
setXAxisTextStyle(textStyle)ColumnChartBuilderYatay eksen metin stilini ayarlar.
setXAxisTitle(title)ColumnChartBuilderYatay eksene başlık ekler.
setXAxisTitleTextStyle(textStyle)ColumnChartBuilderYatay eksen başlık metin stilini ayarlar.
setYAxisTextStyle(textStyle)ColumnChartBuilderDikey eksen metin stilini ayarlar.
setYAxisTitle(title)ColumnChartBuilderDikey eksene başlık ekler.
setYAxisTitleTextStyle(textStyle)ColumnChartBuilderDikey eksen başlık metin stilini ayarlar.
useLogScale()ColumnChartBuilderAralık eksenini logaritmik bir ölçek haline getirir (tüm değerlerin pozitif olması gerekir).

Ayrıntılı belgeler

build()

Grafiği oluşturur.

Return

Chart: Dokümanlara ve kullanıcı arayüzü öğelerine yerleştirilebilen veya statik resim olarak kullanılabilen bir Grafik nesnesidir.


reverseCategories()

Alan eksenindeki seri çizimini tersine çevirir. Dikey aralıklı grafiklerde (çizgi, alan veya sütun grafikler gibi) yatay eksen, sağdan sola doğru çizilir. Bu, yatay aralıklı grafiklerde (çubuk grafikler gibi) dikey eksenin yukarıdan aşağıya doğru çizildiği anlamına gelir. Pasta grafiklerde bu, dilimlerin saat yönünün tersine çizileceği anlamına gelir.

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

Return

ColumnChartBuilder: Bu oluşturucu, zincirleme bağlantı için kullanışlıdır.


setBackgroundColor(cssValue)

Grafiğin arka plan rengini ayarlar.

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

Parametreler

AdTürAçıklama
cssValueStringRengin CSS değeri ("blue" veya "#00f" gibi).

Return

ColumnChartBuilder: Bu oluşturucu, zincirleme bağlantı için kullanışlıdır.


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.
var builder = Charts.newLineChart();
builder.setColors(["green", "red"]);

Parametreler

AdTürAçıklama
cssValuesString[]["red", "#acf"] gibi renk CSS değerleri dizisi. Dizideki n'inci öğe, grafikteki n'inci çizginin rengini temsil eder.

Return

ColumnChartBuilder: Bu oluşturucu, zincirleme bağlantı için kullanışlıdır.


setDataSourceUrl(url)

Google E-Tablolar gibi harici bir kaynaktan veri çekmek için kullanılan veri kaynağı URL'sini ayarlar. Bir veri kaynağı URL'si ve bir DataTable sağlanırsa veri kaynağı URL'si yoksayılır.

Veri kaynaklarını sorgulama hakkında daha fazla bilgi için Google Grafikler dokümanlarına göz atın.

Parametreler

AdTürAçıklama
urlStringTüm sorgu parametreleri dahil veri kaynağı URL'si.

Return

ColumnChartBuilder: Bu oluşturucu, zincirleme bağlantı için kullanışlıdır.


setDataTable(tableBuilder)

DataTableBuilder kullanarak grafik için kullanılacak veri tablosunu ayarlar. Bu, build() yöntemini çağırmaya gerek kalmadan veri tablosunu ayarlamak için kullanışlı bir yöntemdir.

Parametreler

AdTürAçıklama
tableBuilderDataTableBuilderVeri tablosu oluşturma aracı. Bu çağrı kapsamında anında yeni bir veri tablosu oluşturulur. Bu nedenle, oluşturucuda yapılacak başka güncellemeler grafiğe yansıtılmaz.

Return

ColumnChartBuilder: Bu oluşturucu, zincirleme bağlantı için kullanışlıdır.


setDataTable(table)

Grafiğin çizgilerini ve X ekseni etiketlerini içeren veri tablosunu ayarlar. İlk sütun bir dize olmalı ve yatay eksen etiketlerini içermelidir. Ardından istediğiniz sayıda sütun gelebilir ve bunların tümü sayısal olmalıdır. Her sütun ayrı bir çizgi olarak gösterilir.

Parametreler

AdTürAçıklama
tableDataTableSourceGrafik için kullanılacak veri tablosu.

Return

ColumnChartBuilder: Bu oluşturucu, zincirleme bağlantı için kullanışlıdır.


setDataViewDefinition(dataViewDefinition)

Grafik için kullanılacak veri görünümü tanımını ayarlar.

Parametreler

AdTürAçıklama
dataViewDefinitionDataViewDefinitionGrafik çizimi için belirtilen veri kaynağından türetilmesi gereken görünümü tanımlayan bir veri görünümü tanım nesnesi.

Return

ColumnChartBuilder: Bu oluşturucu, zincirleme bağlantı için kullanışlıdır.


setDimensions(width, height)

Grafiğin boyutlarını ayarlar.

Parametreler

AdTürAçıklama
widthIntegerGrafiğin piksel cinsinden genişliği.
heightIntegerGrafiğin piksel cinsinden yüksekliği.

Return

ColumnChartBuilder: Bu oluşturucu, zincirleme bağlantı için kullanışlıdır.


setLegendPosition(position)

Göstergenin grafiğe göre konumunu ayarlar. Varsayılan olarak gösterge yoktur.

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

Parametreler

AdTürAçıklama
positionPositionAçıklamaların konumu.

Return

ColumnChartBuilder: Bu oluşturucu, zincirleme bağlantı için kullanışlıdır.


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.
var textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
var style = textStyleBuilder.build();
var builder = Charts.newLineChart();
builder.setLegendTextStyle(style);

Parametreler

AdTürAçıklama
textStyleTextStyleGrafik açıklaması için kullanılacak metin stili.

Return

ColumnChartBuilder: Bu oluşturucu, zincirleme bağlantı için kullanışlıdır.


setOption(option, value)

Bu grafik için gelişmiş seçenekleri belirler. Bu grafik için kullanılabilir seçeneklere bakın. Verilen seçenek geçersizse bu yöntemin hiçbir etkisi olmaz.

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

Parametreler

AdTürAçıklama
optionStringAyarlama seçeneği.
valueObjectAyarlanacak değer.

Return

ColumnChartBuilder: Bu oluşturucu, zincirleme bağlantı için kullanışlıdır.


setRange(start, end)

Grafik için aralığı ayarlar.

Aralığın dışında kalan veri noktaları varsa aralık, bu veri noktalarını içerecek şekilde genişletilir.

Parametreler

AdTürAçıklama
startNumberAralık ekseninin en düşük ızgara çizgisinin değeri.
endNumberAralık ekseninin en yüksek ızgara çizgisinin değeri.

Return

ColumnChartBuilder: Bu oluşturucu, zincirleme bağlantı için kullanışlıdır.


setStacked()

Yığılmış çizgiler kullanır, yani çizgi ve çubuk değerlerinin yığılması (toplandığı) anlamına gelir. Varsayılan olarak herhangi bir yığma yoktur.

Return

ColumnChartBuilder: Bu oluşturucu, zincirleme bağlantı için kullanışlıdır.


setTitle(chartTitle)

Grafiğin başlığını ayarlar. Başlık, grafiğin üstünde ortalanmış olarak görüntülenir.

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

Parametreler

AdTürAçıklama
chartTitleStringgrafik başlığı.

Return

ColumnChartBuilder: Bu oluşturucu, zincirleme bağlantı için kullanışlıdır.


setTitleTextStyle(textStyle)

Grafik başlığının metin stilini ayarlar.

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

Parametreler

AdTürAçıklama
textStyleTextStyleGrafik başlığı için kullanılacak metin stili. Charts.newTextStyle() yöntemini çağırarak TextStyleBuilder nesnesi oluşturabilirsiniz.

Return

ColumnChartBuilder: Bu oluşturucu, zincirleme bağlantı için kullanışlıdır.


setXAxisTextStyle(textStyle)

Yatay eksen metin stilini ayarlar.

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

Parametreler

AdTürAçıklama
textStyleTextStyleYatay eksen başlığı için kullanılacak metin stili. Charts.newTextStyle() yöntemini çağırarak TextStyleBuilder nesnesi oluşturabilirsiniz.

Return

ColumnChartBuilder: Bu oluşturucu, zincirleme bağlantı için kullanışlıdır.


setXAxisTitle(title)

Yatay eksene başlık ekler. Başlık ortalanır ve eksen değeri etiketlerinin altında görünür.

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

Parametreler

AdTürAçıklama
titleStringX ekseninin başlığı.

Return

ColumnChartBuilder: Bu oluşturucu, zincirleme bağlantı için kullanışlıdır.


setXAxisTitleTextStyle(textStyle)

Yatay eksen başlık metin stilini ayarlar.

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

Parametreler

AdTürAçıklama
textStyleTextStyleYatay eksen başlığı için kullanılacak metin stili. Charts.newTextStyle() yöntemini çağırarak TextStyleBuilder nesnesi oluşturabilirsiniz.

Return

ColumnChartBuilder: Bu oluşturucu, zincirleme bağlantı için kullanışlıdır.


setYAxisTextStyle(textStyle)

Dikey eksen metin stilini ayarlar.

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

Parametreler

AdTürAçıklama
textStyleTextStyleYatay eksen başlığı için kullanılacak metin stili. Charts.newTextStyle() yöntemini çağırarak TextStyleBuilder nesnesi oluşturabilirsiniz.

Return

ColumnChartBuilder: Bu oluşturucu, zincirleme bağlantı için kullanışlıdır.


setYAxisTitle(title)

Dikey eksene başlık ekler. Başlık ortalanır ve değer etiketlerinin sol tarafında görünür.

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

Parametreler

AdTürAçıklama
titleStringY ekseninin başlığı.

Return

ColumnChartBuilder: Bu oluşturucu, zincirleme bağlantı için kullanışlıdır.


setYAxisTitleTextStyle(textStyle)

Dikey eksen başlık metin stilini ayarlar.

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

Parametreler

AdTürAçıklama
textStyleTextStyleYatay eksen başlığı için kullanılacak metin stili. Charts.newTextStyle() yöntemini çağırarak TextStyleBuilder nesnesi oluşturabilirsiniz.

Return

ColumnChartBuilder: Bu oluşturucu, zincirleme bağlantı için kullanışlıdır.


useLogScale()

Aralık eksenini logaritmik bir ölçek haline getirir (tüm değerlerin pozitif olması gerekir). Aralık ekseni, dikey grafikler için dikey eksen (çizgi, alan veya sütun gibi), yatay grafikler içinse yatay eksendir (çubuk gibi).

Return

ColumnChartBuilder: Bu oluşturucu, zincirleme bağlantı için kullanışlıdır.