qpieseries.h - mozsearch

Enable keyboard shortcuts

// Copyright (C) 2024 The Qt Company Ltd.

// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GPL-3.0-only

// Qt-Security score:significant reason:default

#ifndef QTGRAPHS_QPIESERIES_H

#define QTGRAPHS_QPIESERIES_H

#include <QtGraphs/qabstractseries.h>

#include <QtGraphs/qgraphsglobal.h>

#include <QtGraphs/qpieslice.h>

QT_BEGIN_NAMESPACE

class QPieSeriesPrivate;

class Q_GRAPHS_EXPORT QPieSeries : public QAbstractSeries

    Q_OBJECT

    Q_CLASSINFO("RegisterEnumClassesUnscoped", "false")

    Q_PROPERTY(qreal horizontalPosition READ horizontalPosition WRITE setHorizontalPosition NOTIFY

                   horizontalPositionChanged FINAL)

    Q_PROPERTY(qreal verticalPosition READ verticalPosition WRITE setVerticalPosition NOTIFY

                   verticalPositionChanged FINAL)

    Q_PROPERTY(qreal pieSize READ pieSize WRITE setPieSize NOTIFY pieSizeChanged FINAL)

    Q_PROPERTY(qreal startAngle READ startAngle WRITE setStartAngle NOTIFY startAngleChanged FINAL)

    Q_PROPERTY(qreal endAngle READ endAngle WRITE setEndAngle NOTIFY endAngleChanged FINAL)

    Q_PROPERTY(qsizetype count READ count NOTIFY countChanged FINAL)

    Q_PROPERTY(qreal sum READ sum NOTIFY sumChanged FINAL)

    Q_PROPERTY(qreal holeSize READ holeSize WRITE setHoleSize NOTIFY holeSizeChanged FINAL)

    Q_PROPERTY(qreal angleSpanVisibleLimit READ angleSpanVisibleLimit WRITE setAngleSpanVisibleLimit

                   NOTIFY angleSpanVisibleLimitChanged REVISION(6, 10))

    Q_PROPERTY(LabelVisibility angleSpanLabelVisibility READ angleSpanLabelVisibility

                   WRITE setAngleSpanLabelVisibility NOTIFY angleSpanLabelVisibilityChanged REVISION(6, 10))

    Q_PROPERTY(QList<qreal> sliceData READ sliceData WRITE setSliceData NOTIFY sliceDataChanged REVISION(6, 12))

    Q_PROPERTY(QStringList sliceLabels READ sliceLabels WRITE setSliceLabels NOTIFY sliceLabelsChanged REVISION(6, 12))

    QML_NAMED_ELEMENT(PieSeries)

public:

    enum class LabelVisibility {

        None,

        First,

        Even,

        Odd,

};

    Q_ENUM(LabelVisibility)

    explicit QPieSeries(QObject *parent = nullptr);

    ~QPieSeries() override;

    QAbstractSeries::SeriesType type() const override;

    Q_INVOKABLE bool append(QPieSlice *slice);

    Q_INVOKABLE bool append(const QList<QPieSlice *> &slices);

    Q_INVOKABLE bool insert(qsizetype index, QPieSlice *slice);

    Q_INVOKABLE bool remove(QPieSlice *slice);

    Q_INVOKABLE void clear();

    Q_INVOKABLE QPieSlice *append(const QString &label, qreal value);

    Q_INVOKABLE QPieSlice *at(qsizetype index);

    Q_INVOKABLE QPieSlice *find(const QString &label);

    Q_INVOKABLE bool replace(qsizetype index, QPieSlice *slice);

    Q_INVOKABLE void removeMultiple(qsizetype index, int count);

    Q_INVOKABLE bool remove(qsizetype index);

    Q_INVOKABLE bool replace(QPieSlice *oldSlice, QPieSlice *newSlice);

    Q_INVOKABLE bool replace(const QList<QPieSlice *> &slices);

    Q_INVOKABLE bool take(QPieSlice *slice);

    QPieSeries &operator<<(QPieSlice *slice);

    QList<QPieSlice *> slices() const;

    qsizetype count() const;

    bool isEmpty() const;

    qreal sum() const;

    void setHorizontalPosition(qreal relativePosition);

    qreal horizontalPosition() const;

    void setVerticalPosition(qreal relativePosition);

    qreal verticalPosition() const;

    void setPieSize(qreal relativeSize);

    qreal pieSize() const;

    void setStartAngle(qreal startAngle);

    qreal startAngle() const;

    void setEndAngle(qreal endAngle);

    qreal endAngle() const;

    void setHoleSize(qreal holeSize);

    qreal holeSize() const;

    void setLabelsVisible(bool visible);

    void setLabelsPosition(QPieSlice::LabelPosition position);

    qreal angleSpanVisibleLimit() const;

    void setAngleSpanVisibleLimit(qreal newAngleSpanVisibleLimit);

    LabelVisibility angleSpanLabelVisibility() const;

    void setAngleSpanLabelVisibility(LabelVisibility newAngleSpanVisibleMode);

    QList<qreal> sliceData() const;

    void setSliceData(const QList<qreal> &newSliceData);

    const QStringList &sliceLabels() const &;

    QStringList sliceLabels() &&;

    void setSliceLabels(QStringList newLabels);

public Q_SLOTS:

    void handleSliceChange();

protected:

    QPieSeries(QPieSeriesPrivate &dd, QObject *parent = nullptr);

    void componentComplete() override;

Q_SIGNALS:

    void added(const QList<QPieSlice *> &slices);

    void removed(const QList<QPieSlice *> &slices);

    void replaced(const QList<QPieSlice *> &slices);

    void countChanged();

    void sumChanged();

    void pieSizeChanged();

    void startAngleChanged();

    void endAngleChanged();

    void horizontalPositionChanged();

    void verticalPositionChanged();

    void holeSizeChanged();

    Q_REVISION(6, 9) void clicked(QPieSlice *slice);

    Q_REVISION(6, 9) void doubleClicked(QPieSlice *slice);

    Q_REVISION(6, 9) void pressed(QPieSlice *slice);

    Q_REVISION(6, 9) void released(QPieSlice *slice);

    Q_REVISION(6, 10) void angleSpanVisibleLimitChanged(qreal limit);

    Q_REVISION(6, 10) void angleSpanLabelVisibilityChanged(LabelVisibility visibility);

    Q_REVISION(6, 12) void sliceDataChanged(const QList<qreal> &sliceData);

    Q_REVISION(6, 12) void sliceLabelsChanged(const QStringList &sliceLabels);

private:

    friend class PieRenderer;

    Q_DECLARE_PRIVATE(QPieSeries)

    Q_DISABLE_COPY(QPieSeries)

};

QT_END_NAMESPACE

#endif // QTGRAPHS_QPIESERIES_H