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

Class DataTableBuilder

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

var 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 — أداة الإنشاء هذه، للسلاسل