(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
Constructors' Summary Constructors' Details

:: com :: sun :: star :: embed ::

service InstanceLocker
Supported Interface
::com::sun::star::lang::XComponent
Description
The main task of this service is to prevent closing, terminating and/or etc. of controlled object.

After creation the service adds a listener of requested type ( close, terminate and/or etc. ) to the controlled object and let the listener throw related veto exception until the service is disposed.

Constructors' Summary
InstanceLockerCtor1 is used to initialize the object on it's creation.  
InstanceLockerCtor2 is used to initialize the object on it's creation.  
Constructors' Details
InstanceLockerCtor1
InstanceLockerCtor1( [in] ::com::sun::star::uno::XInterface  xInstance,
[in] long  nActions )
raises( ::com::sun::star::lang::IllegalArgumentException,
::com::sun::star::frame::DoubleInitializationException,
::com::sun::star::uno::Exception );
Description
is used to initialize the object on it's creation.
Parameter xInstance
the controlled object. Must implement the related to the requested actions broadcaster interface.
Parameter nActions
specifies the actions that should be done ( prevent closing, prevent termination and/or etc. ). It must not be empty and can currently contain following values or their combination: Actions::PREVENT_CLOSE and Actions::PREVENT_TERMINATION.
InstanceLockerCtor2
InstanceLockerCtor2( [in] ::com::sun::star::uno::XInterface  xInstance,
[in] long  aActions,
[in] XActionsApproval  xApprove )
raises( ::com::sun::star::lang::IllegalArgumentException,
::com::sun::star::frame::DoubleInitializationException,
::com::sun::star::uno::Exception );
Description
is used to initialize the object on it's creation.
Parameter xInstance
the controlled object. Must implement the related to the requested actions broadcaster interface.
Parameter nActions
specifies the actions that should be done ( prevent closing, prevent termination and/or etc. ). It must not be empty and can currently contain following values or their combination: Actions::PREVENT_CLOSE and Actions::PREVENT_TERMINATION.
Parameter xApprove
The object implementing XActionsApproval interface. If this parameter is an empty reference the object will proceed with the specified in the first parameter action until it is disposed ( just like in the case of the first constructor ). If the instance is provided, it will be asked for approval each time before proceeding with the action ( the action is specified using ::string and can take following values in this case: "PreventClose", "PreventTermination" ).

 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.