Objet Application (interface API JavaScript pour Excel)

Office and SharePoint Add-ins

La dernière version de ce complément Office est disponible dans le référentiel GitHub des compléments.


S’applique à : Excel 2016, Excel Online, Office 2016

Représente l’application Excel qui gère le classeur.

PropriétéTypeDescription
calculationModestringRenvoie le mode de calcul du classeur. En lecture seule. Les valeurs possibles sont les suivantes : Automatic Excel contrôle le recalcul, AutomaticExceptTables Excel contrôle le recalcul, mais ignore les modifications apportées aux tables, Manual le calcul est effectué lorsque l’utilisateur le demande.

Voir des exemples d’accès aux propriétés.

Aucun

MéthodeType renvoyéDescription
calculate(calculationType: string)voidRecalcule tous les classeurs actuellement ouverts dans Excel.
load(param: object)voidRemplit l’objet proxy créé dans le calque JavaScript avec des valeurs de propriété et d’objet spécifiées dans le paramètre.

Recalcule tous les classeurs actuellement ouverts dans Excel.

Syntaxe

jsapplicationObject.calculate(calculationType);

Paramètres

ParamètreTypeDescription
calculationTypestringSpécifie le type de calcul à utiliser. Les valeurs possibles sont les suivantes : Recalculate (option par défaut), effectue le calcul normalement en appliquant toutes les formules du classeur, Full force le calcul intégral des données, FullRebuild force le calcul intégral des données et régénère les dépendances.

Retourne

void

Exemples


Excel.run(function (ctx) { 
    ctx.workbook.application.calculate('Full');
    return ctx.sync(); 
}).catch(function(error) {
        console.log("Error: " + error);
        if (error instanceof OfficeExtension.Error) {
            console.log("Debug info: " + JSON.stringify(error.debugInfo));
        }
});

Remplit l’objet proxy créé dans le calque JavaScript avec des valeurs de propriété et d’objet spécifiées dans le paramètre.

Syntaxe

jsobject.load(param);

Paramètres

ParamètreTypeDescription
paramobjectFacultatif. Accepte les noms de paramètre et de relation sous forme de chaîne délimitée ou de tableau. Sinon, accepte un objet loadOption.

Renvoie

void


Excel.run(function (ctx) { 
    var application = ctx.workbook.application;
    application.load('calculationMode');
    return ctx.sync().then(function() {
        console.log(application.calculationMode);
    });
}).catch(function(error) {
        console.log("Error: " + error);
        if (error instanceof OfficeExtension.Error) {
            console.log("Debug info: " + JSON.stringify(error.debugInfo));
        }
});

Afficher: