Ultra Light Client Guide and Reference


General classes

UlcProxy

To set multiple attributes of a widget already created on the UI and send the changes collectively to the UI, use the following:

UlcProxy>>#bundleRequestsWhile:

In applications where shells stay alive for a long time and inside the shells resources are dynamically changed (e.g. with a pagebook or notebook, or by dynamically adding / removing widgets), the destroyOnClose flag will not help very much. In order to give finer grained control to the programmer we have added a release API in ULC R3.0a which allows the developer to explicitly free any ULC object on demand by sending release to this object. Sending release frees the resources of the receiver on the ULC side and sends a request to the UI side to free the resources of the corresponding UI object.

Note:When releasing a ULC object the developer must make sure that this object and all of its children are no longer used anywhere. For example if you release a ULC model that is still used by other ULC objects then your application will be in an inconsistent state and if a widget tries to use the model on the UI side it will not work correctly and may throw exceptions or even crash. In general the use of the release API should be restricted to only cases where it is absolutely necessary since releasing widgets/models requires the developer to be aware of all places within the application where the widget/model is being used and this can in some cases be error prone.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]