Zum Hauptinhalt springen

WinUpdate

obj -> WinUpdate([int1[, int2]]) : int​

Ausführbar von Clients mit grafischer Oberfläche Ausführbar vom Server Ausführbar von der DLL-Schnittstelle mit grafischer Erweiterung Ausführbar von der Web-Schnittstelle Ausführbar vom Druckprozessor Ausführbar von der ODBC-Schnittstelle Ausführbar vom SOA-Service mit grafischer Erweiterung

Objekt aktualisieren

Details

Mit diesem Befehl wird ein Objekt aktualisiert. Sind dem übergebenen Objekt weitere Objekte untergeordnet, werden diese ebenfalls aktualisiert. Sind in einem Fenster-Objekt RecList - oder DataList -Objekte enthalten, werden diese aus Performancegründen nicht aktualisiert. Diese Objekte müssen gesondert aktualisiert werden.

Wird ein RecList -Objekt übergeben, werden alle in dem Objekt angezeigten Datensätze neu gelesen. Bei allen anderen Objekten bewirkt WinUpdate() die Anzeige der mit dem Objekt (oder dessen Unterobjekte) verknüpften Datenbankfelder. Die gleiche Wirkung wird mit WinUpdate ( _WinUpdFld2Obj ) erzielt.

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

Die Konstanten können nicht miteinander kombiniert werden. Die Konstanten _WinUpdOff und _WinUpdOn können mit _WinUpdScrollPos kombiniert werden, um die Scrollposition zu speichern und wieder herzustellen.

info

Wird als Update-Modus (int1) _WinUpdOn mit der Konstanten _WinUpdScrollPos kombiniert, wird nur die Scrollposition wiederhergestellt. Zur Aktualisierung des Objektes muss WinUpdate () erneut mit _WinUpdOn aufgerufen werden.

Für die Objekte RecList , DataList , Frame und GanttGraph können weitere Optionen in (int2) angegeben werden.

Optionen für RecList- und DataList-Objekte (in (int1) muss einer der obigen Parameter angegeben werden):

Konstanten aus den Bereichen _WinLst*From*, _WinLstPos*, _WinLstReorderColumns und _WinLstRec* können miteinander kombiniert werden. Konstanten aus gleichen Bereichen können nicht kombiniert werden.

Optionen für Frame-Objekte (in (int1) muss _WinUpdState angegeben werden):

Die Option _WinDialogPrimary kann mit den anderen Konstanten kombiniert werden.

Optionen für GanttGraph-Objekte:

Änderungen in Eingabeobjekten werden in den angegebenen Feldpuffer (Eigenschaft DbFieldName) übertragen, wenn der Fokus in ein anderes Objekt gesetzt wird. Diese Übertragung kann ebenfalls prozedural mit dem Parameter _WinUpdObj2Fld durchgeführt werden.

Die Optionen _WinLstFrom... beeinflussen nur die Anzeige der Datensätze. Der selektierte Datensatz bleibt unverändert. Die Selektion kann mit der Option _WinLstRecDoSelect neu gesetzt werden. Ein Update mit dieser Option löst dann auch das Ereignis EvtLstSelect der betreffenden RecList aus.

Die Position innerhalb der dargestellten Datensätze wird durch die Option _WinLstPos... bestimmt. Diese Option lässt sich mit den anderen Optionen kombinieren. Sollte eine Darstellung nicht möglich sein, weil zum Beispiel der letzte Datensatz in der Mitte dargestellt werden soll, erfolgt die Darstellung als vollständig gefüllte Liste.

Soll ein Fenster maximiert oder minimiert werden ist in (int1) die Konstante _WinUpdState anzugeben.

Als Rückgabewerte wird der Fehlerwert _ErrHdlInvalid zurückgegeben, wenn als (obj) kein gültiger Deskriptor angegeben wurde, sonst _ErrOk.

Beispiele:

sub EvtLstSelect
(
  aEvt   : event;    // Ereignis
  aID    : bigint;   // Record-ID des Datensatzes oder Zeilennummer
) : logic;

{
  // Datensatz lesen

  RecRead(tblArtArticle, 0, _RecID, aID);
  
  // Felder aktualisieren
  $Frame->WinUpdate();
  return(true);
}

// Selektieren eines Datensatzes
fiCstNumber # 4;
RecRead(tblCstCustomer, keyCstNumber, 0);
$RecList->WinUpdate(_WinUpdOn, _WinLstRecFromBuffer | _WinLstRecDoSelect);
...