TXSLib : Class TGraph
La classe TGraph est une classe abstraite qui fournie les fonctionnalités communes aux classes :
- TXYGraph
- TYGraph
Pour une présentation et des exemples d'utilisations détaillés se reporter à la rubrique Tracés de courbes.
Interface opérateur
Cette classe propose deux modes pendant lesquels l'opérateur peut interagir avec le tracé au moyen de la souris et/ou du clavier. Il est également possible d'ajouter des marqueurs sur le tracé.
Marqueurs
L'activation des marqueurs est effectué par un appel à la fonction EnableMarkers. A partir de ce moment en maintenant appuyées les touches ""Ctrl" et "Alt", à chaque fois que l'opérateur clique sur le tracé, pas nécessairement sur une courbe, un marqueur est ajouté à la visualisation à la position de la souris.
Mode Zoom
Dans le mode Zoom, activé via la fonction EnterZoomMode, l'opérateur peut sélectionner à la souris en maintenant son bouton gauche appuyé, un rectangle dans le tracé. Lorsque le bouton gauche est relaché, le tracé effectue un zoom sur le rectangle sélectionné. Si l'appel à la fonction EnterZoomMode l'autorise, via son paramètre, l'opérateur peut mettre fin au mode Zoom via un appui sur la touche F5.
Mode Readout
Dans le mode Readout, activé via la fonction EnterReadoutMode, le tracé affiche deux curseurs. Via la souris, l'opérateur peut sélectionner l'un ou l'autre curseur en placant le pointeur de la souris sur ce dernier (le pointeur modifie sa forme pour deux flêches horizontales). Lorsque le pointeur de souris change de forme, l'opérateur peut déplacer le curseur en déplacant la souris avec le bouton gauche appuyé.
Dans ce mode, si l'appel à la fonction EnterReadoutMode l'autorise via ses paramètres, un certain nombre d'opérations au clavier sont possibles :
| Touche | Modificateur | Fonction |
| Flêche gauche | Aucun | Déplacement vers la gauche du curseur sélectionné |
| Flêche bas | Aucun | Déplacement vers la gauche du curseur sélectionné |
| Flêche gauche | Ctrl | Déplacement accéléré vers la gauche du curseur sélectionné |
| Flêche bas | Ctrl | Déplacement accéléré vers la gauche du curseur sélectionné |
| Flêche gauche | Shift | Déplacement doublement accéléré vers la gauche du curseur sélectionné |
| Flêche bas | Shift | Déplacement doublement accéléré vers la gauche du curseur sélectionné |
| Flêche droite | Aucun | Déplacement vers la droite du curseur sélectionné |
| Flêche haut | Aucun | Déplacement vers la droite du curseur sélectionné |
| Flêche droite | Ctrl | Déplacement accéléré vers la droite du curseur sélectionné |
| Flêche haut | Ctrl | Déplacement accéléré vers la droite du curseur sélectionné |
| Flêche droite | Shift | Déplacement doublement accéléré vers la droite du curseur sélectionné |
| Flêche haut | Shift | Déplacement doublement accéléré vers la droite du curseur sélectionné |
| Page Up | Aucun | Déplacement vers la graduation secondaire suivante du curseur sélectionné |
| Page Down | Aucun | Déplacement vers la graduation secondaire précédente du curseur sélectionné |
| Page Up | Ctrl | Déplacement d'un pas vers la droite du curseur sélectionné |
| Page Down | Ctrl | Déplacement d'un pas vers la gauche du curseur sélectionné |
| Page Up | Shift | Déplacement vers la graduation princiaple suivante du curseur sélectionné |
| Page Down | Shift | Déplacement vers la graduation principale précédente du curseur sélectionné |
| F1 | Aucun | Sélectionne le curseur gauche |
| F1 | Alt | Ajoute un marqueur à la position du curseur gauche (*) |
| F2 | Aucun | Sélectionne le curseur droit |
| F2 | Alt | Ajoute un marqueur à la position du curseur droit (*) |
| F2 | Aucun | Sélectionne des deux curseurs |
| F2 | Alt | Ajoute un marqueur à la position des deux curseurs (*) |
| F4 | Aucun | Zoom entre les deux curseurs (Si autorisé) |
| F5 | Aucun | Désactive le mode Readout (Si autorisé) |
(*) : Si les marqueurs ont été activé via un appel à la fonction EnableMarkers.
Fonctions publiques
| void | AutoPlot(const bool& bAutoXAxes = true, const bool& bAutoYAxes = true) |
| TGraphAxis* | Axis(const TXS::Axis& eAxis)) |
| void | ClearCurves() |
| QList<TCurve *>* | Curves() |
| void | DataPlot() |
| void | DrawOffLine(QPainter* pPainter, const QRectF& rect, const bool& bAutoPlot) |
| TXS::Graph_Mode | GetCurrentMode() |
| void | RemoveCurves() |
| bool | SetAxisUseTimeScale(const TXS::Axis& eAxis, const TXS::TimeFormat& Format, const double& dSampleRate, const QDateTime& tOrig) |
Fonctions publiques des modes Readout et Zoom
| bool | EnterReadoutMode(const bool& bEnableKeyboard = true, const bool& bEnableKeyboardZoom = true, const bool& bEnableKeyboardExit = true) |
| bool | EnterZoomMode(const bool& bEnableExitFromKeyboard = true) |
| void | ExitZoomOrReadoutMode(const bool& bRestoreAxes = true) |
| QDateTime | GetLeftReadoutCursorDateTime(const TXS::Axis& eXAxis = TXS::XBottomAxis, bool* bTF = NULL) |
| QString | GetLeftReadoutCursorFormattedValue(const TXS::Axis& eXAxis = TXS::XBottomAxis, bool* bTF = NULL) |
| double | GetLeftReadoutCursorValue(const TXS::Axis& eXAxis = TXS::XBottomAxis, bool* bTF = NULL) |
| QDateTime | GetRightReadoutCursorDateTime(const TXS::Axis& eXAxis = TXS::XBottomAxis, bool* bTF = NULL) |
| QString | GetRightReadoutCursorFormattedValue(const TXS::Axis& eXAxis = TXS::XBottomAxis, bool* bTF = NULL) |
| double | GetRightReadoutCursorValue(const TXS::Axis& eXAxis = TXS::XBottomAxis, bool* bTF = NULL) |
| void | SelectReadoutCursor(const TXS::Graph_ReadoutCursor& eCursor) |
| bool | ZoomFromReadout(const bool& bAutoYAxes = true) |
Fonctions publiques de manipulation des marqueurs
| bool | AddMarker(const double& Position) |
| void | EnableMarkers(const bool& Enable = true) |
| int | GetMarkersCount() |
| QDateTime | GetMarkerDateTime(const int& nMarker, const TXS::Axis& eXAxis, bool* bTF = NULL) |
| double | GetMarkerValue(const int& nMarker, const TXS::Axis& eXAxis, bool* bTF = NULL) |
| void | RemoveAllMarkers() |
| bool | RemoveMarker(const int& nMarker) |
Signaux publiques
| void | eventZoom() |
| void | eventReadoutCursorMoved(TXS::Graph_ReadoutCursor nCursor, double dXValue) |
| void | eventMarkerAdded(int nMarker, double XValue) |
| void | eventMarkerRemoved(int nMarker) |
Propriétés des axes et de la zone de tracé
| Propriétés | Type | Ecriture | Lecture |
| AxisColor | QColor | SetAxisColor | GetAxisColor |
| AxisDigitsAfterDecimalSeparator | int | SetAxisDigitsAfterDecimalSeparator | GetAxisDigitsAfterDecimalSeparator |
| AxisDigitsBeforeDecimalSeparator | int | SetAxisDigitsBeforeDecimalSeparator | GetAxisDigitsBeforeDecimalSeparator |
| AxisLabelsColor | QColor | SetAxisLabelsColor | GetAxisLabelsColor |
| AxisLabelsFont | QFont | SetAxisLabelsFont | GetAxisLabelsFont |
| AxisLabelsVisible | bool | SetAxisLabelsVisible | GetAxisLabelsVisible |
| AxisMaximum | double | SetAxisMinMax | GetAxisMaximum |
| AxisMinimum | double | SetAxisMinMax | GetAxisMinimum |
| AxisMinorTicksSize | int | SetAxisMinorTicksSize | GetAxisMinorTicksSize |
| AxisMinorTicksVisible | bool | SetAxisMinorTicksVisible | GetAxisMinorTicksVisible |
| AxisNumberFormat | TXS::NumberFormat | SetAxisNumberFormat | GetAxisNumberFormat |
| AxisNumberOfMinorTicks | int | SetAxisNumberOfMinorTicks | GetAxisNumberOfMinorTicks |
| AxisNumberOfTicks | int | SetAxisNumberOfTicks | GetAxisNumberOfTicks |
| AxisPosition | TXS::Axis_Position | SetAxisPosition | GetAxisPosition |
| AxisSampleRate | double | SetAxisSampleRate | GetAxisSampleRate |
| AxisStyle | TXS::LineStyle | SetAxisStyle | GetAxisStyle |
| AxisThickness | int | SetAxisThickness | GetAxisThickness |
| AxisTicksColor | QColor | SetAxisTicksColor | GetAxisTicksColor |
| AxisTicksInterval | double | SetAxisTicksInterval | GetAxisTicksInterval |
| AxisTicksSize | int | SetAxisTicksSize | GetAxisTicksSize |
| AxisTicksSpecification | TXS::TicksSpecification | SetAxisTicksSpecification | GetAxisTicksSpecification |
| AxisTicksVisible | bool | SetAxisTicksVisible | GetAxisTicksVisible |
| AxisTimeFormat | TXS::TimeFormat | SetAxisTimeFormat | GetAxisTimeFormat |
| AxisTimeOrigin | QDateTime | SetAxisTimeOrigin | GetAxisTimeOrigin |
| AxisTitle | QString | SetAxisTitle | GetAxisTitle |
| AxisTitleColor | QColor | SetAxisTitleColor | GetAxisTitleColor |
| AxisTitleFont | QFont | SetAxisTitleFont | GetAxisTitleFont |
| AxisUnitString | TXS::Unit | SetAxisUnitString | GetAxisUnitString |
| AxisUseTimeScale | bool | SetAxisUseTimeScale | GetAxisUseTimeScale |
| AxisVisible | bool | SetAxisVisible | GetAxisVisible |
| PlotAreaColor | QColor | SetPlotAreaColor | GetPlotAreaColor |
| YAutoAxesExtent | unsigned int | SetYAutoAxesExtent | GetYAutoAxesExtent |
Propriétés des marqueurs et des curseurs de mode readout
| Propriétés | Type | Ecriture | Lecture |
| MarkerColor | QColor | SetMarkerColor | GetMarkerColor |
| MarkerShowID | bool | SetMarkerShowID | GetMarkerShowID |
| MarkerShowValue | bool | SetMarkerShowValue | GetMarkerShowValue |
| MarkerStyle | TXS::LineStyle | SetMarkerStyle | GetMarkerStyle |
| MarkerThickness | int | SetMarkerThickness | GetMarkerThickness |
| ReadoutCursorsColor | QColor | SetReadoutCursorsColor | GetReadoutCursorsColor |
| ReadoutCursorsShowPositions | bool | SetReadoutCursorsShowPositions | GetReadoutCursorsShowPositions |
| ReadoutCursorsStyle | TXS::LineStyle | SetReadoutCursorsStyle | GetReadoutCursorsStyle |
| ReadoutCursorsThickness | int | SetReadoutCursorsThickness | GetReadoutCursorsThickness |
Description : Met à jour la visualisation en traçant toutes les courbes contenues par ce graphique.
Paramètre : bAutoXAxes - type bool& - true si les axes X doivent être calculés automatiquement
Paramètre : bAutoYAxes - type bool& - true si les axes Y doivent être calculés automatiquement
Description : Retourne un pointeur de type TGraphAxis vers un axe afin de le manipuler directement. Attention la manipulation directe d'un axe peut être contradictoire avec les propriétés et les fonctionnalitéss de l'objet TGraph. Ce pointeur donne toutefois accès à la grille attachée à l'axe.
Paramètre : eAxis - type TXS::Axis - Axe à retourner.
valeur de retour : Pointeur vers l'axe'
Description : Efface toutes les courbes du graphique et met à jour la visualisation.
Plus de détails : Voir la rubrique RemoveCurves pour faire la différence entre "ClearCurves" et "RemoveCurves".
Description : Retourne un pointeur vers la liste de courbes définies pour ce graphique. Cela permet de manipuler ces courbes directement, d'en ajouter, d'en supprimer, etc....
valeur de retour : Pointeur vers la liste de courbes définie
Description : Met à jour la visualisation en traçant toutes les courbes contenues par ce graphique sans modification des axes.
Description : Permet de tracer le graphique dans un QPainter attaché à un autre QPaintDevice de Qt (Comme, à titre d'exemple : QImage, QPixmap, etc...).
Paramètre : rect - type QRectF& - Zone rectangulaire du QPainter dans laquelle le dessin doit être effectué.
Paramètre : bAutoPlot - type bool - Si ce paramètre vaut true, les axes sont recalculés en fonction des courbes à tracer. Sinon les valeurs minimales et maximales de tous les axes visibles sont conservées.
Description : Retourne le mode de fonctionnement courant de l'objet graphique. Il peut être soit en mode statique (TXS::Graph_Mode_Idle) qui correspond au mode initiale ou à un retour à ce mode initiale par un appel à la méthode ExitZoomOrReadoutMode. Soit en mode zoom (TXS::Graph_Mode_Zoom) mis en service après appel de la méthode EnterZoomMode, soit en mode readout (TXS::Graph_Mode_Readout) après appel de la méthode EnterReadoutMode.
valeur de retour : Le mode de fonctionnement actuel selon l'énumération TXS::Graph_Mode
Description : Supprime toutes les courbes du graphique et met à jour la visualisation. Ne pas confondre cette fonction avec la fonction ClearCurves. Cette fonction supprime les courbes de la liste de courbes mais n'efface pas les courbes de la mémoire. La fonction ClearCurves supprime toutes les courbes de la liste des courbes et efface ces courbes de la mémoire
Description : Lorsqu'un axe X doit être utilisé avec une echelle horodatée, cette méthode est un raccourci vers les méthodes d'écriture des propriétés mettant en oeuvre ce mode :
- AxisSampleRate
- AxisTimeFormat
- AxisTimeOrigin
Paramètre : eAxis - type TXS::Axis& - Axe sur lequel appliquer l'echelle horodatée.
Paramètre : Format - type TXS::TimeFormat& - Format de date et heure
Paramètre : dSampleRate - type double& - Fréquence d'échantillonage entre chaque point de la courbe.
Paramètre : tOrig - type QDateTime& - Date et heure d'origine de l'axe.
valeur de retour : Booléen indiquant le succès ou l'echec de la fonction
Description : Active le mode readout.
Paramètre : bEnableKeyboard - type bool& - true si les touches du clavier définies pour ce mode doivent être activées ou non.
Paramètre : bEnableKeyboardZoom - type bool& - true si les touches du clavier définies pour effectuer un zoom entre les curseurs sont activées ou non.
Paramètre : bEnableKeyboardExit - type bool& - true si les touches du clavier définies pour arrêter le mode readout sont activées ou non.
valeur de retour : Booléen indiquant le succès ou l'echec de la fonction
Description : Active le mode zoom.
Paramètre : bEnableExitFromKeyboard - type bool& - true si les touches du clavier définies pour arrêter le mode zoom sont activées ou non.
valeur de retour : Booléen indiquant le succès ou l'echec de la fonction
Description : Arrête le mode zoom ou le mode readout selon le mode encours.
Paramètre : bRestoreAxes - type bool& - true si les axes doivent être ramenés à leur valeurs d'origines avant l'entre en mdoe readout ou mode zoom.
Description : Retourne la position en date et heure de la position du curseur gauche du mode readout. Cette fonction n'a de sens que si l'axe considéré est en mode horodatage.
Paramètre : eAxis - type TXS::Axis& - Axe duquel extraire la position du curseur.
Paramètre : bTF - type bool* - Pointeur recevant une valeur booléenne indiquant si la valeur retournée est valide ou non.
valeur de retour : Position horodatée du curseur gauche
Description : Retourne la position du curseur gauche du mode readout selon le format de chaines des étiquettes de l'axe.
Paramètre : eAxis - type TXS::Axis& - Axe duquel extraire la position du curseur.
Paramètre : bTF - type bool* - Pointeur recevant une valeur booléenne indiquant si la valeur retournée est valide ou non.
valeur de retour : Position sous forme de chaine de caractères du curseur gauche
Description : Retourne la position du curseur gauche.
Paramètre : eAxis - type TXS::Axis& - Axe duquel extraire la position du curseur.
Paramètre : bTF - type bool* - Pointeur recevant une valeur booléenne indiquant si la valeur retournée est valide ou non.
valeur de retour : Position du curseur gauche
Description : Retourne la position en date et heure de la position du curseur droit du mode readout. Cette fonction n'a de sens que si l'axe considéré est en mode horodatage.
Paramètre : eAxis - type TXS::Axis& - Axe duquel extraire la position du curseur.
Paramètre : bTF - type bool* - Pointeur recevant une valeur booléenne indiquant si la valeur retournée est valide ou non.
valeur de retour : Position horodatée du curseur droit
Description : Retourne la position du curseur droit du mode readout selon le format de chaines des étiquettes de l'axe.
Paramètre : eAxis - type TXS::Axis& - Axe duquel extraire la position du curseur.
Paramètre : bTF - type bool* - Pointeur recevant une valeur booléenne indiquant si la valeur retournée est valide ou non.
valeur de retour : Position sous forme de chaine de caractères du curseur droit
Description : Retourne la position du curseur droit.
Paramètre : eAxis - type TXS::Axis& - Axe duquel extraire la position du curseur.
Paramètre : bTF - type bool* - Pointeur recevant une valeur booléenne indiquant si la valeur retournée est valide ou non.
valeur de retour : Position du curseur droit
Description : Sélectionne le curseur gauche ou droit répondant aux touches du clavier
Paramètre : eCursor - type TXS::Graph_ReadoutCursor& - Curseur gauche ou droit.
Description : Effectue une opération de zoom sur tous les axes pour les valeurs des courbes comprises entre les deux curseurs de readout.
Paramètre : bAutoYAxes - type bool& - True si les axes Y doivent être recalculés.
valeur de retour : Booléen indiquant le succès ou l'echec de la fonction
Description : Ajoute un marqueur.
Paramètre : Position - type double& - Position du marqueur en X.
valeur de retour : Booléen indiquant le succès ou l'echec de la fonction
Description : Active ou désaactive les marqueurs.
Paramètre : Enable - type bool& - true pour activer, false pour désactiver.
Description : Retourne le nombre de marqueurs.
valeur de retour : Nombre de marqueurs
Description : Retourne la position en date et heure de la position d'un marqueur. Cette fonction n'a de sens que si l'axe considéré est en mode horodatage.
Paramètre : nMarker - type int& - Numéro d'ordre du marqueur.
Paramètre : eAxis - type TXS::Axis& - Axe duquel extraire la position du marqueur.
Paramètre : bTF - type bool* - Pointeur recevant une valeur booléenne indiquant si la valeur retournée est valide ou non.
valeur de retour : Position horodatée du marqueur.
Description : Retourne la position d'un marqueur.
Paramètre : nMarker - type int& - Numéro d'ordre du marqueur.
Paramètre : eAxis - type TXS::Axis& - Axe duquel extraire la position du marqueur.
Paramètre : bTF - type bool* - Pointeur recevant une valeur booléenne indiquant si la valeur retournée est valide ou non.
valeur de retour : Position du marqueur
Description : Supprime tous les marqueurs.
Description : Supprime un marqueur.
Paramètre : nMarker - type int& - Numéro d'ordre du marqueur à supprimer.
valeur de retour : Booléen indiquant le succès ou l'echec de la fonction
Description : Ce signal est émis à chaque opération de zooming par l'utilisateur.
Description : Ce signal est émis à chaque mouvement d'un curseur de mode readout par l'utilisateur.
Paramètre : nCursor - type TXS::Graph_ReadoutCursor& - Curseur gauche ou droit
Paramètre : dXValue - type unsigned long - Position du curseur
Description : Ce signal est émis à chaque ajout d'un marqueur par l'utilisateur.
Paramètre : nMarker - type int - Numéro d'ordre du marqueur
Paramètre : dXValue - type unsigned long - Position du marqueur
Description : Ce signal est émis à chaque suppression d'un marqueur par l'utilisateur.
Paramètre : nMarker - type int - Numéro d'ordre du marqueur
Description : Cette propriété définie la couleur d'un axe. Cette propriété est paramétrée. Elle reçoit comme paramètre l'axe de type TXS::Axis auquel appartient la propriété à écrire ou à lire.
Type : QColor
Valeur par défaut : QColor(255,255,255,255) : Blanc
Ecriture : SetAxisColor(const TXS::Axis& eAxis, const QColor& Color)
Lecture : QColor GetAxisColor(const TXS::Axis& eAxis)
Description : Cette propriété définie le nombre de chiffres après le séparateur décimal pour les étiquettes d'un axe. Cette propriété est paramétrée. Elle reçoit comme paramètre l'axe de type TXS::Axis auquel appartient la propriété à écrire ou à lire. Le comportement de cette propriété dépend de la valeur de la propriété AxisNumberFormat.
Plus de détails : Formatage des nombres
Type : int
Valeur par défaut : 6
Ecriture : void SetAxisDigitsAfterDecimalSeparator(const TXS::Axis& eAxis, const int& nDigits)
Lecture : int GetAxisDigitsAfterDecimalSeparator(const TXS::Axis& eAxis);
Description : Cette propriété définie le nombre de chiffres avant le séparateur décimal pour les étiquettes d'un axe. Cette propriété est paramétrée. Elle reçoit comme paramètre l'axe de type TXS::Axis auquel appartient la propriété à écrire ou à lire. Le comportement de cette propriété dépend de la valeur de la propriété AxisNumberFormat.
Plus de détails : Formatage des nombres
Type : int
Valeur par défaut : 6
Ecriture : void SetAxisDigitsBeforeDecimalSeparator(const TXS::Axis& eAxis, const int& nDigits)
Lecture : int GetAxisDigitsBeforeDecimalSeparator(const TXS::Axis& eAxis);
Description : Cette propriété définie la couleur des étiquettes d'un axe. Cette propriété est paramétrée. Elle reçoit comme paramètre l'axe de type TXS::Axis auquel appartient la propriété à écrire ou à lire.
Type : QColor
Valeur par défaut : QColor(255,255,255,255) : Blanc
Ecriture : SetAxisLabelsColor(const TXS::Axis& eAxis, const QColor& Color)
Lecture : QColor GetAxisLabelsColor(const TXS::Axis& eAxis)
Description : Cette propriété définie la police de caractères des étiquettes d'un axe. Cette propriété est paramétrée. Elle reçoit comme paramètre l'axe de type TXS::Axis auquel appartient la propriété à écrire ou à lire.
Type : QFont
Valeur par défaut : Police de caractères par défaut de l'application
Ecriture : SetAxisLabelsFont(const TXS::Axis& eAxis, const QFont& Font)
Lecture : QFont GetAxisLabelsFont(const TXS::Axis& eAxis)
Description : Cette propriété définie si les étiquettes d'un axe sont visibles ou non. Cette propriété est paramétrée. Elle reçoit comme paramètre l'axe de type TXS::Axis auquel appartient la propriété à écrire ou à lire.
Type : bool
Valeur par défaut : true
Ecriture : SetAxisLabelsVisible(const TXS::Axis& eAxis, const Bool& Tf)
Lecture : bool GetAxisLabelsVisible(const TXS::Axis& eAxis)
Description : Cette propriété définie la borne maximale d'un axe. Cette propriété est paramétrée. Elle reçoit comme paramètre l'axe de type TXS::Axis auquel appartient la propriété à écrire ou à lire. La fonction d'écriture est utilisée pour cette propriété et pour la propriété AxisMinimum afin de vérifier la cohérence de ces 2 propriétés. Selon la valeur réglée pour la propriété AxisTicksSpecification, ces deux propriétés peuvent être modifiées par l'algorithme de calcul des extermums des axes. Les fonctions de lectures peuvent donc donner des valeurs différentes à celles passées à la fonction d'écriture.
Type : double
Valeur par défaut : 0
Ecriture : void SetAxisMinMax(const TXS::Axis& eAxis, const double& Min, const double& Max, const bool& bRefresh = true)
Lecture : double GetAxisMaximum(const TXS::Axis& eAxis)
Description : Cette propriété définie la borne minimale d'un axe. Cette propriété est paramétrée. Elle reçoit comme paramètre l'axe de type TXS::Axis auquel appartient la propriété à écrire ou à lire. La fonction d'écriture est utilisée pour cette propriété et pour la propriété AxisMaximum afin de vérifier la cohérence de ces 2 propriétés. Selon la valeur réglée pour la propriété AxisTicksSpecification, ces deux propriétés peuvent être modifiées par l'algorithme de calcul des extermums des axes. Les fonctions de lectures peuvent donc donner des valeurs différentes à celles passées à la fonction d'écriture.
Type : double
Valeur par défaut : 0
Ecriture : void SetAxisMinMax(const TXS::Axis& eAxis, const double& Min, const double& Max, const bool& bRefresh = true)
Lecture : double GetAxisMinimum(const TXS::Axis& eAxis)
Description : Cette propriété définie la longueur en pixels des graduations secondaires de l'axe. Cette propriété est paramétrée. Elle reçoit comme paramètre l'axe de type TXS::Axis auquel appartient la propriété à écrire ou à lire.
Plus de détails : Gestion des axes
Type : int
Valeur par défaut : 5
Ecriture : void SetAxisMinorTicksSize(const TXS::Axis& eAxis, const int& Size)
Lecture : int GetAxisMinorTicksSize(const TXS::Axis& eAxis)
Description : Cette propriété définie si les graduations secondaires de l'axe sont visibles ou non. Cette propriété est paramétrée. Elle reçoit comme paramètre l'axe de type TXS::Axis auquel appartient la propriété à écrire ou à lire.
Plus de détails : Gestion des axes
Type : bool
Valeur par défaut : true
Ecriture : void SetAxisMinorTicksVisible(const TXS::Axis& eAxis, const bool& Tf)
Lecture : bool GetAxisMinorTicksVisible(const TXS::Axis& eAxis)
Description : Cette propriété définie le format d'affichage des nombres des étiquettes des graduations principales de l'axe. Cette propriété est paramétrée. Elle reçoit comme paramètre l'axe de type TXS::Axis auquel appartient la propriété à écrire ou à lire.
Plus de détails : Formatage des nombres
Type : TXS::NumberFormat
Valeur par défaut : TXS::NumberFormat_Any_Compact.
Ecriture : void SetAxisNumberFormat(const TXS::Axis& eAxis, const TXS::NumberFormat& Format)
Lecture : TXS::NumberFormat GetAxisNumberFormat(const TXS::Axis& eAxis)
Description : Cette propriété définie le nombre de graduations secondaires entre deux graduations principales de l'axe. Cette propriété est paramétrée. Elle reçoit comme paramètre l'axe de type TXS::Axis auquel appartient la propriété à écrire ou à lire.
Plus de détails : Gestion des axes
Type : int
Valeur par défaut : 5
Ecriture : void SetAxisNumberOfMinorTicks(const TXS::Axis& eAxis, const int& Ticks)
Lecture : int GetAxisNumberOfMinorTicks(const TXS::Axis& eAxis)
Description : Cette propriété définie le nombre de graduations principales de l'axe. Le comportement de cette propriété est liée à la valeur courante de la propriété AxisTicksSpecification. Selon la valeur de cette dernière la propriété "AxisNumberOfTicks" sera ou non prise en compte. Cette propriété est paramétrée. Elle reçoit comme paramètre l'axe de type TXS::Axis auquel appartient la propriété à écrire ou à lire.
Plus de détails : Gestion des axes
Type : int
Valeur par défaut : 11
Ecriture : virtual void SetAxisNumberOfTicks(const TXS::Axis& eAxis, const int& Ticks)
Lecture : int GetAxisNumberOfTicks(const TXS::Axis& eAxis)
Description : Cette propriété définie la position d'un axes relativement aux axes perpendiculaires. Un axe X peut être placé en bas, en haut, au centre ou à la valeur 0 d'un axe Y et réciproquement. Cette propriété est paramétrée. Elle reçoit comme paramètre l'axe de type TXS::Axis auquel appartient la propriété à écrire ou à lire. La fonction d'écriture retourne un booléen indiquant le succès ou l'chec de la fonction.
Type : TXS::Axis_Position
Valeur par défaut : Selon l'axe
Ecriture : bool SetAxisPosition(const TXS::Axis& eAxis, const TXS::Axis_Position& Position)
Lecture : TXS::Axis_Position GetAxisPosition(const TXS::Axis& eAxis)
Description : Cette propriété définie la fréquence à laquelle les points successifs d'un axe doivent être incrémentés lorsque cet axe utilise une echelle horodatée. Cette propriété est paramétrée. Elle reçoit comme paramètre l'axe de type TXS::Axis auquel appartient la propriété à écrire ou à lire.
Type : double (Exprimée en Hertz)
Valeur par défaut : 100
Ecriture : void SetAxisSampleRate(const TXS::Axis& eAxis, const double& dSampleRate)
Lecture : double GetAxisSampleRate(const TXS::Axis& eAxis)
Description : Cette propriété définie le style de ligne d'un axe. Cette propriété est paramétrée. Elle reçoit comme paramètre l'axe de type TXS::Axis auquel appartient la propriété à écrire ou à lire.
Type : TXS::LineStyle
Valeur par défaut : TXS::SolidLine
Ecriture : void SetAxisStyle(const TXS::Axis& eAxis, const TXS::LineStyle& Style)
Lecture : TXS::LineStyle GetAxisStyle(const TXS::Axis& eAxis)
Description : Cette propriété définie l'épaisseur de ligne d'un axe. Cette propriété est paramétrée. Elle reçoit comme paramètre l'axe de type TXS::Axis auquel appartient la propriété à écrire ou à lire.
Type : int
Valeur par défaut : 1
Ecriture : void SetAxisThickness(const TXS::Axis& eAxis, const int& Thickness)
Lecture : int GetAxisThickness(const TXS::Axis& eAxis)
Description : Cette propriété définie la couleur des graduations principales d'un axe. Cette propriété est paramétrée. Elle reçoit comme paramètre l'axe de type TXS::Axis auquel appartient la propriété à écrire ou à lire.
Type : QColor
Valeur par défaut : QColor(255,255,255,255) : Blanc
Ecriture : SetAxisTicksColor(const TXS::Axis& eAxis, const QColor& Color)
Lecture : QColor GetAxisTicksColor(const TXS::Axis& eAxis)
Description : Cette propriété définie l'intervalle entre les graduations principales de l'axe. Le comportement de cette propriété est liée à la valeur courante de la propriété AxisTicksSpecification. Selon la valeur de cette dernière la propriété "AxisTicksInterval" sera ou non prise en compte.
Plus de détails : Gestion des axes
Type : double
Valeur par défaut : 10
Ecriture : void SetScaleTicksInterval(const TXS::Axis& eAxis, const double& Interval)
Lecture : double GetScaleTicksInterval(const TXS::Axis& eAxis)
Description : Cette propriété définie la longueur en pixels des graduations principales de l'axe. Cette propriété est paramétrée. Elle reçoit comme paramètre l'axe de type TXS::Axis auquel appartient la propriété à écrire ou à lire.
Plus de détails : Gestion des axes
Type : int
Valeur par défaut : 10
Ecriture : void SetAxisTicksSize(const TXS::Axis& eAxis, const int& Size)
Lecture : int GetAxisTicksSize(const TXS::Axis& eAxis)
Description : Cette propriété définie le choix de l'algorithme de calcul des valeurs des graduations principales de l'axe. Cette propriété est paramétrée. Elle reçoit comme paramètre l'axe de type TXS::Axis auquel appartient la propriété à écrire ou à lire.
Une explication détaillée est documentée à la page : Gestion des axes
Type : TXS::TicksSpecification
Valeur par défaut : TXS::TicksSpecification_Adjusted
Ecriture : void SetAxisTicksSpecification(const TXS::Axis& eAxis, const TXS::TicksSpecification& Specification)
Lecture : TXS::TicksSpecification GetAxisTicksSpecification(const TXS::Axis& eAxis)
Description : Cette propriété définie si les graduations principales de l'axe sont visibles ou non. Cette propriété est paramétrée. Elle reçoit comme paramètre l'axe de type TXS::Axis auquel appartient la propriété à écrire ou à lire.
Plus de détails : Gestion des axes
Type : bool
Valeur par défaut : true
Ecriture : void SetAxisTicksVisible(const TXS::Axis& eAxis, const bool& Tf)
Lecture : bool GetAxisTicksVisible(const TXS::Axis& eAxis)
Description : Cette propriété définie le format de date et/ou heure lorsque cet axe utilise une echelle horodatée. Cette propriété est paramétrée. Elle reçoit comme paramètre l'axe de type TXS::Axis auquel appartient la propriété à écrire ou à lire.
Type : TXS::TimeFormat
Valeur par défaut : TXS::TimeFormat_SSfff
Ecriture : void SetAxisTimeFormat(const TXS::Axis& eAxis, const TXS::TimeFormat& Format)
Lecture : TXS::TimeFormat GetAxisTimeFormat(const TXS::Axis& eAxis)
Description : Cette propriété définie la date et l'heure d'origine lorsque cet axe utilise une echelle horodatée. Cette propriété est paramétrée. Elle reçoit comme paramètre l'axe de type TXS::Axis auquel appartient la propriété à écrire ou à lire.
Type : QDateTime
Valeur par défaut : 1/1/1 à 0:00:00.000 heure
Ecriture : void SetAxisTimeOrigin(const TXS::Axis& eAxis, const QDateTime& Origin)
Lecture :QDateTime GetAxisTimeOrigin(const TXS::Axis& eAxis)
Description : Cette propriété définie le titre d'un axe Cette propriété est paramétrée. Elle reçoit comme paramètre l'axe de type TXS::Axis auquel appartient la propriété à écrire ou à lire.
Type : QString
Valeur par défaut : Chaine vide
Ecriture : void SetAxisTitle(const TXS::Axis& eAxis, const QString& Title)
Lecture :QString GetAxisTitle(const TXS::Axis& eAxis)
Description : Cette propriété définie la couleur du titre d'un axe. Cette propriété est paramétrée. Elle reçoit comme paramètre l'axe de type TXS::Axis auquel appartient la propriété à écrire ou à lire. Cette propriété est paramétrée. Elle reçoit comme paramètre l'axe de type TXS::Axis auquel appartient la propriété à écrire ou à lire.
Type : QColor
Valeur par défaut : QColor(255,255,255,255) : Blanc
Ecriture : SetAxisTitleColor(const TXS::Axis& eAxis, const QColor& Color)
Lecture : QColor GetAxisTitleColor(const TXS::Axis& eAxis)
Description : Cette propriété définie la police de caractères du titre d'un axe. Cette propriété est paramétrée. Elle reçoit comme paramètre l'axe de type TXS::Axis auquel appartient la propriété à écrire ou à lire.
Type : QFont
Valeur par défaut : Police de caractères par défaut de l'application
Ecriture : SetAxisTitleFont(const TXS::Axis& eAxis, const QFont& Font)
Lecture : QFont GetAxisTitleFont(const TXS::Axis& eAxis)
Description : Cette propriété définie l'unité de mesure d'un axe.
Cette propriété recouvre deux paramètres. Il n'y a qu'une fonction d'écriture pour les 2 paramètres et 2 fonctions de lecture, une pour chaque paramètre. Si le paramètre de type TXS::Unit est fixé à la valeur TXS::Unit_userdefined, alors l'unité est définie par le paramètre de type QString. Cette propriété est paramétrée. Elle reçoit comme paramètre l'axe de type TXS::Axis auquel appartient la propriété à écrire ou à lire.
Plus de détails : Formatage des nombres
Type : TXS::Unit et QString
Valeur par défaut : TXS::Unit_nounit et ""
Ecriture : void SetAxisUnitString(const TXS::Axis& eAxis, const TXS::Unit& eUnit, const QString& strUserDefinedUnit)
Lecture : TXS::Unit GetAxisUnit(const TXS::Axis& eAxis);
Lecture : QString GetAxisUserDefinedUnitString(const TXS::Axis& eAxis);
Description : Cette propriété active ou désactive le mode d'affichage en horodatage d'un axe. Les propriétés de paramétrage de l'horodatage étant :
- AxisSampleRate
- AxisTimeFormat
- AxisTimeOrigin
Ces propriétés pouvant être également ajustées via la fonciton : SetAxisUseTimeScale.
Cette propriété est paramétrée. Elle reçoit comme paramètre l'axe de type TXS::Axis auquel appartient la propriété à écrire ou à lire.
Plus de détails : Gestion des axes
Type : bool
Valeur par défaut : false
Ecriture : void SetAxisUseTimeScale(const TXS::Axis& eAxis, const bool& Tf)
Lecture : bool GetAxisUseTimeScale(const TXS::Axis& eAxis)
Description : Cette propriété définie si un axe est visible ou non. Cette propriété est paramétrée. Elle reçoit comme paramètre l'axe de type TXS::Axis auquel appartient la propriété à écrire ou à lire.
Type : bool
Valeur par défaut : true
Ecriture : void SetAxisVisible(const TXS::Axis& eAxis, const bool& Tf)
Lecture : bool GetAxisVisible(const TXS::Axis& eAxis)
Description : Cette propriété exprimée en pourcent (%) définie une extension des axes Y par rapport à leur valeurs minimales et maximales. Cela permet aux courbes de ne pas tangenter l'extreémité de la zone de tracé. Si cette valeur est différente de zéro, la valeur minimale est abaissée de la valeur totale de l'étendue de l'axe à laquelle s'additione le rapport en pourcentage de cette étendue. Réciproquement pour la valeur maximale de l'axe.
Type : unsigned int
Valeur par défaut :0
Ecriture : bool SetYAutoAxesExtent(const QColor& Color)
Lecture : unsigned int GetYAutoAxesExtent()
Description : Cette propriété définie la couleur d'un marqueur. la fonction d'écriture retourne un booléen indiquant le succès ou l'echec de la méthode. Un echec correspond au fait que le marqueur au numéro d'ordre indiqué n'existe pas. Cette propriété est paramétrée. Elle reçoit comme paramètre le numéro d'ordre du marqueur.
Type : QColor
Valeur par défaut : QColor(0,255,255,255) : Cyan
Ecriture : bool SetMarkerColor(const int& nMarker, const QColor& Color)
Lecture : QColor GetMarkerColor(const int& nMarker)
Description : Cette propriété définie si un marqueur est affiché accompagné de son numéro d'ordre. la fonction d'écriture retourne un booléen indiquant le succès ou l'echec de la méthode. Un echec correspond au fait que le marqueur au numéro d'ordre indiqué n'existe pas. Cette propriété est paramétrée. Elle reçoit comme paramètre le numéro d'ordre du marqueur.
Type : bool
Valeur par défaut : true
Ecriture : bool SetMarkerShowID(const int& nMarker, const bool& Tf)
Lecture : bool GetMarkerShowID(const int& nMarker)
Description : Cette propriété définie si un marqueur est affiché accompagné de sa valeur. la fonction d'écriture retourne un booléen indiquant le succès ou l'echec de la méthode. Un echec correspond au fait que le marqueur au numéro d'ordre indiqué n'existe pas. Cette propriété est paramétrée. Elle reçoit comme paramètre le numéro d'ordre du marqueur.
Type : bool
Valeur par défaut : true
Ecriture : bool SetMarkerShowValue(const int& nMarker, const bool& Tf)
Lecture : bool GetMarkerShowValue(const int& nMarker)
Description : Cette propriété définie le style d'un marqueur. La fonction d'écriture retourne un booléen indiquant le succès ou l'echec de la méthode. Un echec correspond au fait que le marqueur au numéro d'ordre indiqué n'existe pas. Cette propriété est paramétrée. Elle reçoit comme paramètre le numéro d'ordre du marqueur.
Type : TXS::LineStyle
Valeur par défaut : TXS::SolidLine
Ecriture : void SetMarkerStyle(const int& nMarker, const TXS::LineStyle& Style)
Lecture : TXS::LineStyle GetMarkerStyle(const int& nMarker)
Description : Cette propriété définie l'épaisseur d'un marqueur.La fonction d'écriture retourne un booléen indiquant le succès ou l'echec de la méthode. Un echec correspond au fait que le marqueur au numéro d'ordre indiqué n'existe pas. Cette propriété est paramétrée. Elle reçoit comme paramètre le numéro d'ordre du marqueur.
Type : int
Valeur par défaut : 1
Ecriture : void SetMarkerThickness(const int& nMarker, const int& Thickness)
Lecture : int GetMarkerThickness(const int& nMarker)
Description : Cette propriété définie la couleur des curseurs de mode readout.
Type : QColor
Valeur par défaut : QColor(255, 255, 0, 255) : Jaune
Ecriture : SetReadoutCursorsColor(const QColor& Color)
Lecture : QColor GetReadoutCursorsColor()
Description : Cette propriété si les curseurs de mode readout affichent leur position en X.
Type : bool
Valeur par défaut : true
Ecriture : SetReadoutCursorsShowPositions(const bool& Tf)
Lecture : bool GetReadoutCursorsShowPositions()
Description : Cette propriété définie le style de ligne des curseurs de mode readout.
Type : TXS::LineStyle
Valeur par défaut : TXS::DotLine
Ecriture : SetReadoutCursorsStyle(const TXS::LineStyle& Style)
Lecture : TXS::LineStyle GetReadoutCursorsStyle()
Description : Cette propriété définie l'épaisseur des curseurs de mode readout.
Type : int
Valeur par défaut : 1
Ecriture : void SetReadoutCursorsThickness(const int& Thickness)
Lecture : int GetReadoutCursorsThickness()