VMeter-Definition

Im Tabellenblatt <vmeter> werden die Variablen und Eigenschaften für die Darstellung des #VMeter-Objekts definiert.

Option	Parameter1	Parameter2	Text
#Style	arc
#Range1	Zahl Prozent [Index] Limit1 Limit2	Farbe	Text Format
...
#Range<n>
#Separator	Zahl	Farbe
#Width	Zahl
#Border	Zahl	Farbe
#Size	Prozent
#Values	Zahl/Range	inside/outside
#Needle	Zahl	Farbe
#ArcBackColor	Farbe
#ArcWidth	Zahl
#Background	Bildname

Parameter1

M/O

Default

Beschreibung

arc

VMeter wird mit Range-Farben gezeichnet. Der aktuelle Wert wird mit dem Zeiger dargestellt. Der Zeiger wird unter #Needle definiert.

vmeter

arc filled

VMeter wird mit Range-Farben bis zum aktuellen Wert gefüllt, der Rest des VMeters bis zum Endwert wird mit der Hintergrundfarbe #ArcBackColor gelöscht.

VMeter-arcfilled

Range1 bis N definieren Bereiche des #VMeter mit verschiedenen Farben. Es können beliebig viele Bereiche definiert werden. Diese Bereiche können entweder durch eine Zahl, einen Prozentwert des durch Limit1/2 definierten Bereichs, eine Variable oder ein Limit definiert werden. Range1 und der letzte Range definieren Start und Ende des Objekts. Parameter2 ist die Farbe des entsprechenden Bereichs.

Wenn #Values gleich "Range" ist, so werden die Texte der Spalte "Text/File" ausgegeben. Um diese Texte zu formatieren, können die Optionen des Formats verwendet werden. Dieser Text ist sprachabhängig, das bedeutet, für jede Sprache die definiert wird, erscheint eine zusätzliche Spalte in der Definitionsdatei. Beim Wechsel der Sprache wird dieser Text geladen. Ist jedoch unter #Values eine Zahl projektiert, so werden die Zahlenwerte ausgegeben, mehr dazu unter #Values.

Wird unter VarValue ein Array angegeben, dann können alle Arrayelemente beginnend bei [1] für die Ranges vergeben werden. In der Definitionsdatei müssen diese in eckigen Klammern projektiert werden.

Limit1 bzw. Limit2 als Range-Wert übernimmt den Wert von Limit1 bzw. Limit2 vom Objekt (Spalte L/M). Dies kann in Verbindung mit der Angabe von Prozentwerten genutzt werden.

Parameter1	Parameter2	Text/File	Beschreibung
Ganzzahl	Farbe	-	Der #Separator ist der Trennstrich der Skala, er wird durch eine Ganzzahl, die die Breite in Pixeln dieses Strichs angibt und seiner Farbe definiert.

Parameter1	Parameter2	Text/File	Beschreibung
Ganzzahl	-	-	Gibt die Länge des #Separators in Pixeln an.
Prozentwert	-	-	Gibt die Länge des #Separators in Prozent von DX an.

Parameter1	Parameter2	Text/File	Beschreibung
Ganzzahl	Farbe	-	Gibt die Dicke des Borders und dessen Farbe an.

Parameter1

Parameter2

Text/File

Beschreibung

Prozent

Gibt die Grösse des VMeters in Prozent von DX an.

Wenn Prozent verwendet wird, muss die Zelle in Excel unbedingt als Text formatiert sein, da Excel sonst eine Zahl daraus macht (z.b.: 10% wird zu 0.1). Es kann auch ein ' vor den Prozentwert geschrieben werden.

Size definiert die Grösse des Kreisbogens im Verhältnis zur Objektgrösse. Size muss kleiner 100% sein, wenn der Zeiger über den Kreisbogen hinausragen soll.

Dieser Parameter ist für die Position und die Art der Skala verantwortlich. Der Parameter 2 inside/outside definiert ob die Skalenwerte/Texte innerhalb oder ausserhalb des VMeter gezeichnet werden.

Parameter1

Parameter2

Text/File

Beschreibung

Wenn der Parameter1 nicht angegeben wird, werden keine Range-Werte gezeichnet.

Range

< "inside" ¦ "outside" >

Range stellt die Skala mit Bereichs-Text oder Wert dar. Die Range-Texte können mehrsprachig definiert werden.

Wird als Range-Text ein Format angegeben, so wird der Bereichs-Wert angezeigt.

Zahl

< "inside" ¦ "outside" >

Format

Zahl stellt eine Skala mit allen vielfachen dieser Zahl bis zum Ende des Objekts dar. z.B. 10 und Ranges -10 bis 20, dann würde die Skala folgende Werte enthalten: {-10, 0, 10, 20}.

Format definiert die Formatierung der Skalen-Werte.

Parameter1

Parameter2

Text/File

Beschreibung

Wenn kein Parameter angegeben wird, so wird das Objekt gefüllt, genau gleich wie wenn der #Style gleich "Arc filled" ist.

Ganzzahl

Farbe

Ein Rechteck mit dieser Breite wird als Zeiger gezeichnet

Bilddatei

Wird für den Zeiger eine Bilddatei angegeben, so muss diese mit Position 180°, d.h. Zeiger zeigt nach links, Drehpunkt ist rechts, gezeichnet werden.

Zeiger

Wird ein Hintergrund-Bild definiert, so wird nur der Zeiger mit dem aktuellen Wert auf diesem Hintergrundbild angezeigt. Das Hintergrundbild kann sprachabhängig definiert werden.