تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Class 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 Google".
`setDataTable(tableBuilder)`	`PieChartBuilder`	تحدد هذه السمة جدول البيانات لاستخدامه في الرسم البياني باستخدام DataTableBuilder.
`setDataTable(table)`	`PieChartBuilder`	لتعيين جدول البيانات الذي يحتوي على خطوط المخطط، وكذلك تسميات المحور س.
`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 في الصفيفة لون الخط nth في المخطط.

الإرجاع

PieChartBuilder — أداة الإنشاء هذه مفيدة للسلاسل.

`setDataSourceUrl(url)`

لضبط عنوان URL لمصدر البيانات المُستخدَم لسحب البيانات من مصدر خارجي، مثل Google Google". في حال توفير عنوان URL لمصدر بيانات وDataTable، يتم تجاهل عنوان URL لمصدر البيانات.

لمزيد من المعلومات حول طلبات البحث عن مصادر البيانات، يمكنك الاطّلاع على مستندات "مخطّطات Google".

المعلمات

الاسم	النوع	الوصف
`url`	`String`	عنوان URL لمصدر البيانات، بما في ذلك أيّ مَعلمات طلب بحث.

الإرجاع

PieChartBuilder — أداة الإنشاء هذه مفيدة للسلاسل.

`setDataTable(tableBuilder)`

تحدد هذه السمة جدول البيانات لاستخدامه في الرسم البياني باستخدام DataTableBuilder. هذه طريقة ملائمة لإعداد جدول البيانات بدون الحاجة إلى استدعاء build().

المعلمات

الاسم	النوع	الوصف
`tableBuilder`	`DataTableBuilder`	أداة إنشاء جداول البيانات. يتم إنشاء جدول بيانات جديد فورًا كجزء من هذا النموذج لذلك لن تظهر أي تحديثات أخرى يتم إجراؤها على أداة الإنشاء في الرسم البياني.

الإرجاع

PieChartBuilder — أداة الإنشاء هذه مفيدة للسلاسل.

`setDataTable(table)`

لتعيين جدول البيانات الذي يحتوي على خطوط المخطط، وكذلك تسميات المحور س. تشير رسالة الأشكال البيانية يجب أن يكون العمود الأول سلسلة، وأن يحتوي على تسميات المحور الأفقي. أي عدد من الأعمدة يمكن متابعتها، يجب أن تكون جميعها رقمية. يتم عرض كل عمود كخط منفصل.

المعلمات

الاسم	النوع	الوصف
`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`	نمط النص المطلوب استخدامه لعنوان الرسم البياني. يمكنك إنشاء كائن `TextStyleBuilder` من خلال استدعاء `Charts.newTextStyle()`.

الإرجاع

PieChartBuilder — أداة الإنشاء هذه مفيدة للسلاسل.