Insert Range"

From Documentation
m
m
Line 3: Line 3:
 
__TOC__
 
__TOC__
  
ZK Spreadsheet can use Range.insert to inser row or column.
+
===Purpose===
 +
ZK Spreadsheet use <javadoc method="insert (java.lang.Integer, java.lang.Integer)">org.zkoss.zss.model.Range</javadoc> to insert cell, row or column.
  
==Scenario==
+
===ZUML===
User right click to open a menu and inert row or column.
 
 
 
===ZUML Example===
 
 
<source lang="xml" high="4,10">
 
<source lang="xml" high="4,10">
 
<zk>
 
<zk>
Line 28: Line 26:
 
</source>
 
</source>
  
===Open menu===
+
===Composer===
 +
====Open menu====
 
We can use onCellRightClick to get the current mouse position and open popup.
 
We can use onCellRightClick to get the current mouse position and open popup.
 
<source lang="java" high="7,8,9,10">
 
<source lang="java" high="7,8,9,10">
Line 46: Line 45:
 
[[File:ZKSsEss_Spreadsheet_InsertRange_Menu.png]]
 
[[File:ZKSsEss_Spreadsheet_InsertRange_Menu.png]]
  
===Shift cells right===
+
====Shift cells right====
 
<source lang="java" high="4">
 
<source lang="java" high="4">
 
Menuitem shiftCellRight;
 
Menuitem shiftCellRight;
Line 57: Line 56:
 
[[File:ZKSsEss_Spreadsheet_InsertRange_ShiftRight.png]]
 
[[File:ZKSsEss_Spreadsheet_InsertRange_ShiftRight.png]]
  
===Shift cells down===
+
====Shift cells down====
 
<source lang="java" high="3">
 
<source lang="java" high="3">
 
public void onClick$shiftCellDown() {
 
public void onClick$shiftCellDown() {
Line 67: Line 66:
 
[[File:ZKSsEss_Spreadsheet_InsertRange_ShiftDown.png]]
 
[[File:ZKSsEss_Spreadsheet_InsertRange_ShiftDown.png]]
  
===Insert entire row===
+
====Insert entire row====
 
<source lang="java" high="7">
 
<source lang="java" high="7">
 
public void onClick$insertEntireRow() {
 
public void onClick$insertEntireRow() {
Line 79: Line 78:
 
[[File:ZKSsEss_Spreadsheet_InsertRange_Row.png]]
 
[[File:ZKSsEss_Spreadsheet_InsertRange_Row.png]]
  
===Insert entire column===
+
====Insert entire column====
 
<source lang="java" high="6">
 
<source lang="java" high="6">
 
public void onClick$insertEntireColumn() {
 
public void onClick$insertEntireColumn() {

Revision as of 02:01, 23 November 2010


Purpose

ZK Spreadsheet use Range.insert (Integer, Integer) to insert cell, row or column.

ZUML

<zk>
<div height="100%" width="100%" apply="demo.InsertRangeComposer">
	<div height="3px"></div>
	<menupopup id="cellMenupopup">
		<menuitem id="shiftCellRight" label="Shift cells right"></menuitem>
		<menuitem id="shiftCellDown" label="Shift cells down"/>
		<menuitem id="insertEntireRow" label="Entire row" />
		<menuitem id="insertEntireColumn" label="Entire column" />
	</menupopup>
	<spreadsheet id="spreadsheet" src="/demo_sample.xls"	
			maxrows="200" 
			maxcolumns="40"
			width="100%"
			height="450px"></spreadsheet>
</div>
</zk>

Composer

Open menu

We can use onCellRightClick to get the current mouse position and open popup.

int rowIndex;
int colIndex;
Sheet currentSheet;
Spreadsheet spreadsheet;
Menupopup cellMenupopup;
public void onCellRightClick$spreadsheet(CellMouseEvent event) {
	rowIndex = event.getRow();
	colIndex = event.getColumn();
	currentSheet = event.getSheet();
	cellMenupopup.open(event.getPageX(), event.getPageY());
}

ZKSsEss Spreadsheet InsertRange Menu.png

Shift cells right

Menuitem shiftCellRight;
public void onClick$shiftCellRight() {
	Range rng = Ranges.range(currentSheet, rowIndex, colIndex);
	rng.insert(Range.SHIFT_RIGHT, Range.FORMAT_RIGHTBELOW);
}

ZKSsEss Spreadsheet InsertRange ShiftRight.png

Shift cells down

public void onClick$shiftCellDown() {
	final Range rng = Ranges.range(currentSheet, rowIndex, colIndex);
	rng.insert(Range.SHIFT_DOWN, Range.FORMAT_LEFTABOVE);
}

ZKSsEss Spreadsheet InsertRange ShiftDown.png

Insert entire row

public void onClick$insertEntireRow() {
	Row row = currentSheet.getRow(rowIndex);
	int lCol = row.getFirstCellNum();
	int rCol  = row.getLastCellNum();
	Ranges.range(currentSheet, rowIndex, lCol, rowIndex, rCol).insert(Range.SHIFT_DOWN, Range.FORMAT_LEFTABOVE);
}

ZKSsEss Spreadsheet InsertRange Row.png

Insert entire column

public void onClick$insertEntireColumn() {
	int tRow = currentSheet.getFirstRowNum();
	int bRow = currentSheet.getPhysicalNumberOfRows();
	Ranges.range(currentSheet, tRow, colIndex, bRow, colIndex).insert(Range.SHIFT_RIGHT, Range.FORMAT_RIGHTBELOW);
}

ZKSsEss Spreadsheet InsertRange Column.png

Version History

Last Update : 2010/11/23


Version Date Content
     


All source code listed in this book is at Github.


Last Update : 2010/11/23

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