يشير هذا المصطلح إلى أداة إنشاء كائنات 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()
setValue(row, column, value)
ضبط قيمة معيّنة في الجدول
يمكنك ضبط قيمة قبل إضافة العمود إلى جدول البيانات. ومع ذلك، ما لم تتم إضافة العمود في مرحلة ما، سيتم تجاهل القيمة.
لا يلزم ملء كل قيم الأعمدة. وسيتم اعتبار القيم المفقودة null
.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
row | Integer | فهرس الصف (الصف الأول يحتوي على الفهرس 0) |
column | Integer | فهرس العمود (يحتوي العمود الأول على الفهرس 0) |
value | Object | قيمة خلية الجدول (يجب أن يحتوي على النوع الصحيح للعمود). |
استرجاع الكرة
DataTableBuilder
: أداة إنشاء السلاسل