SChartControl

Einfache Klasse für ein Diagramm-Control um den zeitlichen Verlauf eines Wertes zu visualisieren.

Vererbung

Basisklassen(n)   abgeleitete Klassen
  SWindow
SControl
SControlPositioned
SChartControl  

Attribute

protected:

Attribut Typ Beschreibung
bgColor COLORREF
bitmapBg SImage
data SRingBuffer
dataRect SRect
lineColor COLORREF
valMax int
valMin int

Operationen

public:

Name Parameter Rückgabewert Beschreibung
addValue int newValue void Fügt einen neuen Wert hinzu.
loadBgImage const SString& fileName void Lädt ein Hintergrundbild.
setBufferSize int size void Legt die Anzahl der darzustellenden Werte fest.
setColor COLORREF colorLine,
COLORREF colorBg=SDEV_NOCOLOR
void Legt die Linienfarbe sowie die Hintergrundfarbe fest.
setDataRect int left,
int top,
int width,
int height
void Legt den Bereich fest, in dem die Kurve dargestellt werden soll.
setRange int minValue,
int maxValue
void Legt den Wertebereich fest.

protected:

Name Parameter Rückgabewert Beschreibung
onEraseBackground SDevice& screen BOOL Zeichnet den Hintergrund (Bitmap oder Füllfarbe).
onPaint SDevice& screen void Zeichnet das Diagramm.

Detailbeschreibung SChartControl

Einfache Klasse für ein Diagramm-Control um den zeitlichen Verlauf eines Wertes zu visualisieren.

Funktionsbeschreibungen

addValue(int newValue) void

Fügt einen neuen Wert hinzu.

Parameter:

newValue neuer Wert

loadBgImage(const SString& fileName) void

Lädt ein Hintergrundbild.

Das Bild muss im BMP-Format vorliegen. Es sollte die gleiche Größe wie das Control besitzen. Das Hintergundbild wird links-oben, nicht gekachelt und nicht gestreckt dargestellt.

Parameter:

fileName Dateiname [mit Pfad].

onEraseBackground(SDevice& screen) BOOL

Zeichnet den Hintergrund (Bitmap oder Füllfarbe).

onPaint(SDevice& screen) void

Zeichnet das Diagramm.

setBufferSize(int size) void

Legt die Anzahl der darzustellenden Werte fest.

setColor(COLORREF colorLine, COLORREF colorBg=SDEV_NOCOLOR) void

Legt die Linienfarbe sowie die Hintergrundfarbe fest.

Die Hintergrundfarbe wird nur verwendet, wenn kein Hintergrundbild geladen wird.

Parameter:

colorLine Linienfarbe, z.B. RGB(255,0,0) für Rot
colorBg Hintergrundfarbe

setDataRect(int left, int top, int width, int height) void

Legt den Bereich fest, in dem die Kurve dargestellt werden soll.

Sobald ein solches Rechteck angegeben ist, wird die Kurve nicht mehr mit dem Control gestreckt.

setRange(int minValue, int maxValue) void

Legt den Wertebereich fest.

minValue und maxValue werden gegebenenfalls umsortiert.

Parameter:

minValue kleinster möglicher Wert
maxValue größter möglicher Wert