דף זה תורגם על ידי Cloud Translation API.

Class DataTableBuilder

Builder של אובייקטים ב-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 – ה-builder הזה, ליצירת שרשורים.

`addRow(values)`

הוספה של שורה לטבלת הנתונים.

פרמטרים

שם	סוג	תיאור
`values`	`Object[]`	עבור השורה, מצוינים באותו סדר שבו הוזנו העמודות.

חזרה

DataTableBuilder – ה-builder הזה, ליצירת שרשורים.

`build()`

יוצרת ומחזירה טבלת נתונים.

חזרה

DataTable – טבלת הנתונים

קליעות

Error – אם טבלת הנתונים ריקה או שהפורמט שלה שגוי

`setValue(row, column, value)`

מגדיר ערך ספציפי בטבלה.

אפשר להגדיר ערך לפני שמוסיפים את העמודה לטבלת הנתונים. עם זאת, אלא אם העמודה יתווסף בשלב כלשהו, המערכת תתעלם מהערך.

לא צריך למלא את כל הערכים בעמודות. מוצרים חסרים ייחשבו כ-null.

פרמטרים

שם	סוג	תיאור
`row`	`Integer`	אינדקס השורה (בשורה הראשונה יש אינדקס 0)
`column`	`Integer`	אינדקס העמודות (בעמודה הראשונה מופיע אינדקס 0)
`value`	`Object`	הערך של התא בטבלה (הסוג צריך להיות תקין לעמודה).

חזרה

DataTableBuilder – ה-builder הזה, ליצירת שרשורים