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	مقدار خاصی را در جدول تعیین می کند.

مستندات دقیق

add Column(type, label)

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

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

پارامترها

نام	تایپ کنید	توضیحات
type	Column Type	نوع داده در ستون (عدد، رشته یا تاریخ)
label	String	برچسب ستون (برای افسانه های نمودار استفاده می شود).

بازگشت

Data Table Builder - این سازنده، برای زنجیر کردن.

---

add Row(values)

یک ردیف به جدول داده ها اضافه می کند.

پارامترها

نام	تایپ کنید	توضیحات
values	Object[]	مقادیر برای سطر، به همان ترتیبی که ستون‌ها وارد می‌شوند مشخص شده‌اند.

بازگشت

Data Table Builder - این سازنده، برای زنجیر کردن.

---

build()

جدول داده را می سازد و برمی گرداند.

بازگشت

Data Table - جدول داده ها

پرتاب می کند

Error - اگر جدول داده ها خالی یا بد شکل باشد

---

set Value(row, column, value)

مقدار خاصی را در جدول تعیین می کند.

می توانید قبل از اضافه کردن ستون به جدول داده ها، مقداری را تعیین کنید. با این حال، مگر اینکه ستون در نقطه ای اضافه شود، مقدار نادیده گرفته می شود.

همه مقادیر null نیازی به پر کردن ندارند.

پارامترها

نام	تایپ کنید	توضیحات
row	Integer	شاخص ردیف (ردیف اول دارای شاخص 0 است)
column	Integer	نمایه ستون (ستون اول دارای شاخص 0 است)
value	Object	مقدار سلول جدول (باید نوع مناسب ستون را داشته باشد).

بازگشت

Data Table Builder - این سازنده، برای زنجیر کردن