DrainWindow

DrainWindow

DrainWindow(windowID, childID), DrainWindow(windowID), DrainWindow(, childID), DrainWindow

parameters: Identifier of a Window- and a Childobject

Stack

Stack		Description
Stack(In)		one object
Stack(Out)		-

This is the operation inverse to FillWindow: Data corresponding to the object is 'written' from the Window objects of the Windows into the object.

Note: A transaction starts with a persistent object.

For the assignment of the object data to the window objects of the user interface, see FillWindow. The data selected via access expression is updated by importing the character string of the window object. If a window object exists on the interface for a dynamic data field that does not yet exist in the object instance, it is created now.

Relationships between objects displayed in an object box are updated with DrainWindow. The back reference to be registered in the object box with BackRefName is also taken into account. In this case DrainWindow executes the functionality of the instruction SetReference for a 1-1- or m-1-relation and the instruction Insert for 1-m- and m-n-relations.

A window object with flag NO_DRAIN is ignored by DrainWindow.
The same applies to an invisible window object - i.e. if it is hidden by the Hide statement or a priori by flag HIDDEN.

DrainWindow should not be used with ListViews that can display a large number of objects (see ListView).

Note on the widget import: DrainWindow only considers widgets of the current import context.