Class PieChartBuilder

PieChartBuilder

سازنده نمودارهای دایره ای. برای جزئیات بیشتر، به مستندات نمودارهای Google مراجعه کنید.

در اینجا مثالی آورده شده است که نحوه ساخت نمودار دایره ای را نشان می دهد. داده‌ها از صفحه‌گسترده Google وارد می‌شوند.

  // Get sample data from a spreadsheet.
  var dataSourceUrl = 'https://docs.google.com/spreadsheet/tq?range=A1%3AB8' +
      '&key=0Aq4s9w_HxMs7dHpfX05JdmVSb1FpT21sbXd4NVE3UEE&gid=3&headers=-1';

  var chartBuilder = Charts.newPieChart()
      .setTitle('World Population by Continent')
      .setDimensions(600, 500)
      .set3D()
      .setDataSourceUrl(dataSourceUrl);

  var chart = chartBuilder.build();

روش ها

روش	نوع برگشت	شرح مختصر
build()	Chart	نمودار را می سازد.
reverseCategories()	PieChartBuilder	رسم سری ها را در محور دامنه معکوس می کند.
set3D()	PieChartBuilder	نمودار را سه بعدی تنظیم می کند.
setBackgroundColor(cssValue)	PieChartBuilder	رنگ پس زمینه نمودار را تنظیم می کند.
setColors(cssValues)	PieChartBuilder	رنگ ها را برای خطوط در نمودار تنظیم می کند.
setDataSourceUrl(url)	PieChartBuilder	URL منبع داده را تنظیم می کند که برای وارد کردن داده ها از یک منبع خارجی مانند Google Sheets استفاده می شود.
setDataTable(tableBuilder)	PieChartBuilder	جدول داده را برای استفاده برای نمودار با استفاده از DataTableBuilder تنظیم می کند.
setDataTable(table)	PieChartBuilder	جدول داده ای را که شامل خطوط نمودار و همچنین برچسب های محور X است را تنظیم می کند.
setDataViewDefinition(dataViewDefinition)	PieChartBuilder	تعریف نمای داده را برای استفاده برای نمودار تنظیم می کند.
setDimensions(width, height)	PieChartBuilder	ابعاد نمودار را تعیین می کند.
setLegendPosition(position)	PieChartBuilder	موقعیت افسانه را با توجه به نمودار تنظیم می کند.
setLegendTextStyle(textStyle)	PieChartBuilder	سبک متن افسانه نمودار را تنظیم می کند.
setOption(option, value)	PieChartBuilder	گزینه های پیشرفته را برای این نمودار تنظیم می کند.
setTitle(chartTitle)	PieChartBuilder	عنوان نمودار را تعیین می کند.
setTitleTextStyle(textStyle)	PieChartBuilder	سبک متن عنوان نمودار را تنظیم می کند.

مستندات دقیق

build()

نمودار را می سازد.

بازگشت

Chart - یک شی نمودار، که می تواند در اسناد، عناصر رابط کاربری جاسازی شود یا به عنوان یک تصویر ثابت استفاده شود.

---

reverseCategories()

رسم سری ها را در محور دامنه معکوس می کند. برای نمودارهای با برد عمودی (مانند نمودارهای خط، ناحیه یا ستون)، این بدان معناست که محور افقی از راست به چپ ترسیم شده است. برای نمودارهای با دامنه افقی (مانند نمودارهای میله ای)، این بدان معنی است که محور عمودی از بالا به پایین ترسیم می شود. برای نمودار دایره ای، این بدان معناست که برش ها در خلاف جهت عقربه های ساعت کشیده می شوند.

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

بازگشت

PieChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.

---

set3D()

نمودار را سه بعدی تنظیم می کند.

بازگشت

PieChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.

---

setBackgroundColor(cssValue)

رنگ پس زمینه نمودار را تنظیم می کند.

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

پارامترها

نام	تایپ کنید	توضیحات
cssValue	String	مقدار CSS برای رنگ (مانند "blue" یا "#00f" ).

بازگشت

PieChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.

---

setColors(cssValues)

رنگ ها را برای خطوط در نمودار تنظیم می کند.

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

پارامترها

نام	تایپ کنید	توضیحات
cssValues	String[]	آرایه ای از مقادیر رنگی CSS، مانند ["red", "#acf"] . عنصر n در آرایه نشان دهنده رنگ خط n ام در نمودار است.

بازگشت

PieChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.

---

setDataSourceUrl(url)

URL منبع داده را تنظیم می کند که برای وارد کردن داده ها از یک منبع خارجی مانند Google Sheets استفاده می شود. اگر یک URL منبع داده و یک DataTable ارائه شود، URL منبع داده نادیده گرفته می شود.

برای اطلاعات بیشتر در مورد جستجوی منابع داده، اسناد Google Charts را بررسی کنید.

پارامترها

نام	تایپ کنید	توضیحات
url	String	نشانی وب منبع داده، از جمله هر پارامتر پرس و جو.

بازگشت

PieChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.

---

setDataTable(tableBuilder)

جدول داده را برای استفاده برای نمودار با استفاده از DataTableBuilder تنظیم می کند. این یک روش راحت برای تنظیم جدول داده ها بدون نیاز به فراخوانی build() است.

پارامترها

نام	تایپ کنید	توضیحات
tableBuilder	DataTableBuilder	سازنده جدول داده ها یک جدول داده جدید فوراً به عنوان بخشی از این تماس ایجاد می‌شود، بنابراین هرگونه به‌روزرسانی بیشتر برای سازنده در نمودار منعکس نمی‌شود.

بازگشت

PieChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.

---

setDataTable(table)

جدول داده ای را که شامل خطوط نمودار و همچنین برچسب های محور X است را تنظیم می کند. ستون اول باید یک رشته باشد و حاوی برچسب های محور افقی باشد. هر تعداد ستون می تواند دنبال شود، همه باید عددی باشند. هر ستون به صورت یک خط جداگانه نمایش داده می شود.

پارامترها

نام	تایپ کنید	توضیحات
table	DataTableSource	جدول داده برای استفاده برای نمودار.

بازگشت

PieChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.

---

setDataViewDefinition(dataViewDefinition)

تعریف نمای داده را برای استفاده برای نمودار تنظیم می کند.

پارامترها

نام	تایپ کنید	توضیحات
dataViewDefinition	DataViewDefinition	یک شی تعریف نمای داده که نمایه ای را که باید از منبع داده داده شده برای ترسیم نمودار مشتق شود، تعریف می کند.

بازگشت

PieChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.

---

setDimensions(width, height)

ابعاد نمودار را تعیین می کند.

پارامترها

نام	تایپ کنید	توضیحات
width	Integer	عرض نمودار، بر حسب پیکسل.
height	Integer	ارتفاع نمودار، بر حسب پیکسل.

بازگشت

PieChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.

---

setLegendPosition(position)

موقعیت افسانه را با توجه به نمودار تنظیم می کند. به طور پیش فرض، هیچ افسانه ای وجود ندارد.

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

پارامترها

نام	تایپ کنید	توضیحات
position	Position	موقعیت افسانه.

بازگشت

PieChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.

---

setLegendTextStyle(textStyle)

سبک متن افسانه نمودار را تنظیم می کند.

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

پارامترها

نام	تایپ کنید	توضیحات
textStyle	TextStyle	سبک متن برای استفاده برای افسانه نمودار.

بازگشت

PieChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.

---

setOption(option, value)

گزینه های پیشرفته را برای این نمودار تنظیم می کند. گزینه های موجود برای این نمودار را ببینید. اگر گزینه داده شده نامعتبر باشد، این روش تاثیری ندارد.

// Build a pie chart with a pretty legend.
var builder = Charts.newPieChart();
builder.setOption('legend', {textStyle: {color: 'blue', fontSize: 16}});
var chart = builder.build();

پارامترها

نام	تایپ کنید	توضیحات
option	String	گزینه تنظیم.
value	Object	مقدار برای تنظیم

بازگشت

PieChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.

---

setTitle(chartTitle)

عنوان نمودار را تعیین می کند. عنوان در مرکز بالای نمودار نمایش داده می شود.

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

پارامترها

نام	تایپ کنید	توضیحات
chartTitle	String	عنوان نمودار

بازگشت

PieChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.

---

setTitleTextStyle(textStyle)

سبک متن عنوان نمودار را تنظیم می کند.

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

پارامترها

نام	تایپ کنید	توضیحات
textStyle	TextStyle	سبک متنی که برای عنوان نمودار استفاده می شود. می توانید با فراخوانی Charts.newTextStyle() یک شی TextStyleBuilder ایجاد کنید.

بازگشت

PieChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.