Type de ressource PlageRange resource type

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.Range represents a set of one or more contiguous cells such as a cell, a row, a column, block of cells, etc.

MéthodesMethods

MéthodeMethod Type renvoyéReturn Type DescriptionDescription
Obtenir une plageGet Range PlageRange Lire les propriétés et les relations de l’objet plage.Read properties and relationships of range object.
Mettre à jourUpdate PlageRange Mettre à jour un objet plage.Update Range object.
BoundingrectBoundingrect RangeRange 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 ».Gets the smallest range object that encompasses the given ranges. For example, the GetBoundingRect of "B2:C5" and "D10:E15" is "B2:E16".
CelluleCell PlageRange 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.Gets the range object containing the single cell based on row and column numbers. The cell can be outside the bounds of its parent range, so long as it's stays within the worksheet grid. The returned cell is located relative to the top left cell of the range.
ColonneColumn PlageRange Obtient une colonne contenue dans la plage.Gets a column contained in the range.
ColumnsafterColumnsafter workbookRangeViewworkbookRangeView collection Obtient un certain nombre de colonnes à droite de la plage donnée.Gets a certain number of columns to the right of the given range.
ColumnsbeforeColumnsbefore workbookRangeViewworkbookRangeView collection Obtient un certain nombre de colonnes à gauche de la plage donnée.Gets a certain number of columns to the left of the given range.
EntireColumnEntirecolumn PlageRange Obtient un objet qui représente la colonne entière de la plage.Gets an object that represents the entire column of the range.
EntireRowEntirerow PlageRange Obtient un objet qui représente la ligne entière de la plage.Gets an object that represents the entire row of the range.
IntersectionIntersection PlageRange Obtient l’objet de plage qui représente l’intersection rectangulaire des plages données.Gets the range object that represents the rectangular intersection of the given ranges.
LastcellLastcell RangeRange Obtient la dernière cellule de la plage. Par exemple, la dernière cellule de la plage « B2:D5 » est « D5 ».Gets the last cell within the range. For example, the last cell of "B2:D5" is "D5".
LastcolumnLastcolumn RangeRange Obtient la dernière colonne de la plage. Par exemple, la dernière colonne de la plage « B2:D5 » est « D2:D5 ».Gets the last column within the range. For example, the last column of "B2:D5" is "D2:D5".
LastRowLastrow RangeRange Obtient la dernière ligne de la plage. Par exemple, la dernière ligne de la plage « B2:D5 » est « B5:D5 ».Gets the last row within the range. For example, the last row of "B2:D5" is "B5:D5".
OffsetrangeOffsetrange PlageRange Obtient un objet qui représente une plage décalée par rapport à la plage spécifiée. Les dimensions de la plage renvoyée correspondent à celle de la plage initiale. Si la plage obtenue se retrouve en dehors des limites de la grille de la feuille de calcul, une exception est déclenchée.Gets an object which represents a range that's offset from the specified range. The dimension of the returned range will match this range. If the resulting range is forced outside the bounds of the worksheet grid, an exception will be thrown.
LigneRow PlageRange Obtient une ligne contenue dans la plage.Gets a row contained in the range.
RowsaboveRowsabove workbookRangeViewworkbookRangeView collection Obtient un certain nombre de lignes au-dessus d’une plage donnée.Gets a certain number of rows above a given range.
RowsbelowRowsbelow workbookRangeViewworkbookRangeView collection Obtient un certain nombre de lignes en dessous d’une plage donnée.Gets a certain number of rows below a given range.
UsedRangeUsedrange PlageRange Renvoie la plage utilisée d’un objet de plage donné.Returns the used range of the given range object.
EffacerClear AucunNone Supprime les valeurs et les propriétés de format, de remplissage, de bordure, etc. de la plage.Clear range values, format, fill, border, etc.
DeleteDelete AucunNone Supprime les cellules associées à la plage.Deletes the cells associated with the range.
InsérerInsert PlageRange 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éé.Inserts a cell or a range of cells into the worksheet in place of this range, and shifts the other cells to make space. Returns a new Range object at the now blank space.
FusionnerMerge AucunNone Fusionne la plage de cellules dans une zone de la feuille de calcul.Merge the range cells into one region in the worksheet.
ResizedrangeResizedrange workbookRangeViewworkbookRangeView collection 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.Gets a range object similar to the current range object, but with its bottom-right corner expanded (or contracted) by some number of rows and columns.
Annuler la fusionUnmerge AucunNone Annule la fusion de la plage de cellules.Unmerge the range cells into separate cells.
VisibleviewVisibleview workbookRangeViewworkbookRangeView collection Obtient la plage visible à partir d’une plage filtrée.Get the range visible from a filtered range.

PropriétésProperties

PropriétéProperty TypeType DescriptionDescription
addressaddress stringstring 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, Feuille1! A1:B4). En lecture seule.Represents the range reference in A1-style. Address value will contain the Sheet reference (e.g. Sheet1!A1:B4). Read-only.
addressLocaladdressLocal stringstring Représente la référence de la plage spécifiée dans le langage de l’utilisateur. En lecture seule.Represents range reference for the specified range in the language of the user. Read-only.
cellCountcellCount intint Nombre de cellules dans la plage. En lecture seule.Number of cells in the range. Read-only.
columnCountcolumnCount intint Représente le nombre total de colonnes dans la plage. En lecture seule.Represents the total number of columns in the range. Read-only.
columnHiddencolumnHidden booléenboolean Indique si toutes les colonnes de la plage active sont masquées.Represents if all columns of the current range are hidden.
columnIndexcolumnIndex intint Représente le numéro de colonne de la première cellule de la plage. Avec indice zéro. En lecture seule.Represents the column number of the first cell in the range. Zero-indexed. Read-only.
formulasformulas JsonJson Représente la formule dans le style de notation A1.Represents the formula in A1-style notation.
formulasLocalformulasLocal JsonJson 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.Represents the formula in A1-style notation, in the user's language and number-formatting locale. For example, the English "=SUM(A1, 1.5)" formula would become "=SUMME(A1; 1,5)" in German.
formulasR1C1formulasR1C1 JsonJson Représente la formule dans le style de notation R1C1.Represents the formula in R1C1-style notation.
hiddenhidden booléenboolean Indique si toutes les cellules de la plage active sont masquées. En lecture seule.Represents if all cells of the current range are hidden. Read-only.
numberFormatnumberFormat JsonJson Représente le code de format de nombre d’Excel pour une cellule donnée.Represents Excel's number format code for the given cell.
rowCountrowCount intint Renvoie le nombre total de lignes de la plage. En lecture seule.Returns the total number of rows in the range. Read-only.
rowHiddenrowHidden booléenboolean Indique si toutes les lignes de la plage active sont masquées.Represents if all rows of the current range are hidden.
rowIndexrowIndex intint Renvoie le numéro de ligne de la première cellule de la plage. Avec indice zéro. En lecture seule.Returns the row number of the first cell in the range. Zero-indexed. Read-only.
texttext JsonJson Valeurs de texte de la plage spécifiée. La valeur de texte ne dépend pas de la largeur de la cellule. Le remplacement par le signe # qui se produit dans l’interface utilisateur d’Excel n’a aucun effet sur la valeur de texte renvoyée par l’API. En lecture seule.Text values of the specified range. The Text value will not depend on the cell width. The # sign substitution that happens in Excel UI will not affect the text value returned by the API. Read-only.
valueTypesvalueTypes JsonJson Représente le type de données de chaque cellule.Represents the type of data of each cell. Les valeurs possibles sont Unknown, Empty, String, Integer, Double, Boolean, Error.The possible values are: Unknown, Empty, String, Integer, Double, Boolean, Error. En lecture seule.Read-only.
valuesvalues JsonJson 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. Une cellule contenant une erreur renvoie la chaîne d’erreur.Represents the raw values of the specified range. The data returned could be of type string, number, or a boolean. Cell that contain an error will return the error string.

RelationsRelationships

RelationRelationship TypeType DescriptionDescription
formatformat WorkbookRangeFormatWorkbookRangeFormat Renvoie un objet de format, qui comprend les propriétés de police, de remplissage, de bordures, d’alignement, etc. de la plage. En lecture seule.Returns a format object, encapsulating the range's font, fill, borders, alignment, and other properties. Read-only.
trisort WorkbookRangeSortWorkbookRangeSort Feuille de calcul contenant la plage. En lecture seule.The worksheet containing the current range. Read-only.
worksheetworksheet WorkbookWorksheetWorkbookWorksheet Feuille de calcul contenant la plage.The worksheet containing the current range. En lecture seule.Read-only.

Représentation JSONJSON representation

Voici une représentation JSON de la ressource.Here is a JSON representation of the resource.

{
  "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"
}