דף זה תורגם על ידי 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 – הכלי הזה ליצירת שרשורים.

`addRow(values)`

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

פרמטרים

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

החזרות

DataTableBuilder – הכלי הזה ליצירת שרשורים.

`build()`

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

החזרות

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

קליעות

Error – אם טבלת הנתונים ריקה או לא תקינה באופן אחר

`setValue(row, column, value)`

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

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

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

פרמטרים

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

החזרות

DataTableBuilder – הכלי הזה ליצירת שרשורים