Excel.Interfaces.RangeLoadOptions interface
La plage représente un ensemble d’une ou plusieurs cellules contiguës telles qu’une cellule, une ligne, une colonne ou un bloc de cellules. Pour en savoir plus sur la façon dont les plages sont utilisées dans l’API, commencez par Plages dans l’API JavaScript d’Excel.
Propriétés
| $all | La spécification |
| address | Spécifie la référence de plage dans le style A1. La valeur Address contient la référence de feuille (par exemple, « Feuil1 ! 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 |
Indique si toutes les colonnes de la plage actuelle sont masquées.
|
| column |
Spécifie le numéro de colonne de la première cellule de la plage. Avec indice zéro. |
| data |
Renvoie un objet de validation des données. |
| format | Renvoie un objet de mise en forme qui encapsule 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 renvoyé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 renvoyé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 renvoyée à la place. |
| hidden | Indique si toutes les cellules de la plage actuelle sont masquées. Valeur lorsque |
| hyperlink | Représente le lien hypertexte de la plage active. |
| is |
Représente si la plage active est une colonne entière. |
| is |
Représente si la plage active est une ligne entière. |
| number |
Représente le code de format de nombre d’Excel pour une plage donnée. Pour plus d’informations sur la mise en forme des nombres dans Excel, voir Codes de format de nombre. |
| number |
Représente le code de format de nombre d’Excel pour une plage donnée, en fonction des paramètres de langue de l’utilisateur. Excel n’effectue aucune coercition de langage ou de format lors de l’obtention ou de la définition de la |
| row |
Renvoie le nombre total de lignes de la plage. |
| row |
Indique si toutes les lignes de la plage actuelle sont masquées. Valeur lorsque |
| row |
Renvoie le numéro de ligne de la première cellule de la plage. Avec indice zéro. |
| style | Représente le style de la plage actuelle. Si les styles des cellules sont incohérents, |
| 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 dièse (#) 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 renvoyé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 renvoyée commence par un plus (« + »), moins (« - ») ou un signe égal (« = »), Excel interprète cette valeur comme une formule. Les chaînes en forme de paramètres régionaux (telles que la date « 19-8-2025 » en nl-NL ou fr-FR, format DD-MM-YYYY) sont stockées en tant que texte et non en tant que dates. Pour vous assurer que les dates sont stockées en tant que dates, utilisez une API adaptée aux paramètres régionaux, comme |
| value |
Spécifie le type de données dans chaque cellule. |
| worksheet | Feuille de calcul contenant la plage. |
Détails de la propriété
$all
La spécification $all des options de chargement charge toutes les propriétés scalaires (telles que Range.address) mais pas les propriétés de navigation (telles que Range.format.fill.color).
$all?: boolean;Valeur de propriété
boolean
address
Spécifie la référence de plage dans le style A1. La valeur Address contient la référence de feuille (par exemple, « Feuil1 ! A1 :B4").
address?: boolean;Valeur de propriété
boolean
Remarques
addressLocal
Représente la référence de plage pour la plage spécifiée dans la langue de l’utilisateur.
addressLocal?: boolean;Valeur de propriété
boolean
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?: boolean;Valeur de propriété
boolean
Remarques
columnCount
Spécifie le nombre total de colonnes dans la plage.
columnCount?: boolean;Valeur de propriété
boolean
Remarques
columnHidden
Indique si toutes les colonnes de la plage actuelle sont masquées.
true Valeur lorsque toutes les colonnes d’une plage sont masquées. Valeur lorsque false aucune colonne de la plage n’est masquée.
null Valeur 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?: boolean;Valeur de propriété
boolean
Remarques
dataValidation
Renvoie un objet de validation des données.
dataValidation?: Excel.Interfaces.DataValidationLoadOptions;Valeur de propriété
Remarques
format
Renvoie un objet de mise en forme qui encapsule la police, le remplissage, les bordures, l’alignement et d’autres propriétés de la plage.
format?: Excel.Interfaces.RangeFormatLoadOptions;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 renvoyée à la place.
formulas?: boolean;Valeur de propriété
boolean
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 renvoyée à la place.
formulasLocal?: boolean;Valeur de propriété
boolean
Remarques
formulasR1C1
Représente la formule dans le style de notation R1C1. Si une cellule n’a pas de formule, sa valeur est renvoyée à la place.
formulasR1C1?: boolean;Valeur de propriété
boolean
Remarques
hidden
Indique si toutes les cellules de la plage actuelle sont masquées. Valeur lorsque true toutes les cellules d’une plage sont masquées. Valeur lorsque false aucune cellule de la plage n’est masquée.
null Valeur 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
hyperlink
Représente le lien hypertexte de la plage active.
hyperlink?: boolean;Valeur de propriété
boolean
Remarques
isEntireColumn
Représente si la plage active est une colonne entière.
isEntireColumn?: boolean;Valeur de propriété
boolean
Remarques
isEntireRow
Représente si la plage active est une ligne entière.
isEntireRow?: boolean;Valeur de propriété
boolean
Remarques
numberFormat
Représente le code de format de nombre d’Excel pour une plage donnée. Pour plus d’informations sur la mise en forme des nombres dans Excel, voir Codes de format de nombre.
numberFormat?: boolean;Valeur de propriété
boolean
Remarques
numberFormatLocal
Représente le code de format de nombre d’Excel pour une plage donnée, en fonction des paramètres de langue de l’utilisateur. Excel n’effectue aucune coercition de langage ou de format lors de l’obtention ou de la définition de la numberFormatLocal propriété. Tout texte renvoyé utilise les chaînes mises en forme localement en fonction de la langue spécifiée dans les paramètres système.
numberFormatLocal?: boolean;Valeur de propriété
boolean
Remarques
rowCount
Renvoie le nombre total de lignes de la plage.
rowCount?: boolean;Valeur de propriété
boolean
Remarques
rowHidden
Indique si toutes les lignes de la plage actuelle sont masquées. Valeur lorsque true toutes les lignes d’une plage sont masquées.
false Valeur lorsque aucune ligne de la plage n’est masquée.
null Valeur 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?: boolean;Valeur de propriété
boolean
Remarques
style
Représente le style de la plage actuelle. Si les styles des cellules sont incohérents, null est renvoyée. Pour les styles personnalisés, le nom du style est renvoyé. Pour les styles intégrés, une chaîne représentant une valeur dans l’énumération BuiltInStyle est renvoyée.
style?: boolean;Valeur de propriété
boolean
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 dièse (#) qui se produit dans l’interface utilisateur Excel n’affecte pas la valeur de texte retournée par l’API.
text?: boolean;Valeur de propriété
boolean
Remarques
values
Représente les valeurs brutes de la plage spécifiée. Les données renvoyé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 renvoyée commence par un plus (« + »), moins (« - ») ou un signe égal (« = »), Excel interprète cette valeur comme une formule. Les chaînes en forme de paramètres régionaux (telles que la date « 19-8-2025 » en nl-NL ou fr-FR, format DD-MM-YYYY) sont stockées en tant que texte et non en tant que dates. Pour vous assurer que les dates sont stockées en tant que dates, utilisez une API adaptée aux paramètres régionaux, comme formulasLocal ou un format indépendant des paramètres régionaux, comme ISO (AAAA-MM-JJ) ou une date numérique de série.
values?: boolean;Valeur de propriété
boolean
Remarques
valueTypes
Spécifie le type de données dans chaque cellule.
valueTypes?: boolean;Valeur de propriété
boolean
Remarques
worksheet
Feuille de calcul contenant la plage.
worksheet?: Excel.Interfaces.WorksheetLoadOptions;