Partager via


Type de ressource workbookRange

Espace de noms: microsoft.graph

Représente un ensemble d’une ou plusieurs cellules contiguës dans un classeur, comme une cellule, une ligne, une colonne ou un bloc de cellules.

Méthodes

Méthode Type renvoyé Description
Obtenir workbookRange Lire les propriétés et les relations d’un objet de plage.
Mettre à jour workbookRange Mettre à jour un objet de plage.
Supprimer Aucun Supprimez les cellules associées à la plage.
Effacer Aucun Effacez les valeurs de plage, le format, le remplissage ou la bordure.
Get boundingrect workbookRange Obtient 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 ».
Obtenir une cellule workbookRange Obtient l’objet de plage contenant la cellule unique en fonction des numéros de ligne et de colonne. La cellule peut se trouver en dehors des limites de sa plage parente, tant qu’elle reste dans la grille de feuille de calcul. L’emplacement de la cellule renvoyée est déterminé à partir de la cellule supérieure gauche de la plage.
Obtenir la colonne workbookRange Obtient une colonne contenue dans la plage.
Obtenir des colonnes après workbookRangeView Obtenez des colonnes à droite de la plage donnée.
Obtenir des colonnes avant workbookRangeView Obtenez des colonnes à gauche de la plage donnée.
Obtenir la colonne entière workbookRange Obtient un objet qui représente la colonne entière de la plage.
Obtenir la ligne entière workbookRange Obtient un objet qui représente la ligne entière de la plage.
Obtenir l’intersection workbookRange Obtient l’objet de plage qui représente l’intersection rectangulaire des plages données.
Obtenir la dernière cellule workbookRange Obtenez la dernière cellule dans la plage. Par exemple, la dernière cellule de la plage « B2:D5 » est « D5 ».
Obtenir la dernière colonne workbookRange Obtenez la dernière colonne de la plage. Par exemple, la dernière colonne de la plage « B2:D5 » est « D2:D5 ».
Obtenir la dernière ligne workbookRange Obtient la dernière ligne de la plage. Par exemple, la dernière ligne de la plage « B2:D5 » est « B5:D5 ».
Obtenir la plage de décalages workbookRange 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.
Obtenir une plage redimensionnée workbookRangeView Obtenez un objet de plage similaire à l’objet de plage actuel, mais avec son coin inférieur droit développé (ou contracté) par un certain nombre de lignes et de colonnes.
Obtenir une ligne workbookRange Obtenir une ligne contenue dans la plage.
Obtenir les lignes au-dessus workbookRangeView Obtenez des lignes au-dessus d’une plage donnée.
Obtenir les lignes ci-dessous workbookRangeView Obtenez des lignes sous une plage donnée.
Obtenir une plage utilisée workbookRange Retourne la plage utilisée de l’objet de plage donné.
Obtenir une vue visible workbookRangeView Obtient la plage visible à partir d’une plage filtrée.
Insérer la plage workbookRange Insérez une cellule ou une plage de cellules dans la feuille de calcul à la place de cette plage, puis déplacez les autres cellules pour faire 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.
Annuler la fusion Aucun Annule la fusion de la plage de cellules.

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 Valeur booléenne Indique si toutes les colonnes de la plage actuelle 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 Valeur booléenne Indique si toutes les lignes de la plage actuelle 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 retournées peuvent être de type chaîne, nombre ou booléen. 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"
}