type de ressource workbookRange

Espace de noms: microsoft.graph

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

Représente un ensemble d’une ou plusieurs cellules contiguës d’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 Mettez à jour un objet de plage.
Supprimer Aucun Supprimez les cellules associées à la plage.
Effacer Aucun Effacer les valeurs de plage, la mise en forme, le remplissage ou la bordure.
Obtenir boundingrect workbookRange Obtenir 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 Obtenir 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 la 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 Obtenir une colonne contenue dans la plage.
Obtenir les colonnes après workbookRangeView Placer des colonnes à droite de la plage donnée.
Obtenir les colonnes avant workbookRangeView Placer des colonnes à gauche de la plage donnée.
Obtenir la colonne entière workbookRange Obtenir un objet qui représente la colonne entière de la plage.
Obtenir la ligne entière workbookRange Obtenir un objet qui représente la ligne entière de la plage.
Obtenir une intersection workbookRange Obtenir l’objet range qui représente l’intersection rectangulaire des plages données.
Obtenir la dernière cellule workbookRange Obtenir la dernière cellule de la plage. Par exemple, la dernière cellule de la plage « B2:D5 » est « D5 ».
Obtenir la dernière colonne workbookRange Obtenir 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écalage workbookRange Obtenez un objet qui représente une plage décalée par rapport à la plage spécifiée. La dimension de la plage renvoyé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 la plage redimensionnée workbookRangeView Obtenir un objet de plage similaire à l’objet de plage actuel, mais avec son coin inférieur droit développé (ou réduit) d’un certain nombre de lignes et de colonnes.
Obtenir la ligne workbookRange Obtenir une ligne contenue dans la plage.
Obtenir les lignes au-dessus workbookRangeView Obtenir des lignes au-dessus d’une plage donnée.
Obtenir les lignes ci-dessous workbookRangeView Obtenir des lignes en dessous d’une plage donnée.
Obtenir une plage utilisée workbookRange Retourner 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é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.
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 Address (La valeur Address contient la référence de la feuille (par exemple, Feuil1 ! 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 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 Booléen 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 du texte ne dépend pas de la largeur de la cellule. La substitution du 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 string 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 de type chaîne, numérique ou booléen. La cellule qui contient une erreur renvoie la chaîne d’erreur.

Relations

Relation Type Description
format WorkbookRangeFormat 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. 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.

{
  "id": "string",
  "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"
}
  • Last updated on