WinRvwUpdate

obj -> WinRvwUpdate([int1[, int2[, int3]]]) : int

View eines RecView-Objektes aktualisieren

Details

• obj: Objekt
• int1: Update-Modus (siehe Text)
• int2: Nummer des Views
• int3: Datensatzpuffer oder Dateinummer
• Resultat: int Fehlerwert
• Siehe: Verwandte Befehle , WinUpdate ()

Dieser Befehl führt eine Positionierung in dem View (int2) des RecView -Objektes (obj) durch.

Folgende Parameter können als Update-Modus (int1) übergeben werden:

• _WinRvwUpdateFromFirst: Neuaufbau des RecViews ab dem ersten Datensatz
• _WinRvwUpdateFromLast: Neuaufbau des RecViews ab dem letzten Datensatz
• _WinRvwUpdateFromRecBuf: Neuaufbau des RecViews ausgehend von den Werten des Feldpuffers (int3)
• _WinRvwUpdateFromTop: Neuaufbau des RecViews ab dem ersten sichtbaren Datensatz
• _WinRvwUpdateFromTopLocation: Neuaufbau der angezeigten Datensätze des RecViews. Die Position der ersten angezeigten Gruppe wird beibehalten.
• _WinRvwUpdateFromSelected: Neuaufbau des RecViews ab dem selektieren Datensatz
• _WinRvwUpdateDoSelect: In dem RecView wird der aktuelle Datensatz selektiert
• _WinRvwUpdateDoKeepSelect: In dem RecView wird der aktuell selektierte Datensatz weiterhin selektiert
• _WinRvwUpdateOptClearCache: Alle Gruppen werden aus dem Cache des RecView-Objektes entfernt
• _WinRvwUpdateOptClearSelected: Die selektierte Gruppe wird aus dem Cache des RecView-Objektes entfernt

Konstanten aus den Bereichen _WinRvwUpdateFrom*, _WinRvwUpdateDo* und _WinRvwUpdateOpt* können miteinander kombiniert werden. Konstanten aus gleichen Bereichen können nicht kombiniert werden.

info

Wird zwar ein Update-Modus (int1), aber keine Konstante aus dem Bereich _WinRvwUpdateFrom* angegeben, wird der Laufzeitfehler _ErrValueInvalid ausgelöst.

Wird als Update-Modus (int1) _WinRvwUpdateFromRecBuf übergeben, muss in int3 ein Datensatzpuffer oder eine Datei übergeben werden. Diese muss mit der Eigenschaft DbFileNo oder DbLinkFileNo übereinstimmen. Wird in (int1) nicht _WinRvwUpdateFromRecBuf angegeben, so führt eine Angabe von einem Datensatzpuffer oder einer Datei zu dem Laufzeitfehler _ErrValueInvalid. Dieser Modus kann auch verwendet werden, um verknüpfte Datensätze anzuzeigen. Dazu wird der Quelldatensatz gelesen und die Quelldatei in int3 übergeben. Um in einer Verknüpfung auf einen bestimmten Datensatz zu positionieren, muss bei dem Verknüpfungsfeld "nur Zugriffspositionierung" aktiviert sein.

Fehlt die Angabe des Update-Modus, so wird _WinRvwUpdateFromTop verwendet.

In der Nummer des Views (int2) wird definiert, welche Anzeige aktualisiert werden soll. Mögliche Werte sind 0 bis 4. Wird 0 angegeben, oder das Argument weggelassen, wird das aktive View, welches den Eingabe-Fokus besitzt, aktualisiert. Eine Angabe von 0 und 1 ist immer möglich. Die Views 2 bis 4 existieren nur, wenn eine entsprechende Splittung des RecView durch den Anwender vorgenommen wurde. Existiert das angegebene View nicht wird der Fehlerwert _ErrUnknown zurückgegeben.

Der Befehl hat zur Folge, dass die Anzeige des entsprechenden Views neu aufgebaut wird. Daher werden anschließend EvtLstGroupInit-Ereignisse durchgeführt.

Als Rückgabewert wird der Fehlerwert _ErrUnknown zurückgegeben, wenn das angegebene View (int2) nicht existiert oder noch nicht initialisiert (siehe EvtLstViewInit) wurde. Der Fehlerwert _ErrUnavailable wird zurückgegeben, wenn der Update-Modus _WinRvwUpdateFromTop angegeben wurde und kein Datensatz angezeigt wird, oder der Update-Modus _WinRvwUpdateFromSelected verwendet wird und kein Datensatz selektiert ist. Sonst wird _ErrOk zurückgegeben.

info

Wird der Befehl in einem der Ereignisse EvtLstViewInit , EvtLstGroupInit , EvtLstEditStartGroup , EvtLstEditStartItem , EvtLstEditActivate oder EvtLstEditEndItem aufgerufen, wird der Laufzeitfehler _ErrHdlInvalid ausgelöst.

Mögliche Laufzeitfehler:

• _ErrHdlInvalid: In (obj) wurde kein gültiger Deskriptor angegeben. Wird beim Update-Modus (int1) _WinRvwUpdateFromRecBuf kein Datensatzpuffer oder die Nummer oder ein Datensatzpuffer einer anderen Datei angegeben, wird der Laufzeitfehler ebenfalls ausgelöst. Weiterhin wird der Laufzeitfehler ausgelöst, wenn der Befehl in einem der oben genannten Ereignisse aufgerufen wird.
• _ErrValueInvalid: In (int3) wurde ein Wert angegeben und der Update-Modus in (int1) ist nicht _WinRvwUpdateFromRecBuf oder es wurde ein ungültiger Update-Modus angegeben. Wird in (int1) keine Konstante aus dem Bereich _WinRvwUpdateFrom* angegeben, wird der Laufzeitfehler ebenfalls ausgelöst.