(incubating) | The Free and Open Productivity Suite

Developer's Guide

API

SDK

Tips 'n' Tricks

Miscellaneous

Content for OpenOffice.org version 3.3.
Overview Module Use Devguide Index
Methods' Summary Attributes' Summary Methods' Details Attributes' Details

:: com :: sun :: star :: uno ::

interface XUnloadingPreference
Description
Components can implement XUnloadingPreference in order to indicate how they should be treated when their hosting library is to be unloaded. When someone calls rtl_unloadUnusedModules then the unloading listeners are notified by calling previously registered callback functions. A listener is an entity that employs, registers, and unregisters the callback functions on its behalf. Upon notification (the callback function is being called) a listener may release references to UNO components. Thus, the loaded libraries can be unloaded, if no one else keeps any objects from the library alive.
Before a listener releases references, it should ask for this interface. If the interface is not implemented, then the listener may release the object; otherwise, it calls releaseOnNotification. If the function returns false then the listener should keep the reference, otherwise it may release it.
Methods' Summary
releaseOnNotification The return value determines if the object wants to stay alive in case of an unloading procedure.  
Methods' Details
releaseOnNotification
boolean
releaseOnNotification();
Description
The return value determines if the object wants to stay alive in case of an unloading procedure.
Returns
falsedo not release references to this object,otherwise true
Top of Page

Copyright © 1995, 2010, Oracle and/or its affiliates. All rights reserved. Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

Apache OpenOffice is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator. Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF.

Copyright & License
Apache and the Apache feather logos are trademarks of The Apache Software Foundation. OpenOffice.org and the seagull logo are registered trademarks of The Apache Software Foundation. Other names appearing on the site may be trademarks of their respective owners.