Excel.DoubleCellValue interface

Représente la valeur d’une cellule contenant un double.

Propriétés

basicType

Représente la valeur qui serait retournée par Range.valueTypes pour une cellule avec cette valeur.

basicValue

Représente la valeur qui serait retournée par Range.values pour une cellule avec cette valeur.

layouts

Représente les informations de mise en page pour les vues de cette valeur double.

numberFormat

Renvoie la chaîne de format numérique utilisée pour afficher cette valeur. Lorsqu’elle est accessible via une valuesAsJson propriété, cette chaîne de format de nombre se trouve dans les paramètres régionaux fr-FR. Lorsque vous y accédez via une valuesAsJsonLocal propriété, ce format de nombre se trouve dans les paramètres régionaux d’affichage de l’utilisateur. Les chaînes de format numérique doivent être conformes aux instructions d’Excel. Pour plus d’informations, consultez Revoir les instructions relatives à la personnalisation d’un format de nombre.

properties

Représente des propriétés supplémentaires de cette valeur double.

provider

Représente les informations qui décrivent le service qui a fourni les données dans ce DoubleCellValue. Ces informations peuvent être utilisées pour la personnalisation dans la vue de la carte.

referencedValues

Représente les valeurs de cellule référencées dans DoubleCellValue.properties.

type

Représente le type de cette valeur de cellule.

Détails de la propriété

basicType

Représente la valeur qui serait retournée par Range.valueTypes pour une cellule avec cette valeur.

basicType?: RangeValueType.double | "Double";

Valeur de propriété

double | "Double"

Remarques

Jeu d’API : ExcelApi 1.16

basicValue

Représente la valeur qui serait retournée par Range.values pour une cellule avec cette valeur.

basicValue: number;

Valeur de propriété

number

Remarques

Jeu d’API : ExcelApi 1.16

layouts

Représente les informations de mise en page pour les vues de cette valeur double.

layouts?: BasicViewLayouts;

Valeur de propriété

Remarques

Jeu d’API : ExcelApi 1.19

numberFormat

Renvoie la chaîne de format numérique utilisée pour afficher cette valeur. Lorsqu’elle est accessible via une valuesAsJson propriété, cette chaîne de format de nombre se trouve dans les paramètres régionaux fr-FR. Lorsque vous y accédez via une valuesAsJsonLocal propriété, ce format de nombre se trouve dans les paramètres régionaux d’affichage de l’utilisateur. Les chaînes de format numérique doivent être conformes aux instructions d’Excel. Pour plus d’informations, consultez Revoir les instructions relatives à la personnalisation d’un format de nombre.

numberFormat?: string;

Valeur de propriété

string

Remarques

Jeu d’API : ExcelApi 1.19

Exemples

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/20-data-types/data-types-formatted-number.yaml

// This function creates a double data type,
// and sets the format of this data type as a currency.
await Excel.run(async (context) => {
  // Get the Sample worksheet and a range on that sheet.
  const sheet = context.workbook.worksheets.getItemOrNullObject("Sample");
  const currencyRange = sheet.getRange("A2");

  // Write a number formatted as currency to cell A2.
  currencyRange.valuesAsJson = [
    [
      {
        type: Excel.CellValueType.double,
        basicValue: 12.34,
        numberFormat: "$* #,##0.00"
      }
    ]
  ];

  await context.sync();
});

properties

Représente des propriétés supplémentaires de cette valeur double.

properties?: {
            [key: string]: EntityPropertyType;
        };

Valeur de propriété

{ [key: string]: Excel.EntityPropertyType; }

Remarques

Jeu d’API : ExcelApi 1.19

provider

Représente les informations qui décrivent le service qui a fourni les données dans ce DoubleCellValue. Ces informations peuvent être utilisées pour la personnalisation dans la vue de la carte.

provider?: CellValueProviderAttributes;

Valeur de propriété

Remarques

Jeu d’API : ExcelApi 1.19

referencedValues

Représente les valeurs de cellule référencées dans DoubleCellValue.properties.

referencedValues?: ReferencedValue[];

Valeur de propriété

Remarques

Jeu d’API : ExcelApi 1.19

type

Représente le type de cette valeur de cellule.

type: CellValueType.double | ReferenceValueType.double | "Double";

Valeur de propriété

double | double | "Double"

Remarques

Jeu d’API : ExcelApi 1.16

Exemples

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/20-data-types/data-types-formatted-number.yaml

// This function creates a double data type,
// and sets the format of this data type as a date.
await Excel.run(async (context) => {
  // Get the Sample worksheet and a range on that sheet.
  const sheet = context.workbook.worksheets.getItemOrNullObject("Sample");
  const dateRange = sheet.getRange("A1");

  // Write a number formatted as a date to cell A1.
  dateRange.valuesAsJson = [
    [
      {
        type: Excel.CellValueType.double,
        basicValue: 32889.0,
        numberFormat: "m/d/yyyy"
      }
    ]
  ];
  await context.sync();
});