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();

روش‌ها

روش نوع بازگشتی شرح مختصر
add Column(type, label) Data Table Builder یک ستون به جدول داده‌ها اضافه می‌کند.
add Row(values) Data Table Builder یک ردیف به جدول داده‌ها اضافه می‌کند.
build() Data Table یک جدول داده می‌سازد و برمی‌گرداند.
set Value(row, column, value) Data Table Builder یک مقدار خاص را در جدول تنظیم می‌کند.

مستندات دقیق

addColumn(type, label)

یک ستون به جدول داده‌ها اضافه می‌کند. ستون‌ها از ۰ تا n اضافه خواهند شد.

ستون اول اغلب توسط نمودارها برای برچسب‌ها استفاده می‌شود (برای مثال، برچسب‌های محور X در نمودارهای خطی یا برچسب‌های برش در نمودارهای دایره‌ای). ستون‌های دیگر اغلب برای داده‌ها استفاده می‌شوند و بنابراین اغلب به مقادیر عددی نیاز دارند.

پارامترها

نام نوع توضیحات
type Column Type نوع داده در ستون (عدد، رشته یا تاریخ)
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 - این سازنده، برای زنجیره‌سازی