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

Class DataTableBuilder

أداة إنشاء كائنات DataTable يتكون إنشاء جدول بيانات من تحديد أعمدةه أولاً، ثم إضافة صفوفه واحدًا تلو الآخر. مثال:

const data = Charts.newDataTable()
                 .addColumn(Charts.ColumnType.STRING, 'Month')
                 .addColumn(Charts.ColumnType.NUMBER, 'In Store')
                 .addColumn(Charts.ColumnType.NUMBER, 'Online')
                 .addRow(['January', 10, 1])
                 .addRow(['February', 12, 1])
                 .addRow(['March', 20, 2])
                 .addRow(['April', 25, 3])
                 .addRow(['May', 30, 4])
                 .build();

الطُرق

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
`addColumn(type, label)`	`DataTableBuilder`	تُضيف هذه الدالة عمودًا إلى جدول البيانات.
`addRow(values)`	`DataTableBuilder`	تُضيف صفًا إلى جدول البيانات.
`build()`	`DataTable`	تُنشئ جدول بيانات وتُعرِضه.
`setValue(row, column, value)`	`DataTableBuilder`	لضبط قيمة معيّنة في الجدول

مستندات تفصيلية

`addColumn(type, label)`

تُضيف هذه الدالة عمودًا إلى جدول البيانات. ستتم إضافة الأعمدة من 0 إلى n.

غالبًا ما تستخدم الرسوم البيانية العمود الأول لتصنيف البيانات (على سبيل المثال، تصنيفات محور X في الرسوم البيانية الخطية أو تصنيفات الشرائح في الرسوم البيانية الدائرية). غالبًا ما تُستخدَم الأعمدة الأخرى للبيانات، وبالتالي تحتاج عادةً إلى قيم رقمية.

المعلمات

الاسم	النوع	الوصف
`type`	`ColumnType`	نوع البيانات في العمود (رقم أو سلسلة أو تاريخ)
`label`	`String`	تصنيف العمود (يُستخدَم في ترجمة وشرح الرسم البياني).

الإرجاع

DataTableBuilder: أداة الإنشاء هذه لإنشاء سلسلة.

`addRow(values)`

تُضيف صفًا إلى جدول البيانات.

المعلمات

الاسم	النوع	الوصف
`values`	`Object[]`	قيم الصف المحدّدة بالترتيب نفسه الذي يتم إدخال الأعمدة به

الإرجاع

DataTableBuilder: أداة الإنشاء هذه لإنشاء سلسلة.

`build()`

تُنشئ جدول بيانات وتُعرِضه.

الإرجاع

DataTable - جدول البيانات

عمليات الرمي

Error - إذا كان جدول البيانات فارغًا أو غير صالح

`setValue(row, column, value)`

لضبط قيمة معيّنة في الجدول

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

لا يلزم ملء جميع قيم الأعمدة. وسيتم اعتبار العناصر غير المتوفّرة null.

المعلمات

الاسم	النوع	الوصف
`row`	`Integer`	فهرس الصف (يحمل الصف الأول الفهرس 0)
`column`	`Integer`	فهرس العمود (يحمل العمود الأول الفهرس 0)
`value`	`Object`	قيمة خلية الجدول (يجب أن يكون لها النوع الصحيح للعمود)

الإرجاع

DataTableBuilder — هذا المُنشئ، لتسلسل العناصر