QValue3DAxisFormatter Class

Documentation des fonctions membres

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

Construit un nouveau formateur d'axes 3D avec le parent optionnel parent.

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

Supprime la valeur du formateur d'axes 3D.

[protected] bool QValue3DAxisFormatter::allowNegatives() const

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

Voir aussi 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 aussi setAllowZero().

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

Renvoie l'axe parent. L'axe parent ne doit être accessible que dans la méthode recalculate() afin de préserver la sécurité des threads dans les environnements utilisant un moteur de rendu threadé.

Voir aussi recalculate().

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

Crée un nouveau formateur d'axes 3D à 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 de positions de lignes de grille normalisées 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 aussi QValue3DAxis::segmentCount et recalculate().

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

Renvoie une référence au tableau des 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 de positions d'étiquettes normalisées 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. Par défaut, l'étiquette à l'index zéro correspond à la valeur minimale de l'axe.

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

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

Renvoie une référence au tableau des 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'index zéro correspond à la valeur minimale de l'axe.

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

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

Renvoie une liste de chaînes de caractères contenant des chaînes d'étiquettes de formateur.

Voir aussi 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 la locale utilisée par le formateur.

Voir aussi setLocale().

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

Marque ce formateur comme sale, ce qui incite le moteur de rendu à faire 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 à true si la modification nécessite la régénération des chaînes d'étiquettes de l'axe parent.

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

Copie toutes les valeurs nécessaires à la résolution des positions, des valeurs et des chaînes avec ce formateur sur le site copy du formateur. Lorsque vous réimplémentez cette méthode dans une sous-classe, appelez la version de la superclasse à un moment donné. Le moteur de 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 la valeur donnée value. La valeur renvoyée doit être comprise entre 0.0 (la valeur minimale) et 1.0 (la valeur maximale), inclusivement, si la valeur est comprise dans la plage de l'axe parent.

Réimplémenter cette méthode si la position ne peut pas être résolue 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 position des étiquettes et des lignes de la grille, ainsi que le tableau des chaînes d'étiquettes, et calcule toutes les valeurs nécessaires pour faire correspondre une valeur à sa position. L'axe parent est accessible à partir de cette fonction.

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

Voir les méthodes gridPositions(), subGridPositions(), labelPositions() et labelStrings() pour la documentation sur les tableaux qui doivent être redimensionnés et remplis.

Voir aussi gridPositions(), subGridPositions(), labelPositions(), labelStrings() et axis().

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

Permet à l'axe parent d'avoir des valeurs négatives si allow est true.

Voir également allowNegatives().

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

Permet à l'axe parent d'avoir une valeur nulle si allow est 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 (la valeur minimale) et 1.0 (la valeur maximale), inclusivement.

Voir aussi QValue3DAxis::segmentCount, recalculate(), et gridPositions.

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

Définit une liste de nouvelles chaînes d'étiquettes provenant de labelStrings. La taille du tableau doit être égale à la taille du tableau des positions d'étiquettes, auquel les index correspondent également.

Voir aussi labelPositions() et labelStrings().

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

Définit le site locale utilisé par ce formateur. Le graphique règle automatiquement la locale du formateur sur la locale du graphique lorsque l'axe parent est défini comme axe actif du graphique, que le formateur d'axe est défini sur un axe attaché au graphique ou que la locale du graphique change.

Voir aussi 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 (la valeur minimale) et 1.0 (la valeur maximale), inclusivement.

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 (la valeur minimale) et 1.0 (la valeur maximale), inclusivement.

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

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

Renvoie la chaîne de l'étiquette formatée en utilisant les propriétés value et format spécifiées.

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

Voir aussi recalculate(), labelStrings() et QValue3DAxis::labelFormat.

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

Renvoie un tableau de positions de lignes de sous-grille normalisées 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, mais une implémentation sous-classée de la méthode recalculate() peut redimensionner le tableau différemment.

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

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

Renvoie une référence au tableau des 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 l'axe parent moins un, mais une implémentation sous-classée de la méthode recalculate() peut redimensionner le tableau différemment.

Voir aussi QValue3DAxis::segmentCount, QValue3DAxis::subSegmentCount, et recalculate().

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

Renvoie la valeur à l'emplacement normalisé position le long de l'axe. La valeur position doit être comprise entre 0.0 (la valeur minimale) et 1.0 (la valeur maximale), inclusivement, afin d'obtenir des valeurs comprises dans la plage de l'axe parent.

Réimplémenter cette méthode si la valeur ne peut pas être résolue par interpolation linéaire entre les valeurs minimale et maximale de l'axe parent.

Voir également recalculate() et positionAt().