Q3DBarsWidgetItem Class

QQuickWidget quickWidget;
Q3DBarsWidgetItem bars;
bars.setWidget(&quickWidget);
bars.widget()->setMinimumSize(QSize(256, 256));

bars.rowAxis()->setRange(0, 4);
bars.columnAxis()->setRange(0, 4);

QBar3DSeries series;
QBarDataRow data;
data << QBarDataItem(1.0f) << QBarDataItem(3.0f) << QBarDataItem(7.5f) << QBarDataItem(5.0f)
     << QBarDataItem(2.2f);
series.dataProxy()->addRow(data);
bars.addSeries(&series);

bars.widget()->show();

#include <QtGraphs>
#include <QtGraphsWidgets/q3dbarswidgetitem.h>
#include <QtWidgets/qapplication.h>
int main(int argc, char **argv)
{
    QApplication app(argc, argv);

    QQuickWidget quickWidget;
    Q3DBarsWidgetItem bars;
    bars.setWidget(&quickWidget);
    bars.widget()->setMinimumSize(QSize(256, 256));
    bars.rowAxis()->setRange(0, 4);
    bars.columnAxis()->setRange(0, 4);
    QBar3DSeries series;
    QBarDataRow data;
    data << QBarDataItem(1.0f) << QBarDataItem(3.0f) << QBarDataItem(7.5f) << QBarDataItem(5.0f)
         << QBarDataItem(2.2f);
    series.dataProxy()->addRow(data);
    bars.addSeries(&series);
    bars.widget()->show();

    return app.exec();
}

Documentation sur les propriétés

barSeriesMargin : QSizeF

Marge entre les colonnes des séries dans les dimensions X et Z. Les valeurs recommandées se situent dans l'intervalle [0, 1).

La valeur par défaut est (0.0, 0.0). Cette propriété permet d'afficher côte à côte les barres de différentes séries, tout en conservant un espace entre les colonnes.

Fonctions d'accès :

Signal de notification :

Voir également barSpacing.

barSpacing : QSizeF

Espacement des barres dans les axes X et Z.

Réglage par défaut : (1.0, 1.0). L'espacement est influencé par la propriété « barSpacingRelative ».

Fonctions d'accès :

Signal de notification :

Voir également barSpacingRelative, multiSeriesUniform et barSeriesMargin.

barSpacingRelative : bool

Cette propriété s'applique que l'espacement soit absolu ou relatif à l'épaisseur des barres.

Si elle est définie sur « true », la valeur « 0.0 » signifie que les barres sont placées côte à côte, « 1.0 » signifie qu’un espace de la largeur de l’épaisseur d’une barre est laissé entre les barres, et ainsi de suite. La valeur par défaut est « true ».

Fonctions d'accès :

Signal de notification :

barThickness : float

Cette propriété définit le rapport d'épaisseur de la barre entre les dimensions X et Z.

La valeur « 1.0 » signifie que les barres ont une largeur égale à leur profondeur, tandis que « 0.5 » leur confère une profondeur deux fois supérieure à leur largeur. La valeur par défaut est « 1.0 ».

Fonctions d’accès :

Signal de notification :

columnAxis : QCategory3DAxis*

Cette propriété contient l'axe associé à la colonne active.

Définit l'axe de la colonne active sur axis. Appelle implicitement la méthode addAxis() pour transférer la propriété de l'axe à ce graphique.

Si axis est nul, un axe temporaire par défaut sans étiquettes est créé. Cet axe temporaire est détruit si un autre axe est explicitement défini avec la même orientation.

Fonctions d’accès :

Signal de notification :

Voir également addAxis() et releaseAxis().

floorLevel : float

Cette propriété définit le niveau minimal du graphique à barres selon les coordonnées de l'axe Y.

Le niveau de base réel sera limité par les valeurs minimales et maximales de l'axe Y. La valeur par défaut est zéro.

Fonctions d'accès :

Signal de notification :

multiSeriesUniform : bool

Cette propriété s'applique que les barres soient mises à l'échelle selon les proportions définies pour une seule série, même si plusieurs séries sont affichées.

Si la valeur est définie sur « true », l’option « bar spacing » ne s’appliquera correctement qu’à l’axe X. La valeur par défaut est « false ».

Fonctions d'accès :

Signal de notification :

primarySeries : QBar3DSeries*

Cette propriété définit la série principale du graphique.

Définit series comme série principale du graphique. La série principale détermine les libellés des axes des lignes et des colonnes lorsque ceux-ci ne sont pas explicitement définis sur les axes.

Si la série spécifiée n’est pas encore ajoutée au graphique, le fait de la définir comme série principale entraîne également son ajout implicite au graphique.

Si la série principale elle-même est supprimée du graphique, cette propriété revient à sa valeur par défaut.

Si series est nul, cette propriété revient à sa valeur par défaut. La valeur par défaut est la première série ajoutée ou zéro si aucune série n’a été ajoutée au graphique.

Fonctions d’accès :

Signal de notification :

rowAxis : QCategory3DAxis*

Cette propriété contient l'axe associé à la ligne active.

Définit l’axe de la ligne active sur axis. Appelle implicitement la méthode addAxis() pour transférer la propriété de l’axe à ce graphique.

Si axis est nul, un axe temporaire par défaut sans étiquettes est créé. Cet axe temporaire est détruit si un autre axe est explicitement défini avec la même orientation.

Fonctions d’accès :

Signal de notification :

Voir également addAxis() et releaseAxis().

[read-only] selectedSeries : QBar3DSeries*

Cette propriété contient la série sélectionnée ou une valeur nulle.

Si le paramètre selectionMode est associé au drapeau « SelectionMultiSeries », cette propriété contient la série à laquelle appartient la barre sélectionnée.

Fonctions d'accès :

Signal de notification :

valueAxis : QValue3DAxis*

Définit l'axe de valeur actif (l'axe Y) sur ` axis`. Appelle implicitement la méthode ` addAxis()` pour transférer la propriété de ` axis ` à ce graphique.

Si axis est nul, un axe temporaire par défaut, sans étiquettes et dont la plage s’ajuste automatiquement, est créé. Cet axe temporaire est détruit si un autre axe est explicitement défini avec la même orientation.

Fonctions d’accès :

Signal de notification :

Voir également addAxis() et releaseAxis().

connect(item, &Q3DBarsWidgetItem::sliceImageChanged, this, [](const QImage &image) {
    // ~~~
});

item->renderSliceToImage(sliceType, index);