SheetXL - v1.0.2
    Preparing search index...

    Interface IDataLabel

    The label of one point, over its series' labels.

    interface IDataLabel {
        isIDataLabel: true;
        getChart(): IChart;
        getElementType(): IChart.ElementType;
        getNumberFormat(): string | null;
        getParent(): IElement | null;
        getPath(): string;
        getPosition(): DataLabelPosition;
        getShowCategoryName(): boolean;
        getShowLegendKey(): boolean;
        getShowPercentage(): boolean;
        getShowSeriesName(): boolean;
        getShowValue(): boolean;
        getStyle(): ITextBoxStyle;
        getText(): string | null;
        getVisible(): boolean;
        setNumberFormat(
            formatCode: string | null,
            options?: ITransaction.OperationOptions,
        ): this;
        setPosition(
            position: DataLabelPosition,
            options?: ITransaction.OperationOptions,
        ): this;
        setShowCategoryName(
            show: boolean,
            options?: ITransaction.OperationOptions,
        ): this;
        setShowLegendKey(
            show: boolean,
            options?: ITransaction.OperationOptions,
        ): this;
        setShowPercentage(
            show: boolean,
            options?: ITransaction.OperationOptions,
        ): this;
        setShowSeriesName(
            show: boolean,
            options?: ITransaction.OperationOptions,
        ): this;
        setShowValue(show: boolean, options?: ITransaction.OperationOptions): this;
        setText(text: string | null, options?: ITransaction.OperationOptions): this;
        setVisible(visible: boolean, options?: ITransaction.OperationOptions): this;
        update(
            update: IChart.IDataLabel.Update,
            options?: ITransaction.OperationOptions,
        ): this;
    }

    Hierarchy (View Summary)

    Index
    isIDataLabel
    getChart getElementType getNumberFormat getParent getPath getPosition getShowCategoryName getShowLegendKey getShowPercentage getShowSeriesName getShowValue getStyle getText getVisible setNumberFormat setPosition setShowCategoryName setShowLegendKey setShowPercentage setShowSeriesName setShowValue setText setVisible update
    isIDataLabel: true

    For runtime type checking.

    • Returns the label's number format, or null when it takes the values'.

      Returns string | null

    • Returns the element this one is part of: a point's series, a gridline's axis, a legend entry's legend. The parts at the top (the title, the legend, the plot area, an axis, a series, a group) are the chart area's; the chart area has none.

      Returns IElement | null

    • Returns where the element is in its chart, as IChart.getElement takes it.

      Returns string

      A path is its parts' names joined by /, and does not change while the part is there:

      • chartArea, title, legend, legend/entries/<n>, plotArea, dataTable, and dataLabels (every series' at once);
      • axes/<primary|secondary>/<category|value|series>, and an axis's …/title, …/majorGridlines and …/minorGridlines;
      • series/<key>, and a series' …/marker, …/dataLabels, …/errorBars/<x|y>, …/trendlines/<n>, …/trendlines/<n>/label, …/points/<n>, …/points/<n>/marker and …/points/<n>/dataLabel;
      • groups/<n>, and a group's …/upDownBars, …/hiLoLines, …/dropLines and …/seriesLines.

      A series' key is its index in the file (c:idx), which an edit does not change; its place in the plot order can change. A point, a trendline, a legend entry and a group are named by their place, from 0: when one before it is removed, the path names the one that took its place.

    • Returns whether the label shows its point's category.

      Returns boolean

    • Returns whether the label shows the series' legend key.

      Returns boolean

    • Returns whether the label shows its point's share of the whole.

      Returns boolean

    • Returns whether the label shows the series' name.

      Returns boolean

    • Returns whether the label shows its point's value.

      Returns boolean

    • Returns the label's own text, or null when it shows what its flags say.

      Returns string | null

    • Returns whether the label is shown.

      Returns boolean

    Settings
    Member Visibility

    On This Page
    Properties
    Methods