|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjava.awt.Component
java.awt.Container
schmitzm.swing.ExpansionBar
public class ExpansionBar
Ein ExpansionBar aehnelt einem JProgressBar
, mit dem Unterschied,
dass die Auspraegung des ExpansionBar nicht nur in eine Richtung gehen
kann (unten nach oben, oder links nach rechts), sondern ausgehend von einem
vorgegebenen Mitte-Wert in beide Richtungen, je nachdem, ob der gesetzte
Wert groesser oder kleiner ist als der Mitte-Wert.
Waehrend der JProgressBar
als Status-Balken aufgefasst werden kann,
der stetig fortschreitet, dient der der ExpansionBar auch der Anzeige von
negativen Werten (z.B. Abweichungswerten oder Amplituden). Fuer die
Abweichung koennen je ein oberer und unterer Grenzwert festgelegt werden.
Liegt der aktuelle Wert des Balken innerhalb dieser Toleranz, wird er
gruen angezeigt, ansonsten rot.
Optional koennen fuer den Balken Labels mit den Grenz-Werten (Minimum,
Mitte, Maximum) angezeigt werden (siehe setValueLabelsPainted(boolean)
.
Dies ist per Default jedoch deaktiviert.
Bemerke:
Bei vertikaler Darstellung gibt es noch Probleme mit der Label-Darstellung!
Nested Class Summary |
---|
Nested classes/interfaces inherited from class java.awt.Container |
---|
Container.AccessibleAWTContainer |
Nested classes/interfaces inherited from class java.awt.Component |
---|
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy |
Field Summary | |
---|---|
protected int |
fracFact
Speichert den Umrechnungsfaktor, um von den gesetzten double-Werten auf Integer fuer die JProgressBar -Instanzen umzurechnen. |
static int |
HORIZONTAL
Konstante fuer eine horizontale Ausrichtung des Balken. |
protected Color |
intoleranceColor
Speichert die Farbe, in der der Balken angezeigt wird, wenn der Wert ausserhalb der Toleranz liegt. |
static int |
LINEAR
Konstante fuer eine lineare Darstellung des Balken. |
static int |
LOGARITHMIC
Konstante fuer eine logarithmische Darstellung des Balken. |
protected Color |
toleranceColor
Speichert die Farbe, in der der Balken angezeigt wird, wenn der Wert innerhalb der Toleranz liegt. |
static int |
VERTICAL
Konstante fuer eine vertikale Ausrichtung des Balken. |
Fields inherited from class java.awt.Component |
---|
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT |
Fields inherited from interface java.awt.image.ImageObserver |
---|
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH |
Constructor Summary | |
---|---|
ExpansionBar(int orient,
double min,
double max,
double mid,
double tol,
NumberFormat form)
Erzeugt einen neuen linearen Balken. |
|
ExpansionBar(int orient,
double min,
double max,
double tol,
NumberFormat form)
Erzeugt einen neuen linearen Balken. |
|
ExpansionBar(int orient,
int type,
double min,
double max,
double mid,
double minTol,
double maxTol,
double initValue,
NumberFormat barForm,
NumberFormat infoForm)
Erzeugt einen neuen Balken. |
|
ExpansionBar(int orient,
int type,
double min,
double max,
double mid,
double tol,
NumberFormat form)
Erzeugt einen neuen Balken. |
|
ExpansionBar(int orient,
int type,
double min,
double max,
double tol,
NumberFormat form)
Erzeugt einen neuen Balken. |
Method Summary | |
---|---|
protected void |
checkValues()
Prueft die durch den Konstruktor gesetzten Initialisierungswerte auf korrektheit. |
protected int |
convertToProgressBarValue(double val)
Der ExpansionBar ist ueber zwei JProgressBar s realisiert. |
Color |
getBackground()
Liefert die Hintergrund-Farbe des Balkens. |
Color |
getForeground()
Liefert die aktuelle Vordergrund-Farbe des Balkens. |
Color |
getIntoleranceColor()
Liefert die Farbe, die angezeigt wird, wenn der Balkenwert ausserhalb der Toleranz liegt. |
double |
getMaximum()
Liefert den Maximum-Wert des Balkens. |
double |
getMaximumTolerance()
Liefert den (absoluten) Wert nach oben, bis zu dessen Wert der Balkens in gruen dargstellt wird. |
double |
getMiddle()
Liefert den Mitte-Wert des Balkens. |
double |
getMinimum()
Liefert den Minimum-Wert des Balkens. |
double |
getMinimumTolerance()
Liefert den (absoluten) Wert nach unten, bis zu dessen Wert der Balkens in gruen dargstellt wird. |
boolean |
getStringPainted()
Prueft, ob der Balken-Wert angezeigt wird. |
Color |
getToleranceColor()
Liefert die Farbe, die angezeigt wird, wenn der Balkenwert innerhalb der Toleranz liegt. |
double |
getValue()
Liefert den aktuellen Wert des Balkens. |
boolean |
getValueLabelsPainted()
Prueft, ob die Minimum/Mitte/Maximum-Labels angezeigt werden. |
void |
setBackground(Color color)
Setzt die Hintergrund-Farbe des Balkens. |
void |
setForeground(Color color)
Setzt die Vordergrundfarbe des Balken unabhaengig davon, ob der Wert innerhalb oder ausserhalb der Toleranz liegt. |
void |
setIntoleranceColor(Color color)
Setzt die Farbe, die angezeigt wird, wenn der Balkenwert ausserhalb der Toleranz liegt. |
void |
setMaximumTolerance(double maxTol)
Setzt den (absoluten) Wert nach oben, bis zu dessen Wert der Balkens in gruen dargstellt wird. |
void |
setMinimumTolerance(double minTol)
Setzt den (absoluten) Wert nach unten, bis zu dessen Wert der Balkens in gruen dargstellt wird. |
void |
setStringPainted(boolean strPaint)
Zeigt den Balken-Wert an oder verbirgt ihn. |
void |
setToleranceColor(Color color)
Setzt die Farbe, die angezeigt wird, wenn der Balkenwert innerhalb der Toleranz liegt. |
void |
setValue(double value)
Setzt den aktuellen Wert des Balkens. |
void |
setValueLabelsPainted(boolean visible)
Zeigt die Minimum/Mitte/Maximum-Labels an oder verbirgt sie. |
protected void |
updateForeground()
Aktualisiert die Vordergrundfarbe des Balkens, je nachdem, ob der Balkenwert aktuell innerhalb oder ausserhalb der Toleranz liegt. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Field Detail |
---|
public static final int LINEAR
public static final int LOGARITHMIC
public static final int VERTICAL
SwingConstants.VERTICAL
,
Constant Field Valuespublic static final int HORIZONTAL
SwingConstants.HORIZONTAL
,
Constant Field Valuesprotected int fracFact
JProgressBar
-Instanzen umzurechnen.
convertToProgressBarValue(double)
protected Color toleranceColor
protected Color intoleranceColor
Constructor Detail |
---|
public ExpansionBar(int orient, double min, double max, double tol, NumberFormat form)
orient
- Orientierung des Balken (ExpansionBar.HORIZONTAL
oder ExpansionBar.VERTICAL
min
- Minimalwert des Balkensmax
- Maximalwert des Balkenstol
- Toleranzwert nach oben/unten bis zu dem der Balken gruen
dargestellt wird (muss zwischen 0
und
max
liegen)form
- Bestimmt die Darstellung der Werte im Anzeige-Label des
Balken und in der etwaigen Info-Leiste
IllegalArgumentException
- falls die Konstellation der angegeben
Werte unzulaessig istsetValueLabelsPainted(boolean)
,
setStringPainted(boolean)
public ExpansionBar(int orient, int type, double min, double max, double tol, NumberFormat form)
orient
- Orientierung des Balken (ExpansionBar.HORIZONTAL
oder ExpansionBar.VERTICAL
type
- Darstellung des Balken (ExpansionBar.LINEAR
oder ExpansionBar.LOGARITHMIC
min
- Minimalwert des Balkensmax
- Maximalwert des Balkenstol
- Toleranzwert nach oben/unten bis zu dem der Balken gruen
dargestellt wird (muss zwischen 0
und
max
liegen)form
- Bestimmt die Darstellung der Werte im Anzeige-Label des
Balken und in der etwaigen Info-Leiste
IllegalArgumentException
- falls die Konstellation der angegeben
Werte unzulaessig istsetValueLabelsPainted(boolean)
,
setStringPainted(boolean)
public ExpansionBar(int orient, double min, double max, double mid, double tol, NumberFormat form)
orient
- Orientierung des Balken (ExpansionBar.HORIZONTAL
oder ExpansionBar.VERTICAL
min
- Minimalwert des Balkensmax
- Maximalwert des Balkensmid
- Mitte-Wert des Balkens (muss zwischen min
und
max
liegen)tol
- Toleranzwert (relativ zur Mitte!) bis zu dem der Balken gruen
dargestellt wird (muss zwischen 0
und
max
liegen)form
- Bestimmt die Darstellung der Werte im Anzeige-Label des
Balken und in der etwaigen Info-Leiste
IllegalArgumentException
- falls die Konstellation der angegeben
Werte unzulaessig istsetValueLabelsPainted(boolean)
,
setStringPainted(boolean)
public ExpansionBar(int orient, int type, double min, double max, double mid, double tol, NumberFormat form)
orient
- Orientierung des Balken (ExpansionBar.HORIZONTAL
oder ExpansionBar.VERTICAL
type
- Darstellung des Balken (ExpansionBar.LINEAR
oder ExpansionBar.LOGARITHMIC
min
- Minimalwert des Balkensmax
- Maximalwert des Balkensmid
- Mitte-Wert des Balkens (muss zwischen min
und
max
liegen)tol
- Toleranzwert (relativ zur Mitte!) bis zu dem der Balken gruen
dargestellt wird (muss zwischen 0
und
max
liegen)form
- Bestimmt die Darstellung der Werte im Anzeige-Label des
Balken und in der etwaigen Info-Leiste
IllegalArgumentException
- falls die Konstellation der angegeben
Werte unzulaessig istsetValueLabelsPainted(boolean)
,
setStringPainted(boolean)
public ExpansionBar(int orient, int type, double min, double max, double mid, double minTol, double maxTol, double initValue, NumberFormat barForm, NumberFormat infoForm)
orient
- Orientierung des Balken (ExpansionBar.HORIZONTAL
oder ExpansionBar.VERTICAL
type
- Darstellung des Balken (ExpansionBar.LINEAR
oder ExpansionBar.LOGARITHMIC
min
- Minimalwert des Balkensmax
- Maximalwert des Balkensmid
- Mitte-Wert des Balkens (muss zwischen min
und
max
liegen)minTol
- Absoluter Toleranzwert nach unten bis zu dem der Balken gruen
dargestellt wird (muss zwischen min
und
mid
liegen)maxTol
- Absoluter Toleranzwert nach oben bis zu dem der Balken gruen
dargestellt wird (muss zwischen mid
und
max
liegen)initValue
- Initialer Wert den der Balken annimmtbarForm
- Bestimmt die Darstellung der Werte im Anzeige-Label des
BalkeninfoForm
- Bestimmt die Darstellung der Werte im etwaigen Info-Label
unterhalb des Balken
IllegalArgumentException
- falls die Konstellation der angegeben
Werte unzulaessig istsetValueLabelsPainted(boolean)
,
setStringPainted(boolean)
Method Detail |
---|
protected int convertToProgressBarValue(double val)
JProgressBar
s realisiert. Diese
koennen nur Integers darstellen. Damit auch kleinere Bereiche (z.B.
zwischen 0 und 1) fliessend dargestellt werden koennen, wird der Bereich
auf (mind. 1000 Werte) skaliert. Desweiteren wird ggf. auf eine
logarithmische Darstellung umgerechnet.
val
- umzurechnender WertfracFact
protected void checkValues()
min <= max
min <= mid <= max
min <= minTol <= mid
mid <= maxTol <= max
orient == ExpansionBar.HORIZONTAL || orient == ExpansionBar.VERTICAL
public double getMinimum()
public double getMaximum()
public double getMiddle()
public double getMinimumTolerance()
public void setMinimumTolerance(double minTol)
public double getMaximumTolerance()
public void setMaximumTolerance(double maxTol)
public double getValue()
public void setValue(double value)
public boolean getValueLabelsPainted()
public void setValueLabelsPainted(boolean visible)
public boolean getStringPainted()
public void setStringPainted(boolean strPaint)
protected void updateForeground()
public void setToleranceColor(Color color)
public Color getToleranceColor()
public void setIntoleranceColor(Color color)
public Color getIntoleranceColor()
public Color getForeground()
getForeground
in class Component
public void setForeground(Color color)
setValue(double)
) wird die Farbe wieder
entsprechend der (In)Toleranz-Einstellungen gesetzt.
setForeground
in class Component
setToleranceColor(Color)
,
setIntoleranceColor(Color)
public Color getBackground()
getBackground
in class Component
public void setBackground(Color color)
setBackground
in class Component
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |