(incubating) | The Free and Open Productivity Suite
Announcing Apache OpenOffice 3.4

Developer's Guide

API

SDK

Tips 'n' Tricks

Miscellaneous

Content for OpenOffice.org version 3.3.

:: com :: sun :: star :: script :: provider ::

unpublished interface XScript
Usage Restrictions
not published
Description
This interface represents an invokable script or UNO function.

Methods' Summary
invoke invoke the script or function represented by the implementing object  
Methods' Details
invoke
any
invoke( [in] sequence< any >  aParams,
[out] sequence< short >  aOutParamIndex,
[out] sequence< any >  aOutParam )
raises( ScriptFrameworkErrorException,
::com::sun::star::reflection::InvocationTargetException );

Description
invoke the script or function represented by the implementing object
Parameter aParams
all parameters; pure, out params are undefined in sequence, i.e., the value has to be ignored by the callee
Parameter aOutParamIndex
out indices, indicating the position of the out or inout parameters in the list of arguments to the script
Parameter aOutParam
out parameters

For example, if the script had the signature
long foo( [inout] string a, [in] string b, [out] string c )
the call would look like
bar.invoke( {"foo", "foo2", "this-is-ignored" }, aOutParamIndex, aOutParam);
and after the call the out sequences would contain

 aOutParamIndex={0,2};
 aOutParam={"string from a", "string from c"}; 
 
Returns
the value returned from the function being invoked
Throws
::com::sun::star::reflection::InvocationTargetException if and error occurs while attempting to invoke a script the information is captured. If the error or exception is generated by the script itself it is wrapped as either ScriptErrorRaisedException or ScriptExceptionRaisedException or ScriptingFrameworkErrorException are wrapped as ScriptFrameworkErrorExceptions.
Top of Page

Apache Feather

Copyright & License | Privacy | Contact Us

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.

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.