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 les colonnes correspondantes, puis à ajouter les 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 dans le 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 libellés (par exemple, les libellés de l'axe X sur les graphiques en courbes ou les libellés des secteurs dans les graphiques à secteurs). Les autres colonnes sont souvent utilisées pour les données et nécessitent donc souvent des valeurs numériques.

Paramètres

Nom	Type	Description
`type`	`ColumnType`	Type de données de la colonne (nombre, chaîne ou date)
`label`	`String`	libellé de la colonne (utilisé pour les légendes de graphique).

Renvois

DataTableBuilder : compilateur, pour le chaînage.

`addRow(values)`

Ajoute une ligne à la table de données.

Paramètres

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

Renvois

DataTableBuilder : compilateur, pour le chaînage.

`build()`

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

Renvois

DataTable : tableau de données

Génère

Error : si le tableau de données est vide ou incorrect

`setValue(row, column, value)`

Définit une valeur spécifique dans le tableau.

Vous pouvez définir une valeur avant d'ajouter la colonne au tableau de données. Toutefois, la valeur sera ignorée, sauf si la colonne est ajoutée à un moment donné.

Il n'est pas nécessaire de renseigner toutes les valeurs des colonnes. Ceux qui sont 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 colonne (l'index de la première colonne est 0) ;
`value`	`Object`	la valeur de la cellule du tableau (doit avoir le type approprié pour la colonne).

Renvois

DataTableBuilder : ce compilateur, pour le chaînage