Class PieChartBuilder

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: أداة إنشاء مفيدة للتسلسل