Type de ressource workbookRange

Espace de noms: microsoft.graph

Une plage représente un ensemble constitué d’une ou de plusieurs cellules contiguës comme une cellule, une ligne, une colonne, un bloc de cellules, etc.

Méthodes

Méthode	Type renvoyé	Description
Obtenir une plage	Plage	Lire les propriétés et les relations de l’objet plage.
Mettre à jour	Plage	Mettre à jour un objet plage.
Boundingrect	Range	Renvoie le plus petit objet de plage qui englobe les plages données. Par exemple, la valeur GetBoundingRect pour « B2:C5 » et « D10:E15 » est « B2:E16 ».
Cellule	Plage	Renvoie l’objet de plage qui contient une cellule donnée sur la base des numéros de ligne et de colonne. La cellule peut se trouver en dehors des limites de ses plages parent, pour peu qu’elle reste dans la grille de la feuille de calcul. L’emplacement de la cellule renvoyée est déterminé à partir de la cellule supérieure gauche de la plage.
Colonne	Plage	Obtient une colonne contenue dans la plage.
Columnsafter	workbookRangeView	Obtient des colonnes à droite de la plage donnée.
Columnsbefore	workbookRangeView	Obtient des colonnes à gauche de la plage donnée.
EntireColumn	Plage	Obtient un objet qui représente la colonne entière de la plage.
EntireRow	Plage	Obtient un objet qui représente la ligne entière de la plage.
Intersection	Plage	Obtient l’objet de plage qui représente l’intersection rectangulaire des plages données.
Lastcell	Range	Obtient la dernière cellule de la plage. Par exemple, la dernière cellule de la plage « B2:D5 » est « D5 ».
Lastcolumn	Range	Obtient la dernière colonne de la plage. Par exemple, la dernière colonne de la plage « B2:D5 » est « D2:D5 ».
LastRow	Range	Obtient la dernière ligne de la plage. Par exemple, la dernière ligne de la plage « B2:D5 » est « B5:D5 ».
Offsetrange	Plage	Obtient un objet qui représente une plage décalée par rapport à la plage spécifiée. La dimension de la plage retournée correspond à cette plage. Si la plage obtenue se retrouve en dehors des limites de la grille de la feuille de calcul, une exception est déclenchée.
Ligne	Plage	Obtient une ligne contenue dans la plage.
Rowsabove	workbookRangeView	Obtient des lignes au-dessus d’une plage donnée.
Rowsbelow	workbookRangeView	Obtient des lignes sous une plage donnée.
UsedRange	Plage	Renvoie la plage utilisée d’un objet de plage donné.
Effacer	Aucun	Supprime les valeurs et les propriétés de format, de remplissage, de bordure, etc. de la plage.
Delete	Aucun	Supprime les cellules associées à la plage.
Insérer	Plage	Insère une cellule ou une plage de cellules dans la feuille de calcul à la place d’une plage donnée et décale les autres cellules pour libérer de l’espace. Renvoie un nouvel objet Range dans l’espace vide qui s’est créé.
Fusionner	Aucun	Fusionne la plage de cellules dans une zone de la feuille de calcul.
Resizedrange	workbookRangeView	Obtient un objet de plage semblable à l’objet de plage actuel, mais avec le coin inférieur droit développé (ou contracté) selon un certain nombre de lignes et de colonnes.
Annuler la fusion	Aucun	Annule la fusion de la plage de cellules.
Visibleview	workbookRangeView	Obtient la plage visible à partir d’une plage filtrée.

Propriétés

Propriété	Type	Description
address	string	Représente la référence de plage dans le style A1. La valeur d’adresse contient la référence de feuille (par exemple, Sheet1 ! A1 :B4). En lecture seule.
addressLocal	string	Représente la référence de la plage spécifiée dans le langage de l’utilisateur. En lecture seule.
cellCount	int	Nombre de cellules dans la plage. En lecture seule.
columnCount	int	Représente le nombre total de colonnes dans la plage. En lecture seule.
columnHidden	booléen	Indique si toutes les colonnes de la plage active sont masquées.
columnIndex	int	Représente le numéro de colonne de la première cellule de la plage. Avec indice zéro. En lecture seule.
formulas	Json	Représente la formule dans le style de notation A1.
formulasLocal	Json	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.
formulasR1C1	Json	Représente la formule dans le style de notation R1C1.
hidden	booléen	Indique si toutes les cellules de la plage active sont masquées. En lecture seule.
numberFormat	Json	Représente le code de format de nombre d’Excel pour une cellule donnée.
rowCount	int	Renvoie le nombre total de lignes de la plage. En lecture seule.
rowHidden	booléen	Indique si toutes les lignes de la plage active sont masquées.
rowIndex	int	Renvoie le numéro de ligne de la première cellule de la plage. Avec indice zéro. En lecture seule.
text	Json	Valeurs de texte de la plage spécifiée. La valeur Text ne dépend pas de la largeur de la cellule. La substitution de signe # qui se produit dans l’interface utilisateur Excel n’affecte pas la valeur de texte retournée par l’API. En lecture seule.
valueTypes	Json	Représente le type de données de chaque cellule. Les valeurs possibles sont Unknown, Empty, String, Integer, Double, Boolean, Error. En lecture seule.
values	Json	Représente les valeurs brutes de la plage spécifiée. Les données renvoyées peuvent être des chaînes, des valeurs numériques ou des valeurs booléennes. La cellule qui contient une erreur retourne la chaîne d’erreur.

Relations

Relation	Type	Description
format	WorkbookRangeFormat	Renvoie un objet de format, encapsulant la police, le remplissage, les bordures, l’alignement et d’autres propriétés de la plage. En lecture seule.
tri	WorkbookRangeSort	Feuille de calcul contenant la plage. En lecture seule.
worksheet	WorkbookWorksheet	Feuille de calcul contenant la plage. En lecture seule.

Représentation JSON

La représentation JSON suivante montre le type de ressource.

{
  "address": "string",
  "addressLocal": "string",
  "cellCount": 1024,
  "columnCount": 1024,
  "columnHidden": true,
  "columnIndex": 1024,
  "formulas": "json",
  "formulasLocal": "json",
  "formulasR1C1": "json",
  "hidden": true,
  "numberFormat": "json",
  "rowCount": 1024,
  "rowHidden": true,
  "rowIndex": 1024,
  "text": "json",
  "valueTypes": "string",
  "values": "json"
}