Çubuk grafikler oluşturucu. Daha ayrıntılı bilgi için Google Grafikler dokümanlarına bakın.
Çubuk grafiğin nasıl oluşturulacağını gösteren bir örneği aşağıda bulabilirsiniz. Veriler bir Google e-tablosundan içe aktarılır.
// Get sample data from a spreadsheet. var dataSourceUrl = 'https://docs.google.com/spreadsheet/tq?range=B1%3AC11' + '&key=0Aq4s9w_HxMs7dHpfX05JdmVSb1FpT21sbXd4NVE3UEE&gid=0&headers=-1'; var chartBuilder = Charts.newBarChart() .setTitle('Top Grossing Films in US and Canada') .setXAxisTitle('USD') .setYAxisTitle('Film') .setDimensions(600, 500) .setLegendPosition(Charts.Position.BOTTOM) .setDataSourceUrl(dataSourceUrl); var chart = chartBuilder.build();
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
build() | Chart | Grafiği oluşturur. |
reverseCategories() | BarChartBuilder | Alan eksenindeki seri çizimini tersine çevirir. |
reverseDirection() | BarChartBuilder | Çubukların yatay eksen boyunca büyüdüğü yönü tersine çevirir. |
setBackgroundColor(cssValue) | BarChartBuilder | Grafiğin arka plan rengini ayarlar. |
setColors(cssValues) | BarChartBuilder | Grafikteki çizgilerin renklerini ayarlar. |
setDataSourceUrl(url) | BarChartBuilder | Google E-Tablolar gibi harici bir kaynaktan veri çekmek için kullanılan veri kaynağı URL'sini ayarlar. |
setDataTable(tableBuilder) | BarChartBuilder | DataTableBuilder kullanarak grafik için kullanılacak veri tablosunu ayarlar. |
setDataTable(table) | BarChartBuilder | Grafiğin çizgilerini ve X ekseni etiketlerini içeren veri tablosunu ayarlar. |
setDataViewDefinition(dataViewDefinition) | BarChartBuilder | Grafik için kullanılacak veri görünümü tanımını ayarlar. |
setDimensions(width, height) | BarChartBuilder | Grafiğin boyutlarını ayarlar. |
setLegendPosition(position) | BarChartBuilder | Göstergenin grafiğe göre konumunu ayarlar. |
setLegendTextStyle(textStyle) | BarChartBuilder | Grafik açıklamasının metin stilini ayarlar. |
setOption(option, value) | BarChartBuilder | Bu grafik için gelişmiş seçenekleri belirler. |
setRange(start, end) | BarChartBuilder | Grafik için aralığı ayarlar. |
setStacked() | BarChartBuilder | Yığılmış çizgiler kullanır, yani çizgi ve çubuk değerlerinin yığılması (toplandığı) anlamına gelir. |
setTitle(chartTitle) | BarChartBuilder | Grafiğin başlığını ayarlar. |
setTitleTextStyle(textStyle) | BarChartBuilder | Grafik başlığının metin stilini ayarlar. |
setXAxisTextStyle(textStyle) | BarChartBuilder | Yatay eksen metin stilini ayarlar. |
setXAxisTitle(title) | BarChartBuilder | Yatay eksene başlık ekler. |
setXAxisTitleTextStyle(textStyle) | BarChartBuilder | Yatay eksen başlık metin stilini ayarlar. |
setYAxisTextStyle(textStyle) | BarChartBuilder | Dikey eksen metin stilini ayarlar. |
setYAxisTitle(title) | BarChartBuilder | Dikey eksene başlık ekler. |
setYAxisTitleTextStyle(textStyle) | BarChartBuilder | Dikey eksen başlık metin stilini ayarlar. |
useLogScale() | BarChartBuilder | Aralı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
BarChartBuilder
: Bu oluşturucu, zincirleme bağlantı için kullanışlıdır.
reverseDirection()
Çubukların yatay eksen boyunca büyüdüğü yönü tersine çevirir. Değerler, varsayılan olarak soldan sağa doğru büyür. Bu yöntemin çağrılması, sağdan sola doğru büyümelerine neden olur.
Return
BarChartBuilder
: 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
Ad | Tür | Açıklama |
---|---|---|
cssValue | String | Rengin CSS değeri ("blue" veya "#00f" gibi). |
Return
BarChartBuilder
: 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
Ad | Tür | Açıklama |
---|---|---|
cssValues | String[] | ["red", "#acf"] gibi renk CSS değerleri dizisi. Dizideki n'inci öğe, grafikteki n'inci çizginin rengini temsil eder. |
Return
BarChartBuilder
: 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
Ad | Tür | Açıklama |
---|---|---|
url | String | Tüm sorgu parametreleri dahil veri kaynağı URL'si. |
Return
BarChartBuilder
: 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
Ad | Tür | Açıklama |
---|---|---|
tableBuilder | DataTableBuilder | Veri 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
BarChartBuilder
: 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
Ad | Tür | Açıklama |
---|---|---|
table | DataTableSource | Grafik için kullanılacak veri tablosu. |
Return
BarChartBuilder
: 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
Ad | Tür | Açıklama |
---|---|---|
dataViewDefinition | DataViewDefinition | Grafik ç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
BarChartBuilder
: Bu oluşturucu, zincirleme bağlantı için kullanışlıdır.
setDimensions(width, height)
Grafiğin boyutlarını ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
width | Integer | Grafiğin piksel cinsinden genişliği. |
height | Integer | Grafiğin piksel cinsinden yüksekliği. |
Return
BarChartBuilder
: 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
Ad | Tür | Açıklama |
---|---|---|
position | Position | Açıklamaların konumu. |
Return
BarChartBuilder
: 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
Ad | Tür | Açıklama |
---|---|---|
textStyle | TextStyle | Grafik açıklaması için kullanılacak metin stili. |
Return
BarChartBuilder
: 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 bar chart with a 1-second animation duration. var builder = Charts.newBarChart(); builder.setOption('animation.duration', 1000); var chart = builder.build();
Parametreler
Ad | Tür | Açıklama |
---|---|---|
option | String | Ayarlama seçeneği. |
value | Object | Ayarlanacak değer. |
Return
BarChartBuilder
: 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
Ad | Tür | Açıklama |
---|---|---|
start | Number | Aralık ekseninin en düşük ızgara çizgisinin değeri. |
end | Number | Aralık ekseninin en yüksek ızgara çizgisinin değeri. |
Return
BarChartBuilder
: 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
BarChartBuilder
: 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
Ad | Tür | Açıklama |
---|---|---|
chartTitle | String | grafik başlığı. |
Return
BarChartBuilder
: 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
Ad | Tür | Açıklama |
---|---|---|
textStyle | TextStyle | Grafik başlığı için kullanılacak metin stili. Charts.newTextStyle() yöntemini çağırarak TextStyleBuilder nesnesi oluşturabilirsiniz. |
Return
BarChartBuilder
: 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
Ad | Tür | Açıklama |
---|---|---|
textStyle | TextStyle | Yatay eksen başlığı için kullanılacak metin stili. Charts.newTextStyle() yöntemini çağırarak TextStyleBuilder nesnesi oluşturabilirsiniz. |
Return
BarChartBuilder
: 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
Ad | Tür | Açıklama |
---|---|---|
title | String | X ekseninin başlığı. |
Return
BarChartBuilder
: 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
Ad | Tür | Açıklama |
---|---|---|
textStyle | TextStyle | Yatay eksen başlığı için kullanılacak metin stili. Charts.newTextStyle() yöntemini çağırarak TextStyleBuilder nesnesi oluşturabilirsiniz. |
Return
BarChartBuilder
: 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
Ad | Tür | Açıklama |
---|---|---|
textStyle | TextStyle | Yatay eksen başlığı için kullanılacak metin stili. Charts.newTextStyle() yöntemini çağırarak TextStyleBuilder nesnesi oluşturabilirsiniz. |
Return
BarChartBuilder
: 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
Ad | Tür | Açıklama |
---|---|---|
title | String | Y ekseninin başlığı. |
Return
BarChartBuilder
: 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
Ad | Tür | Açıklama |
---|---|---|
textStyle | TextStyle | Yatay eksen başlığı için kullanılacak metin stili. Charts.newTextStyle() yöntemini çağırarak TextStyleBuilder nesnesi oluşturabilirsiniz. |
Return
BarChartBuilder
: 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
BarChartBuilder
: Bu oluşturucu, zincirleme bağlantı için kullanışlıdır.