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.

[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() 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. Les valeurs doivent être comprises entre 0.0 (valeur minimale) et 1.0 (valeur maximale), inclus.

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

[protected] 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. Les valeurs doivent être comprises entre 0.0 (valeur minimale) et 1.0 (valeur maximale), inclus. 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] QStringList &QValue3DAxisFormatter::labelStrings() const

Renvoie une référence à la liste de chaînes contenant les chaînes d'étiquettes du formateur. La taille du tableau doit être égale à celle du tableau des positions d'étiquettes, auxquelles les index correspondent également.

Voir également 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 « modifié », 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) const

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, appelez 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 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 à redimensionner et à remplir.

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::setLocale(const QLocale &locale)

Définit la locale utilisée par ce formateur. Le graphique définit automatiquement la 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 du graphique change.

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

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

Renvoie la chaîne d'étiquette formatée à l'aide des 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() 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 l’axe parent moins un ; toutefois, une implémentation sous-classée de la méthode ` recalculate()` peut redimensionner le tableau différemment. Les valeurs doivent être comprises entre 0.0 (valeur minimale) et 1.0 (valeur maximale), inclus.

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

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

Renvoie la valeur correspondant à l'position normalisée le long de l'axe. La valeur d'position doit être comprise entre 0.0 (valeur minimale) et 1.0 (valeur maximale), inclus, afin d'obtenir des valeurs comprises 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().