CX_COUNTER
Klassenhierarchie
Beschreibung:
Ein Counter wird als Zähler verwendet, der einen bestimmten aktuellen Wert hat und um einen Step-Value erhöht oder erniedrigt werden kann.
Zur Darstellung kann ein Counter Formatangaben verwalten, die gemäß dem Befehl FString benutzt werden.
Counter können das Zählwerk und die Formatierung über das Feld delegation an andere Counter delegieren. Das heißt, die Delegated-Methoden arbeiten nicht mit dem Zählerstand, Schrittweite, Format dieses Zählers sondern mit denen des am meisten delegierten Counter-Objekts.
Falls die Formatierung nicht delegiert werden soll (sondern nur das Zählwerk), dann muss im delegierten Zähler die Formatierung über flags deaktiviert werden. Dann wird wieder die Formatierung aus dem Ausgangszähler angewendet.
Ein Zähler ist deaktiviert, falls der Ausgangszähler oder der am meisten delegierte (delegation) Zähler über flags deaktiviert wurde. Ein deaktivierter Zähler wird durch Incr/Decr nicht verändert und liefert den größtmöglichen INTEGER-Wert. Format-Methoden liefern für deaktivierte Zähler immer einen Leerstring.
Code-Beispiel:
String(CX_COUNTER::firstformat, 120, 20, 110) String(CX_COUNTER::secondformat, 350, 20, 110) [ Path(CX_COUNTER::uniqueID) LIGHTRED ] SetFormat [ Path(CX_COUNTER::mlDescription) ] SetFormat
Funktion | MA* | Parameter | Rückgabe | Kurzbeschreibung |
---|---|---|---|---|
Decr | INTEGER | Zähler vermindern | ||
DelegatedDecr | INTEGER | (Delegierten) Zähler vermindern | ||
DelegatedGetFormattedValue | STRING | (Delegierter) Zählerstand, formatiert | ||
DelegatedGetStep | INTEGER | (Delegierte) Schrittweite | ||
DelegatedGetValue | INTEGER | (Delegierter) Zählerstand | ||
DelegatedIncr | INTEGER | (Delegierten) Zähler erhöhen | ||
FormattedDecr | STRING | Zähler vermindern und formatieren | ||
FormattedDelegatedDecr | STRING | (Delegierten) Zähler vermindern und formatieren | ||
FormattedDelegatedGetValue 224501 |
STRING | (Delegierter) Zählerstand, formatiert | ||
FormattedDelegatedIncr | STRING | (Delegierten) Zähler erhöhen und formatieren | ||
FormattedGetValue 224501 |
STRING | Zählerstand, formatiert | ||
FormattedIncr | STRING | Zähler erhöhen und formatieren | ||
GetActiveCounter | CX_COUNTER | Liefert das Zähler-Objekt, welches für die Delegated-Methoden verwendet wird. | ||
GetActiveFormatStrings 224511 |
VECTOR〈STRING〉 | Liefert die Formatstrings, die für die FormattedDelegated-Methoden verwendet werden. | ||
GetFormattedValue | STRING | Zählerstand, formatiert | ||
GetStep | INTEGER | Schrittweite | ||
GetValue | INTEGER | Zählerstand | ||
Incr | INTEGER | Zähler erhöhen | ||
Set | (INTEGER, INTEGER) | |||
SetStep | (INTEGER) | |||
SetValue | (INTEGER) | |||
Description | STRING | |||
GetDomain | INTEGER | Domain dieses Objektes | ||
GetFormatStrings | VECTOR〈STRING〉 |
Liefert die Formatstrings dieses Zählers als Vektor | ||
GetSiblings | COLLECTION | Alle Siblings dieses Objektes | ||
GetSiblings2 | COLLECTION | Alle Siblings dieses Objektes | ||
GetSlotEntries | VECTOR〈OBJECT〉 | |||
Item | OBJECT | |||
LastUpdate | OBJECT | |||
LastUser | INTEGER | |||
Link | (OBJECT) | |||
NextValidObject | OBJECT | |||
PreviousValidObject | OBJECT | |||
ReferenceCount | INTEGER | |||
RestrictedValidity | * | |||
SetDomain | INTEGER, INTEGER | Domain setzen | ||
ShortName | STRING | |||
Siblings | * | |||
SpanDateValidity | * | |||
string | INTEGER | CX_STRING | Liefert die String-Darstellung des Objektes | |
Unlink | ||||
Unlink2 | Dieses Objekt aus der Liste der Objekte mit Gültigkeit entfernen | |||
Valid | (OBJECT) | INTEGER | ||
ValidSince | OBJECT | |||
ValidToday | INTEGER | Heute gültig? | ||
ValidUntil | OBJECT | |||
VerifySiblings | INTEGER | Ring der Austauschobjekte prüfen |
* MA = Member-Access-Funktion
Datenfeld | Typ | Referenz-Klasse | I* | Kurzbeschreibung |
---|---|---|---|---|
delegation | POINTER | CX_COUNTER | Delegate-Funktionen benutzen nicht den eigenen Zähler, sondern den, der hier verlinkt ist | |
firstFormat | STRING | Steuerzeichen zur Formatierung | ||
flags | INTEGER | Bit 0 gesetzt = Zähler deaktiviert Bit 1 gesetzt = Formatierung deaktiviert |
||
secondFormat | STRING | Fester Text zur Formatierung | ||
step | INTEGER | Schrittweite für Incr/Decr | ||
uniqueID | STRING | * | ||
validity | POINTER | CX_VALIDITY | ||
value | INTEGER | Aktueller Zählerwert |
* I = Indizierbares Datenfeld
Modul | Kurzbeschreibung |
---|---|
counter.mod | Zähler Basismodul |
countedt.mod | Zähler Editiermodul |
countsel.mod | Zähler Selektionsmodul |