Objet ChartDataLabels (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 une collection de toutes les étiquettes de données associées à un point de graphique.

PropriétéTypeDescription
PositionstringValeur DataLabelPosition qui représente la position de l’étiquette de données. Les valeurs possibles sont les suivantes : None, Center, InsideEnd, InsideBase, OutsideEnd, Left, Right, Top, Bottom, BestFit, Callout. En écriture seule.
SeparatorstringChaîne représentant le séparateur utilisé pour les étiquettes de données d’un graphique. En écriture seule.
showBubbleSizeboolValeur booléenne indiquant si la taille des bulles des étiquettes de données est visible ou non. En écriture seule.
showCategoryNameboolValeur booléenne indiquant si le nom de catégorie des étiquettes de données est visible ou non. En écriture seule.
showLegendKeyboolValeur booléenne indiquant si le symbole de légende des étiquettes de données est visible ou non. En écriture seule.
showPercentageboolValeur booléenne indiquant si le pourcentage des étiquettes de données est visible ou non. En écriture seule.
showSeriesNameboolValeur booléenne indiquant si le nom de série des étiquettes de données est visible ou non. En écriture seule.
showValueboolValeur booléenne indiquant si la valeur des étiquettes de données est visible ou non. En écriture seule.

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

RelationTypeDescription
formatChartDataLabelFormatReprésente le format des étiquettes de données du graphique, à savoir le format de remplissage et de la police. En lecture seule.
MéthodeType renvoyéDescription
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.

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, indiquez l’objet loadOption.

Renvoie

void

Faire apparaître le nom de série dans les étiquettes de données et définir la valeur position sur « top »


Excel.run(function (ctx) { 
    var chart = ctx.workbook.worksheets.getItem("Sheet1").charts.getItem("Chart1"); 
    chart.datalabels.visible = true;
    chart.datalabels.position = "top";
    chart.datalabels.ShowSeriesName = true;
    return ctx.sync().then(function() {
            console.log("Datalabels Shown");
    });
}).catch(function(error) {
        console.log("Error: " + error);
        if (error instanceof OfficeExtension.Error) {
            console.log("Debug info: " + JSON.stringify(error.debugInfo));
        }
});

Afficher: