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