Toolbar"
m |
m |
||
Line 48: | Line 48: | ||
Refer to [http://code.google.com/p/zkbooks/source/browse/trunk/zssessentials/examples/WebContent/config/pasteSpecialDialog.zul pasteSpecialDialog.zul] and [http://code.google.com/p/zkbooks/source/browse/trunk/zssessentials/examples/src/org/zkoss/zssessentials/config/CustomizedActionHandler.java CustomizedActionHandler.java] | Refer to [http://code.google.com/p/zkbooks/source/browse/trunk/zssessentials/examples/WebContent/config/pasteSpecialDialog.zul pasteSpecialDialog.zul] and [http://code.google.com/p/zkbooks/source/browse/trunk/zssessentials/examples/src/org/zkoss/zssessentials/config/CustomizedActionHandler.java CustomizedActionHandler.java] | ||
− | |||
====Custom Sort==== | ====Custom Sort==== | ||
Line 55: | Line 54: | ||
Refer to [http://code.google.com/p/zkbooks/source/browse/trunk/zssessentials/examples/WebContent/config/customSortDialog.zul customSortDialog.zul] and [http://code.google.com/p/zkbooks/source/browse/trunk/zssessentials/examples/src/org/zkoss/zssessentials/config/CustomizedActionHandler.java CustomizedActionHandler.java] | Refer to [http://code.google.com/p/zkbooks/source/browse/trunk/zssessentials/examples/WebContent/config/customSortDialog.zul customSortDialog.zul] and [http://code.google.com/p/zkbooks/source/browse/trunk/zssessentials/examples/src/org/zkoss/zssessentials/config/CustomizedActionHandler.java CustomizedActionHandler.java] | ||
− | |||
===ZUML=== | ===ZUML=== |
Revision as of 09:33, 3 April 2012
Purpose
ZK Spreadsheet supports various toolbar buttons for user to perform actions.
Show toolbar
Use Spreadsheet.setShowToolbar to show toolbar.
Action Handler
The Spreadsheet use a default ActionHandler to perform toolbar button's action. Developer could use customized ActionHandler by API Spreadsheet.setActionHandler or by library property org.zkoss.zss.ui.ActionHandler.class, refer to sample zk.xml
Each toolbar's button represent a action, the ActionHandler process action when user click it.
For example, the paste toolbarbutton and menuitem represent Action.PASTE, deveoper could override
default behavior by override ActionHandler.doPaste
New book
The default ActionHandler does nothing when user click the button, developer could override ActionHandler.doNewBook
@Override
public void doNewBook() {
_spreadsheet.setSrc("/WEB-INF/excel/config/blank.xlsx");
}
Paste Special
The default ActionHandler does nothing when user click the button, developer could override ActionHandler.doPasteSpecial
@Override
public void doPasteSpecial(Rect selection) {
if (getClipboard() != null && _spreadsheet.getBook() != null && validSelection(selection)) {
PasteSpecialDialog dialog = new PasteSpecialDialog(selection);
//omit
}
}
Refer to pasteSpecialDialog.zul and CustomizedActionHandler.java
Custom Sort
The default ActionHandler does nothing when user click the button, developer could override ActionHandler.doCustomSort
Refer to customSortDialog.zul and CustomizedActionHandler.java
ZUML
Here is a sample example ZUL file
<zk>
<window vflex="1" width="100%" apply="org.zkoss.zssessentials.config.ToolbarComposer">
<button id="toggleToolbar" label="Toggle toolbar"/>
<spreadsheet showToolbar="true"
id="ss" vflex="true" width="100%"
src="/WEB-INF/excel/config/ZSS-demo_sample.xlsx" maxcolumns="40" maxrows="200"
></spreadsheet>
</window>
</zk>