Cette page a été traduite par l'API Cloud Translation.

Class DataTableBuilder

Compilateur d'objets DataTable. La création d'une table de données consiste à spécifier d'abord ses colonnes, puis puis en ajoutant ses lignes, une par une. Exemple :

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

Méthodes

Méthode	Type renvoyé	Brève description
`addColumn(type, label)`	`DataTableBuilder`	Ajoute une colonne à la table de données.
`addRow(values)`	`DataTableBuilder`	Ajoute une ligne à la table de données.
`build()`	`DataTable`	Crée et affiche une table de données.
`setValue(row, column, value)`	`DataTableBuilder`	Définit une valeur spécifique du tableau.

Documentation détaillée

`addColumn(type, label)`

Ajoute une colonne à la table de données. Les colonnes seront ajoutées de 0 à n.

La première colonne est souvent utilisée dans les graphiques pour les étiquettes (par exemple, les étiquettes de l'axe X sur des lignes graphiques ou libellés de secteurs dans les graphiques à secteurs). Les autres colonnes sont souvent utilisées pour les données. nécessitent souvent des valeurs numériques.

Paramètres

Nom	Type	Description
`type`	`ColumnType`	le type de données de la colonne (nombre, chaîne ou date) ;
`label`	`String`	étiquette de la colonne (il est utilisé pour les légendes des graphiques).

Renvois

DataTableBuilder : compilateur pour le chaînage.

`addRow(values)`

Ajoute une ligne à la table de données.

Paramètres

Nom	Type	Description
`values`	`Object[]`	de la ligne, spécifiées dans l'ordre dans lequel les colonnes sont saisies.

Renvois

DataTableBuilder : compilateur pour le chaînage.

`build()`

Crée et affiche une table de données.

Renvois

DataTable : table de données

Génère

Error : si la table de données est vide ou n'est pas rédigée correctement

`setValue(row, column, value)`

Définit une valeur spécifique du tableau.

Vous pouvez définir une valeur avant d'ajouter la colonne à la table de données. Toutefois, à moins que la colonne est ajoutée à un moment donné, la valeur est ignorée.

Il n'est pas nécessaire de renseigner toutes les valeurs des colonnes. Les éléments manquants seront considérés comme null.

Paramètres

Nom	Type	Description
`row`	`Integer`	l'index de ligne (la première ligne a l'index 0) ;
`column`	`Integer`	l'index de la colonne (la première colonne a l'index 0) ;
`value`	`Object`	la valeur de la cellule du tableau (elle doit présenter le type de colonne approprié).

Renvois

DataTableBuilder : compilateur, pour le chaînage