Excel.Interfaces.RangeData interface
Interface décrivant les données retournées en appelant range.toJSON()
.
Propriétés
address | Spécifie la référence de plage dans le style A1. La valeur d’adresse contient la référence de la feuille (par exemple, « Sheet1 ! A1 :B4"). |
address |
Représente la référence de plage pour la plage spécifiée dans la langue de l’utilisateur. |
cell |
Spécifie le nombre de cellules dans la plage. Cette API renvoie -1 si le nombre de cellules est supérieur à 2^31-1 (2 147 483 647). |
column |
Spécifie le nombre total de colonnes dans la plage. |
column |
Représente si toutes les colonnes de la plage actuelle sont masquées. La valeur est |
column |
Spécifie le numéro de colonne de la première cellule de la plage. Avec indice zéro. |
format | Renvoie un objet de format, encapsulant la police, le remplissage, les bordures, l’alignement et d’autres propriétés de la plage. |
formulas | Représente la formule dans le style de notation A1. Si une cellule n’a pas de formule, sa valeur est retournée à la place. |
formulas |
Représente la formule en notation A1, en utilisant le langage et les paramètres de format de nombre régionaux de l’utilisateur. Par exemple, la formule « =SUM(A1, 1.5) » en anglais deviendrait « =SUMME(A1; 1,5) » en allemand. Si une cellule n’a pas de formule, sa valeur est retournée à la place. |
formulasR1C1 | Représente la formule dans le style de notation R1C1. Si une cellule n’a pas de formule, sa valeur est retournée à la place. |
hidden | Représente si toutes les cellules de la plage actuelle sont masquées. La valeur est |
number |
Représente le code de format numérique d’Excel pour la plage donnée. Pour plus d’informations sur la mise en forme des nombres Excel, consultez Codes de format de nombre. |
row |
Renvoie le nombre total de lignes de la plage. |
row |
Représente si toutes les lignes de la plage actuelle sont masquées. La valeur est |
row |
Renvoie le numéro de ligne de la première cellule de la plage. Avec indice zéro. |
text | Valeurs de texte de la plage spécifiée. La valeur de texte ne dépend pas de la largeur de la cellule. La substitution de signe numérique (#) qui se produit dans l’interface utilisateur Excel n’affecte pas la valeur de texte retournée par l’API. |
values | Représente les valeurs brutes de la plage spécifiée. Les données retournées peuvent être une chaîne, un nombre ou une valeur booléenne. Les cellules contenant une erreur renvoie la chaîne d’erreur. Si la valeur retournée commence par un signe plus (« + »), moins (« - ») ou égal (« = »), Excel interprète cette valeur comme une formule. |
value |
Spécifie le type de données dans chaque cellule. |
Détails de la propriété
address
Spécifie la référence de plage dans le style A1. La valeur d’adresse contient la référence de la feuille (par exemple, « Sheet1 ! A1 :B4").
address?: string;
Valeur de propriété
string
Remarques
addressLocal
Représente la référence de plage pour la plage spécifiée dans la langue de l’utilisateur.
addressLocal?: string;
Valeur de propriété
string
Remarques
cellCount
Spécifie le nombre de cellules dans la plage. Cette API renvoie -1 si le nombre de cellules est supérieur à 2^31-1 (2 147 483 647).
cellCount?: number;
Valeur de propriété
number
Remarques
columnCount
Spécifie le nombre total de colonnes dans la plage.
columnCount?: number;
Valeur de propriété
number
Remarques
columnHidden
Représente si toutes les colonnes de la plage actuelle sont masquées. La valeur est true
lorsque toutes les colonnes d’une plage sont masquées. La valeur est quand aucune colonne de la plage n’est false
masquée. La valeur est null
lorsque certaines colonnes d’une plage sont masquées et que d’autres colonnes de la même plage ne sont pas masquées.
columnHidden?: boolean;
Valeur de propriété
boolean
Remarques
columnIndex
Spécifie le numéro de colonne de la première cellule de la plage. Avec indice zéro.
columnIndex?: number;
Valeur de propriété
number
Remarques
format
Renvoie un objet de format, encapsulant la police, le remplissage, les bordures, l’alignement et d’autres propriétés de la plage.
format?: Excel.Interfaces.RangeFormatData;
Valeur de propriété
Remarques
formulas
Représente la formule dans le style de notation A1. Si une cellule n’a pas de formule, sa valeur est retournée à la place.
formulas?: any[][];
Valeur de propriété
any[][]
Remarques
formulasLocal
Représente la formule en notation A1, en utilisant le langage et les paramètres de format de nombre régionaux de l’utilisateur. Par exemple, la formule « =SUM(A1, 1.5) » en anglais deviendrait « =SUMME(A1; 1,5) » en allemand. Si une cellule n’a pas de formule, sa valeur est retournée à la place.
formulasLocal?: any[][];
Valeur de propriété
any[][]
Remarques
formulasR1C1
Représente la formule dans le style de notation R1C1. Si une cellule n’a pas de formule, sa valeur est retournée à la place.
formulasR1C1?: any[][];
Valeur de propriété
any[][]
Remarques
hidden
Représente si toutes les cellules de la plage actuelle sont masquées. La valeur est true
lorsque toutes les cellules d’une plage sont masquées. La valeur est quand aucune cellule de la plage n’est false
masquée. La valeur est null
lorsque certaines cellules d’une plage sont masquées et que d’autres cellules de la même plage ne sont pas masquées.
hidden?: boolean;
Valeur de propriété
boolean
Remarques
numberFormat
Représente le code de format numérique d’Excel pour la plage donnée. Pour plus d’informations sur la mise en forme des nombres Excel, consultez Codes de format de nombre.
numberFormat?: any[][];
Valeur de propriété
any[][]
Remarques
rowCount
Renvoie le nombre total de lignes de la plage.
rowCount?: number;
Valeur de propriété
number
Remarques
rowHidden
Représente si toutes les lignes de la plage actuelle sont masquées. La valeur est true
lorsque toutes les lignes d’une plage sont masquées. La valeur est quand aucune ligne de la plage n’est false
masquée. La valeur est null
lorsque certaines lignes d’une plage sont masquées et que d’autres lignes de la même plage ne sont pas masquées.
rowHidden?: boolean;
Valeur de propriété
boolean
Remarques
rowIndex
Renvoie le numéro de ligne de la première cellule de la plage. Avec indice zéro.
rowIndex?: number;
Valeur de propriété
number
Remarques
text
Valeurs de texte de la plage spécifiée. La valeur de texte ne dépend pas de la largeur de la cellule. La substitution de signe numérique (#) qui se produit dans l’interface utilisateur Excel n’affecte pas la valeur de texte retournée par l’API.
text?: string[][];
Valeur de propriété
string[][]
Remarques
values
Représente les valeurs brutes de la plage spécifiée. Les données retournées peuvent être une chaîne, un nombre ou une valeur booléenne. Les cellules contenant une erreur renvoie la chaîne d’erreur. Si la valeur retournée commence par un signe plus (« + »), moins (« - ») ou égal (« = »), Excel interprète cette valeur comme une formule.
values?: any[][];
Valeur de propriété
any[][]
Remarques
valueTypes
Spécifie le type de données dans chaque cellule.
valueTypes?: Excel.RangeValueType[][];