ZK Spreadsheet 3.0.0 RC:Upgrade Notes"

From Documentation
m
m (correct highlight (via JWB))
 
Line 11: Line 11:
 
= API Change =
 
= API Change =
  
== Classed under <tt>org.zkoss.zss.model</tt> are removed ==
+
== Classed under <code>org.zkoss.zss.model</code> are removed ==
Classes inside <tt>org.zkoss.zss.model</tt> are removed. Please use the new classes and API under <tt>org.zkoss.zss.api</tt> and <tt>org.zkoss.zss.api.model</tt>.
+
Classes inside <code>org.zkoss.zss.model</code> are removed. Please use the new classes and API under <code>org.zkoss.zss.api</code> and <code>org.zkoss.zss.api.model</code>.
  
  
 
== Spreadsheet Component API change ==
 
== Spreadsheet Component API change ==
# To get/set Book/Sheet, use the new classes of Book/Sheet that are under <tt>org.zkoss.zss.api.model</tt>.
+
# To get/set Book/Sheet, use the new classes of Book/Sheet that are under <code>org.zkoss.zss.api.model</code>.
# Those methods of Spreadsheet about freezing rows/columns are deprecated. Please use <tt>Sheet.getColumnFreeze()</tt> and <tt>Sheet.getRowFreeze()</tt> and <tt>Range.setFreezePanel()</tt>.
+
# Those methods of Spreadsheet about freezing rows/columns are deprecated. Please use <code>Sheet.getColumnFreeze()</code> and <code>Sheet.getRowFreeze()</code> and <code>Range.setFreezePanel()</code>.
  
  
==<tt>Rect</tt> and <tt>Position</tt> under <tt>org.zkoss.zss.ui</tt> are deprecated ==
+
==<code>Rect</code> and <code>Position</code> under <code>org.zkoss.zss.ui</code> are deprecated ==
<tt>Rect</tt> and <tt>Position</tt> under <tt>org.zkoss.zss.ui</tt> are deprecated, so please use <tt>CellRef</tt> and <tt>AreaRef</tt> instead (under <tt>org.zkoss.zss.api</tt>) .
+
<code>Rect</code> and <code>Position</code> under <code>org.zkoss.zss.ui</code> are deprecated, so please use <code>CellRef</code> and <code>AreaRef</code> instead (under <code>org.zkoss.zss.api</code>) .
  
  
== <tt>Action</tt> and <tt>ActionHandler</tt> are removed ==
+
== <code>Action</code> and <code>ActionHandler</code> are removed ==
<tt>org.zkoss.zss.ui.Action, org.zkoss.zss.ui.sys.ActionHandler</tt> are removed. To override a default action, please use <tt>org.zkoss.zss.ui.AuxAction</tt>, <tt>org.zkoss.zss.ui.UserActionManager</tt> instead.
+
<code>org.zkoss.zss.ui.Action, org.zkoss.zss.ui.sys.ActionHandler</code> are removed. To override a default action, please use <code>org.zkoss.zss.ui.AuxAction</code>, <code>org.zkoss.zss.ui.UserActionManager</code> instead.
  
  
== Arguments of <tt>CellSelectionEvent</tt>'s constructor are changed ==
+
== Arguments of <code>CellSelectionEvent</code>'s constructor are changed ==
Arguments of <tt>org.zkoss.zss.ui.event.CellSelectionEvent</tt>'s constructor are changed from left,top,right,bottom to topRow,leftCol,bottomRow,rightColumn.
+
Arguments of <code>org.zkoss.zss.ui.event.CellSelectionEvent</code>'s constructor are changed from left,top,right,bottom to topRow,leftCol,bottomRow,rightColumn.
  
  
== Some event classes under package <tt>org.zkoss.zss.ui.event</tt> are renamed ==
+
== Some event classes under package <code>org.zkoss.zss.ui.event</code> are renamed ==
  
 
{| border="2" style=" font-size:18;"
 
{| border="2" style=" font-size:18;"
Line 38: Line 38:
 
! <center>2.5.0</center> !! <center>3.0.0 RC</center>
 
! <center>2.5.0</center> !! <center>3.0.0 RC</center>
 
|-   
 
|-   
| style="padding:5px;"|<tt>SelectionChangeEvent</tt>
+
| style="padding:5px;"|<code>SelectionChangeEvent</code>
| style="padding:5px;"|'''<tt>CellSelectionUpdateEvent</tt>'''
+
| style="padding:5px;"|'''<code>CellSelectionUpdateEvent</code>'''
 
|-
 
|-
| style="padding:5px;"|<tt>HeaderEvent</tt>
+
| style="padding:5px;"|<code>HeaderEvent</code>
| style="padding:5px;"|'''<tt>HeaderUpdateEvent</tt>'''
+
| style="padding:5px;"|'''<code>HeaderUpdateEvent</code>'''
 
|-
 
|-
| style="padding:5px;"|<tt>FilterMouseEvent</tt>
+
| style="padding:5px;"|<code>FilterMouseEvent</code>
| style="padding:5px;"|'''<tt>CellFilterEvent</tt>'''
+
| style="padding:5px;"|'''<code>CellFilterEvent</code>'''
 
|-
 
|-
| style="padding:5px;"|<tt>HyperlinkEvent</tt>
+
| style="padding:5px;"|<code>HyperlinkEvent</code>
| style="padding:5px;"|'''<tt>CellHyperlinkEvent</tt>'''
+
| style="padding:5px;"|'''<code>CellHyperlinkEvent</code>'''
 
|}
 
|}
  
  
== <tt>SheetCreateEvent, SheetSelectedEvent</tt> and <tt>SheetUpdateEvent</tt> are removed==
+
== <code>SheetCreateEvent, SheetSelectedEvent</code> and <code>SheetUpdateEvent</code> are removed==
<tt>SheetCreateEvent, SheetSelectedEvent</tt> and <tt>SheetUpdateEvent</tt> are removed. Please use <tt>SheetEvent</tt> instead.
+
<code>SheetCreateEvent, SheetSelectedEvent</code> and <code>SheetUpdateEvent</code> are removed. Please use <code>SheetEvent</code> instead.
  
  
 
== Spreadsheet JSF component package name changed ==
 
== Spreadsheet JSF component package name changed ==
ZK Spreadsheet JSF component's main package is renamed to <tt>org.zkoss.zss.jsf</tt>, and JSF component class is renamed to <tt>org.zkoss.zss.jsf.ui.JSFSpreadsheet</tt>
+
ZK Spreadsheet JSF component's main package is renamed to <code>org.zkoss.zss.jsf</code>, and JSF component class is renamed to <code>org.zkoss.zss.jsf.ui.JSFSpreadsheet</code>
  
 
== Spreadsheet JSP package name changed ==
 
== Spreadsheet JSP package name changed ==
ZK Spreadsheet JSP main package is renamed to <tt>org.zkoss.zss.jsp</tt>.
+
ZK Spreadsheet JSP main package is renamed to <code>org.zkoss.zss.jsp</code>.
  
  

Latest revision as of 04:20, 20 January 2022

DocumentationSmall Talks2013AugustZK Spreadsheet 3.0.0 RC:Upgrade Notes
ZK Spreadsheet 3.0.0 RC:Upgrade Notes

Author
Hawk Chen
Date
August 22, 2013
Version
ZK Spreadsheet 3.0.0 RC


Overview

In ZK Spreadsheet version 3.0.0 RC, we have made some significant changes that users should notice. Due to major APIs change, most codes written for customization or accessing data model need to be re-written for this version.

API Change

Classed under org.zkoss.zss.model are removed

Classes inside org.zkoss.zss.model are removed. Please use the new classes and API under org.zkoss.zss.api and org.zkoss.zss.api.model.


Spreadsheet Component API change

  1. To get/set Book/Sheet, use the new classes of Book/Sheet that are under org.zkoss.zss.api.model.
  2. Those methods of Spreadsheet about freezing rows/columns are deprecated. Please use Sheet.getColumnFreeze() and Sheet.getRowFreeze() and Range.setFreezePanel().


Rect and Position under org.zkoss.zss.ui are deprecated

Rect and Position under org.zkoss.zss.ui are deprecated, so please use CellRef and AreaRef instead (under org.zkoss.zss.api) .


Action and ActionHandler are removed

org.zkoss.zss.ui.Action, org.zkoss.zss.ui.sys.ActionHandler are removed. To override a default action, please use org.zkoss.zss.ui.AuxAction, org.zkoss.zss.ui.UserActionManager instead.


Arguments of CellSelectionEvent's constructor are changed

Arguments of org.zkoss.zss.ui.event.CellSelectionEvent's constructor are changed from left,top,right,bottom to topRow,leftCol,bottomRow,rightColumn.


Some event classes under package org.zkoss.zss.ui.event are renamed

2.5.0
3.0.0 RC
SelectionChangeEvent CellSelectionUpdateEvent
HeaderEvent HeaderUpdateEvent
FilterMouseEvent CellFilterEvent
HyperlinkEvent CellHyperlinkEvent


SheetCreateEvent, SheetSelectedEvent and SheetUpdateEvent are removed

SheetCreateEvent, SheetSelectedEvent and SheetUpdateEvent are removed. Please use SheetEvent instead.


Spreadsheet JSF component package name changed

ZK Spreadsheet JSF component's main package is renamed to org.zkoss.zss.jsf, and JSF component class is renamed to org.zkoss.zss.jsf.ui.JSFSpreadsheet

Spreadsheet JSP package name changed

ZK Spreadsheet JSP main package is renamed to org.zkoss.zss.jsp.


Some Event Names are Changed

2.5.0
3.0.0 RC
onValidateDrop onCellValidator
onFilter onCellFilter
onHeaderSize onHeaderUpdate
onSelectionChange onCellSelectionChange
onCellFocused onCellFocus
onSheetNameChange onAfterSheetNameChange
onSheetOrderChange onAfterSheetOrderChange
onSheetDelete onAfterSheetDelete
onSheetCreate onAfterSheetCreate
onCellChange onAfterCellChange




Comments



Copyright © Potix Corporation. This article is licensed under GNU Free Documentation License.