Lade...
 

CX_COUNTER - Zähler

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

 

Methodenverzeichnis (MDI)
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

Datenverzeichnis (DDI)
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

Verwendung in AppsWH
Modul Kurzbeschreibung
counter.mod Zähler Basismodul
countedt.mod Zähler Editiermodul
countsel.mod Zähler Selektionsmodul