Class DataTableBuilder

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 : أداة الإنشاء هذه، لتسلسل الطرق