تمت ترجمة هذه الصفحة بواسطة 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.

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

المَعلمات

الاسم	Type	الوصف
`type`	`ColumnType`	نوع البيانات في العمود (رقم أو سلسلة أو تاريخ)
`label`	`String`	تسمية العمود (تُستخدم وسائل الإيضاح للمخطط).

استرجاع الكرة

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

`addRow(values)`

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

المَعلمات

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

استرجاع الكرة

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

`build()`

لإنشاء جدول بيانات وإرجاعه.

استرجاع الكرة

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

الرميات

Error: إذا كان جدول البيانات فارغًا أو مكتوبة بشكلٍ غير صحيح

`setValue(row, column, value)`

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

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

لا يلزم ملء كل قيم الأعمدة. وسيتم اعتبار القيم المفقودة null.

المَعلمات

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

استرجاع الكرة

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