XYSetErrorbarConfig¶
XYSetErrorbarConfig setzt die Fehlerbalkeneinstellungen.
- bool = XYSetErrorbarConfig(hData, ssXY, rvConfig)
Returnwert
bool ist TRUE (1), wenn die Funktion erfolgreich war und sonst FALSE (0). .. us.params
Parameter
- hData
hData ist die Zugriffsnummer (Handle) des Datensatzes der mit XYCreate oder TYCreate erzeugt wurde.
- ssXY
ssXY ist ein skalarer String. Für den String „X“ wird die Konfiguration der x-Fehlerbalken und für „Y“ die Konfiguration der y-Fehlerbalken erfragt.
- rvConfig
rvConfig ist ein Vektor mit 5 Elementen:
Wert
Name
Bedeutung
rvConfig[1]
Pen
Pen Handle des Zeichenstifts.
rvConfig[2]
LineWidthCap
Liniendicke der Querstrichs in Schritten von 0.1 mm.
rvConfig[3]
CapWidth
Breite des Querstrichs in cm. Bei einer Breite von 0 wird kein Querstrich gezeichnet.
rvConfig[4]
dValue
Fehlerwert. Die Bedeutung ist abhängig vom Attribut-Wert.
rvConfig[5]
Attribut
Siehe nächste Tabelle.
Das Element rvConfig[5] (Attribut) kann eine Kombination der folgenden Werte sein:
Name
Wert
Bedeutung
0
Keine Fehlerbalken ausgeben
ERRORBAR_PERCENT
1
Fehlerwert in Prozent
ERRORBAR_CONSTANT
2
Fehlerwert absolut
ERRORBAR_PLUS
8
Positiven Fehlerbalken ausgeben
ERRORBAR_MINUS
16
Negativen Fehlerbalken ausgeben
ERRORBAR_PLUSMINUS
24
Positiven und negativen Fehlerbalken ausgeben
Kommentar
Die Funktion liefert eine Kopie des Zeichenstifts. Nachdem der Zeichenstift nicht mehr benötigt wird, muss er mit PenDestroy gelöscht werden, um ein Speicherleck zu vermeiden.
Beispiel
XYSetStyle(hData, XY_SHOWLINE | XY_SHOWERRORBARS);
rvConfig = XYGetErrorbarConfig(hData, "Y");
rvConfig[4] = 0.03; // Percent
rvConfig[5] = ERRORBAR_PERCENT | ERRORBAR_PLUSMINUS; // Attrib
XYSetErrorbarConfig(hData, "Y", rvConfig);
PenDestroy(rvConfig[1]); // Delete Pen
// Do not display x-errorbars
rvConfig = XYGetErrorbarConfig(hData, "X");
rvConfig[5] = 0; // switch off
XYSetErrorbarConfig(hData, "X", rvConfig);
PenDestroy(rvConfig[1]); // Delete Pen
Siehe auch
id-288974