QValue3DAxisFormatter Class

Documentation des fonctions membres

[explicit] QValue3DAxisFormatter::QValue3DAxisFormatter(QObject *parent = nullptr)

Crée un nouveau formateur d'axes 3D avec, en option, l'parent.

[override virtual noexcept] QValue3DAxisFormatter::~QValue3DAxisFormatter()

Supprime la valeur « Formateur d'axes 3D ».

[protected] bool QValue3DAxisFormatter::allowNegatives() const

Renvoie ` true ` si les valeurs négatives sont des valeurs valides pour l'axe parent. L'implémentation par défaut renvoie toujours ` true`.

Voir également setAllowNegatives().

[protected] bool QValue3DAxisFormatter::allowZero() const

Renvoie ` true ` si zéro est une valeur valide pour l'axe parent. L'implémentation par défaut renvoie toujours ` true`.

Voir également setAllowZero().

[protected] QValue3DAxis *QValue3DAxisFormatter::axis() const

Renvoie l'axe parent. L'accès à l'axe parent ne doit se faire que dans la méthode recalculate() afin de garantir la sécurité des threads dans les environnements utilisant un moteur de rendu multithread.

Voir également recalculate().

[virtual protected] QValue3DAxisFormatter *QValue3DAxisFormatter::createNewInstance() const

Crée un nouveau formateur d'axes 3D de valeur vide. Doit être réimplémenté dans une sous-classe.

Renvoie le nouveau formateur. Le moteur de rendu utilise cette méthode pour mettre en cache une copie du formateur. La propriété de la nouvelle copie est transférée à l'appelant.

[protected] QList<float> QValue3DAxisFormatter::gridPositions() &&

Renvoie un tableau contenant les positions normalisées des lignes de la grille par valeur. La taille par défaut du tableau est égale au nombre de segments de l'axe parent plus un, mais une implémentation sous-classée de la méthode ` recalculate()` peut redimensionner le tableau différemment.

Voir également QValue3DAxis::segmentCount et recalculate().

[protected] const QList<float> &QValue3DAxisFormatter::gridPositions() const &

Renvoie une référence au tableau contenant les positions normalisées des lignes de la grille. La taille par défaut du tableau est égale au nombre de segments de l'axe parent plus un, mais une implémentation sous-classée de la méthode recalculate() peut redimensionner le tableau différemment.

Voir également QValue3DAxis::segmentCount et recalculate().

[protected] QList<float> QValue3DAxisFormatter::labelPositions() &&

Renvoie un tableau contenant les positions normalisées des étiquettes en fonction de leur valeur. La taille par défaut du tableau est égale au nombre de segments de l’axe parent plus un, mais une implémentation sous-classée de la méthode recalculate() peut redimensionner le tableau différemment. Par défaut, l’étiquette à l’index zéro correspond à la valeur minimale de l’axe.

Voir également QValue3DAxis::segmentCount, QAbstract3DAxis::labels et recalculate().

[protected] const QList<float> &QValue3DAxisFormatter::labelPositions() const &

Renvoie une référence au tableau contenant les positions normalisées des étiquettes. La taille par défaut du tableau est égale au nombre de segments de l’axe parent plus un, mais une implémentation sous-classée de la méthode recalculate() peut redimensionner le tableau différemment. Par défaut, l’étiquette à l’indice zéro correspond à la valeur minimale de l’axe.

Voir également QValue3DAxis::segmentCount, QAbstract3DAxis::labels et recalculate().

[protected] QStringList QValue3DAxisFormatter::labelStrings() &&

Renvoie une liste de chaînes de caractères par valeur contenant les chaînes d'étiquettes du formateur.

Voir également setLabelStrings() et labelPositions().

[protected] const QStringList &QValue3DAxisFormatter::labelStrings() const &

Renvoie une référence à la liste de chaînes contenant les chaînes d'étiquettes du formateur.

Voir aussi ` labelPositions()`.

[protected] QLocale QValue3DAxisFormatter::locale() const

Renvoie les paramètres régionaux actuellement utilisés par ce formateur.

Voir aussi setLocale().

[protected] void QValue3DAxisFormatter::markDirty(bool labelsChange = false)

Marque ce formateur comme « sale », ce qui incite le moteur de rendu à créer une nouvelle copie de son cache lors de la prochaine synchronisation du moteur de rendu. Cette méthode doit être appelée par une sous-classe chaque fois que le formateur est modifié d’une manière qui affecte les valeurs résolues. Définissez ` labelsChange ` sur ` true ` si la modification nécessite de régénérer les chaînes de caractères des étiquettes des axes parents.

[virtual protected] void QValue3DAxisFormatter::populateCopy(QValue3DAxisFormatter &copy)

Copie toutes les valeurs nécessaires au traitement des positions, des valeurs et des chaînes de caractères à l'aide de ce formateur vers l'copy e de ce dernier. Lors de la réimplémentation de cette méthode dans une sous-classe, il convient d'appeler la version de la superclasse à un moment donné. Le rendu utilise cette méthode pour mettre en cache une copie du formateur.

Renvoie la nouvelle copie. La propriété de la nouvelle copie est transférée à l'appelant.

[virtual protected] float QValue3DAxisFormatter::positionAt(float value) const

Renvoie la position normalisée le long de l'axe pour l'value donné. La valeur renvoyée doit être comprise entre 0.0 (valeur minimale) et 1.0 (valeur maximale), inclus, si la valeur se situe dans la plage de l'axe parent.

Réimplémentez cette méthode si la position ne peut pas être déterminée par interpolation linéaire entre les valeurs minimale et maximale de l’axe parent.

Voir également recalculate() et valueAt().

[virtual protected] void QValue3DAxisFormatter::recalculate()

Redimensionne et remplit les tableaux de positions des étiquettes et des lignes de la grille, ainsi que le tableau des chaînes de caractères des étiquettes, et calcule toutes les valeurs nécessaires pour associer une valeur à sa position. L'axe parent est accessible depuis l'intérieur de cette fonction.

Cette méthode doit être réimplémentée dans une sous-classe si le contenu par défaut des tableaux ne convient pas.

Consultez la documentation relative aux méthodes gridPositions(), subGridPositions(), labelPositions() et labelStrings() pour plus d’informations sur les tableaux qui doivent être redimensionnés et renseignés.

Voir également les méthodes gridPositions(), subGridPositions(), labelPositions(), labelStrings() et axis().

[protected] void QValue3DAxisFormatter::setAllowNegatives(bool allow)

Permet à l'axe parent d'avoir des valeurs négatives si l'option « allow » est définie sur « true ».

Voir également allowNegatives().

[protected] void QValue3DAxisFormatter::setAllowZero(bool allow)

Permet à l'axe parent d'avoir une valeur nulle si allow est défini sur true.

Voir également allowZero().

[protected] void QValue3DAxisFormatter::setGridPoitions(QList<float> gridPositions)

Définit une liste de nouvelles positions de grille à partir de gridPositions. Les valeurs doivent être comprises entre 0.0 (valeur minimale) et 1.0 (valeur maximale), inclus.

Voir également QValue3DAxis::segmentCount, recalculate() et gridPositions.

[protected] void QValue3DAxisFormatter::setLabelStrings(QStringList labelStrings)

Définit une liste de nouvelles chaînes de texte pour les étiquettes à partir de labelStrings. La taille du tableau doit être égale à celle du tableau des positions des étiquettes, auquel les index correspondent également.

Voir également labelPositions() et labelStrings().

[protected] void QValue3DAxisFormatter::setLocale(const QLocale &locale)

Définit l'locale utilisé par ce formateur. Le graphique définit automatiquement la locale du formateur sur celle du graphique dès lors que l'axe parent est défini comme axe actif du graphique, que le formateur d'axe est associé à un axe du graphique ou que la locale du graphique change.

Voir également ` locale()` et ` Q3DGraphsWidgetItem::locale`.

[protected] void QValue3DAxisFormatter::setSubGridPositions(QList<float> subGridPositions)

Définit une liste de nouvelles positions de sous-grille à partir de subGridPositions. Les valeurs doivent être comprises entre 0.0 (valeur minimale) et 1.0 (valeur maximale), ces limites incluses.

Voir également QValue3DAxis::segmentCount, QValue3DAxis::subSegmentCount, recalculate() et subGridPositions.

[protected] void QValue3DAxisFormatter::setlabelPositions(QList<float> labelPositions)

Définit une liste de nouvelles positions d'étiquettes à partir de labelPositions. Les valeurs doivent être comprises entre 0.0 (valeur minimale) et 1.0 (valeur maximale), ces limites incluses.

Voir également QValue3DAxis::segmentCount, QAbstract3DAxis::labels, recalculate() et labelPositions().

[virtual protected] QString QValue3DAxisFormatter::stringForValue(qreal value, const QString &format)

Renvoie la chaîne de libellé formatée en utilisant les paramètres value et format spécifiés.

Réimplémentez cette méthode dans une sous-classe pour résoudre la chaîne formatée pour un value donné si les règles de formatage par défaut spécifiées pour la propriété QValue3DAxis::labelFormat ne sont pas suffisantes.

Voir également recalculate(), labelStrings() et QValue3DAxis::labelFormat.

[protected] QList<float> QValue3DAxisFormatter::subGridPositions() &&

Renvoie un tableau contenant les positions normalisées des lignes de la sous-grille par valeur. La taille par défaut du tableau est égale au nombre de segments de l’axe parent multiplié par le nombre de sous-segments de l’axe parent moins un ; toutefois, une implémentation dérivée de la méthode recalculate() peut redimensionner le tableau différemment.

Voir également setSubGridPositions(), QValue3DAxis::segmentCount, QValue3DAxis::subSegmentCount et recalculate().

[protected] const QList<float> &QValue3DAxisFormatter::subGridPositions() const &

Renvoie une référence au tableau contenant les positions normalisées des lignes de la sous-grille. La taille par défaut du tableau est égale au nombre de segments de l’axe parent multiplié par le nombre de sous-segments de cet axe parent, moins un ; toutefois, une implémentation sous-classée de la méthode ` recalculate()` peut redimensionner le tableau différemment.

Voir également QValue3DAxis::segmentCount, QValue3DAxis::subSegmentCount et recalculate().

[virtual protected] float QValue3DAxisFormatter::valueAt(float position) const

Renvoie la valeur correspondant à l’ position e normalisée le long de l’axe. La valeur d’ position doit être comprise entre 0.0 (valeur minimale) et 1.0 (valeur maximale), ces limites incluses, afin d’obtenir des valeurs situées dans la plage de l’axe parent.

Réimplémentez cette méthode si la valeur ne peut pas être déterminée par interpolation linéaire entre les valeurs minimale et maximale de l’axe parent.

Voir également recalculate() et positionAt().