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 — هذا المُنشئ، لتسلسل العناصر