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

Class PieChartBuilder

أداة إنشاء الرسوم البيانية الدائرية لمزيد من التفاصيل، يُرجى الاطّلاع على مستندات "رسومات Google".

في ما يلي مثال يوضّح كيفية إنشاء مخطّط دائري. تم استيراد البيانات من جدول بيانات Google.

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

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

const chart = chartBuilder.build();

الطُرق

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
`build()`	`Chart`	إنشاء الرسم البياني
`reverseCategories()`	`PieChartBuilder`	يعكس رسم السلاسل في محور النطاق.
`set3D()`	`PieChartBuilder`	ضبط الرسم البياني ليكون ثلاثي الأبعاد
`setBackgroundColor(cssValue)`	`PieChartBuilder`	لضبط لون خلفية الرسم البياني.
`setColors(cssValues)`	`PieChartBuilder`	تُستخدَم لضبط ألوان الخطوط في الرسم البياني.
`setDataSourceUrl(url)`	`PieChartBuilder`	لضبط عنوان URL لمصدر البيانات المستخدَم لسحب البيانات من مصدر خارجي، مثل "جداول بيانات 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.
const builder = Charts.newPieChart();
builder.reverseCategories();

الإرجاع

‫PieChartBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.

`set3D()`

ضبط الرسم البياني ليكون ثلاثي الأبعاد

الإرجاع

‫PieChartBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.

`setBackgroundColor(cssValue)`

لضبط لون خلفية الرسم البياني.

// Creates a line chart builder and sets the background color to gray
const 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.
const builder = Charts.newLineChart();
builder.setColors(['green', 'red']);

المعلمات

الاسم	النوع	الوصف
`cssValues`	`String[]`	صفيف من قيم CSS للألوان، مثل `["red", "#acf"]` يمثّل العنصر n في الصفيف لون الخط n في الرسم البياني.

الإرجاع

‫PieChartBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.

`setDataSourceUrl(url)`

لضبط عنوان URL لمصدر البيانات المستخدَم لسحب البيانات من مصدر خارجي، مثل "جداول بيانات 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.
const 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.
const textStyleBuilder =
    Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
const style = textStyleBuilder.build();
const builder = Charts.newLineChart();
builder.setLegendTextStyle(style);

المعلمات

الاسم	النوع	الوصف
`textStyle`	`TextStyle`	نمط النص المُستخدَم لشرح الرسم البياني.

الإرجاع

‫PieChartBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.

`setOption(option, value)`

لضبط الخيارات المتقدّمة لهذا الرسم البياني اطّلِع على الخيارات المتاحة لهذا الرسم البياني. لن يكون لهذه الطريقة أي تأثير إذا كان الخيار المحدَّد غير صالح.

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

المعلمات

الاسم	النوع	الوصف
`option`	`String`	خيار الضبط
`value`	`Object`	القيمة المطلوب ضبطها

الإرجاع

‫PieChartBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.

`setTitle(chartTitle)`

لضبط عنوان الرسم البياني. يتم عرض العنوان في منتصف أعلى الرسم البياني.

// Creates a line chart builder and title to 'My Line Chart'.
const 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.
const textStyleBuilder =
    Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
const style = textStyleBuilder.build();
const builder = Charts.newLineChart();
builder.setTitleTextStyle(style);

المعلمات

الاسم	النوع	الوصف
`textStyle`	`TextStyle`	نمط النص المُستخدَم لعنوان الرسم البياني. يمكنك إنشاء عنصر `TextStyleBuilder` من خلال استدعاء `Charts.newTextStyle()`.

الإرجاع

‫PieChartBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.