As Simple as a Java Static Method"
| Line 4: | Line 4: | ||
ZK Spreadsheet allows developers to write their own custom formula functions. One way of implementing them is as a Java static method & declaring using xel-directive and another one is to implement it as EL function and register it in a TLD. Here we describe the first method. | ZK Spreadsheet allows developers to write their own custom formula functions. One way of implementing them is as a Java static method & declaring using xel-directive and another one is to implement it as EL function and register it in a TLD. Here we describe the first method. | ||
| − | ==Purpose== | + | ===Purpose=== |
Implement a custom formula function as a Java static method. | Implement a custom formula function as a Java static method. | ||
| − | ==Implement formula function== | + | ===Implement formula function=== |
Define your custom formula function as a normal Java static method. For example here is a static method to convert USD to TWD. | Define your custom formula function as a normal Java static method. For example here is a static method to convert USD to TWD. | ||
<source lang="java" high="3"> | <source lang="java" high="3"> | ||
| Line 17: | Line 17: | ||
</source> | </source> | ||
| − | == | + | ===ZUML=== |
To be able to use above defined toTWD static method as a custom ZK Spreadsheet formula fuction declare it in your ZUL page using xel-method directive[http://books.zkoss.org/wiki/ZK_ZUML_Reference/The_ZK_User_Interface_Markup_Language/Processing_Instructions/The_xel-method_Directive] along with ZK Spreadsheet component as shown below | To be able to use above defined toTWD static method as a custom ZK Spreadsheet formula fuction declare it in your ZUL page using xel-method directive[http://books.zkoss.org/wiki/ZK_ZUML_Reference/The_ZK_User_Interface_Markup_Language/Processing_Instructions/The_xel-method_Directive] along with ZK Spreadsheet component as shown below | ||
<source lang="xml" high="2,3,4"> | <source lang="xml" high="2,3,4"> | ||
| Line 35: | Line 35: | ||
'''Note''' that xel-method prefix attribute value ''must'' be set to "'''zss'''" for ZK Spreadsheet to invoke custom implementation for such custom formula function. | '''Note''' that xel-method prefix attribute value ''must'' be set to "'''zss'''" for ZK Spreadsheet to invoke custom implementation for such custom formula function. | ||
| − | == | + | ====Using custom formula function in Excel==== |
| − | Once defined and declared above custom formula function can be used just like any other built-in functions of Excel. | + | Once defined and declared above custom formula function can be used just like any other built-in functions of Excel. Note that when entered in MS Excel it will result in #NAME? being displayed but when entered in ZK Spreadsheet it will we evaluated by invoking custom implementation declared through xel-method directive. |
<source lang="xml"> | <source lang="xml"> | ||
=toTWD(A1,B1) | =toTWD(A1,B1) | ||
Revision as of 07:52, 24 November 2010
ZK Spreadsheet allows developers to write their own custom formula functions. One way of implementing them is as a Java static method & declaring using xel-directive and another one is to implement it as EL function and register it in a TLD. Here we describe the first method.
Purpose
Implement a custom formula function as a Java static method.
Implement formula function
Define your custom formula function as a normal Java static method. For example here is a static method to convert USD to TWD.
public class CurrencyFns {
public static double toTWD(double usdNum, double twdRate) {
return usdNum * twdRate;
}
}
ZUML
To be able to use above defined toTWD static method as a custom ZK Spreadsheet formula fuction declare it in your ZUL page using xel-method directive[1] along with ZK Spreadsheet component as shown below
<?page title="ZSS" contentType="text/html;charset=UTF-8"?>
<?xel-method prefix="zss" name="toTWD"
class="org.zkoss.zss.example.CurrencyFns"
signature="double toTWD(double,double)"?>
<zk>
<window title="ZSS User Defined Functions" border="normal"
width="100%" height="100%">
<spreadsheet width="800px" height="800px"
src="/test2/xls/elfn.xlsx" maxrows="20" maxcolumns="10">
</spreadsheet>
</window>
</zk>
Note that xel-method prefix attribute value must be set to "zss" for ZK Spreadsheet to invoke custom implementation for such custom formula function.
Using custom formula function in Excel
Once defined and declared above custom formula function can be used just like any other built-in functions of Excel. Note that when entered in MS Excel it will result in #NAME? being displayed but when entered in ZK Spreadsheet it will we evaluated by invoking custom implementation declared through xel-method directive.
=toTWD(A1,B1)
Version History
| Version | Date | Content |
|---|---|---|
All source code listed in this book is at Github.