Delete Range"

From Documentation
m (correct highlight (via JWB))
 
(9 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
{{ZKSpreadsheetEssentialsPageHeader}}
 
{{ZKSpreadsheetEssentialsPageHeader}}
 +
 +
 +
{{Deprecated|url=http://books.zkoss.org/wiki/ZK_Spreadsheet_Essentials}}
 +
 +
  
 
__TOC__
 
__TOC__
  
ZK Spreadsheet can use Range.delete to delete row or column.
+
===Purpose===
 
+
ZK Spreadsheet can use <javadoc directory="zss" method="delete(java.lang.Integer)">org.zkoss.zss.model.Range</javadoc> to delete range, rows or columns.
==Scenario==
 
User right click to open a menu and delete row or column.
 
  
===ZUML Example===
+
===ZUML===
<source lang="xml" high="4,10">
+
<source lang="xml" highlight="4,10">
 
<zk>
 
<zk>
 
<div height="100%" width="100%" apply="demo.DeleteRangeComposer">
 
<div height="100%" width="100%" apply="demo.DeleteRangeComposer">
Line 28: Line 31:
 
</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" highlight="7,8,9,10">
 
int rowIndex;
 
int rowIndex;
 
int colIndex;
 
int colIndex;
Sheet currentSheet;
+
Worksheet currentSheet;
 
Spreadsheet spreadsheet;
 
Spreadsheet spreadsheet;
 
Menupopup cellMenupopup;
 
Menupopup cellMenupopup;
Line 46: Line 50:
 
[[File:ZKSsEss_Spreadsheet_DeleteRange_Menu.png]]
 
[[File:ZKSsEss_Spreadsheet_DeleteRange_Menu.png]]
  
===Shift cells left===
+
====Shift Cells Left====
<source lang="java" high="3">
+
<source lang="java" highlight="3">
 
public void onClick$shiftCellLeft() {
 
public void onClick$shiftCellLeft() {
 
Range rng = Ranges.range(currentSheet, rowIndex, colIndex);
 
Range rng = Ranges.range(currentSheet, rowIndex, colIndex);
Line 56: Line 60:
 
[[File:ZKSsEss_Spreadsheet_DeleteRange_ShiftLeft.png]]
 
[[File:ZKSsEss_Spreadsheet_DeleteRange_ShiftLeft.png]]
  
===Shift cells up===
+
====Shift Cells Up====
<source lang="java" high="3">
+
<source lang="java" highlight="3">
 
public void onClick$shiftCellUp() {
 
public void onClick$shiftCellUp() {
 
final Range rng = Ranges.range(currentSheet, rowIndex, colIndex);
 
final Range rng = Ranges.range(currentSheet, rowIndex, colIndex);
Line 66: Line 70:
 
[[File:ZKSsEss_Spreadsheet_DeleteRange_ShiftUp.png]]
 
[[File:ZKSsEss_Spreadsheet_DeleteRange_ShiftUp.png]]
  
===Delete entire row===
+
====Delete Entire Row====
<source lang="java" high="5">
+
<source lang="java" highlight="5">
 
public void onClick$deleteEntireRow() {
 
public void onClick$deleteEntireRow() {
 
Row row = currentSheet.getRow(rowIndex);
 
Row row = currentSheet.getRow(rowIndex);
Line 78: Line 82:
 
[[File:ZKSsEss_Spreadsheet_DeleteRange_Row.png]]
 
[[File:ZKSsEss_Spreadsheet_DeleteRange_Row.png]]
  
===Delete entire column===
+
====Delete Entire Column====
<source lang="java" high="4">
+
<source lang="java" highlight="4">
 
public void onClick$deleteEntireColumn() {
 
public void onClick$deleteEntireColumn() {
 
int tRow = currentSheet.getFirstRowNum();
 
int tRow = currentSheet.getFirstRowNum();

Latest revision as of 12:55, 19 January 2022



Stop.png This article is out of date, please refer to http://books.zkoss.org/wiki/ZK_Spreadsheet_Essentials for more up to date information.


Purpose

ZK Spreadsheet can use Range.delete(Integer) to delete range, rows or columns.

ZUML

<zk>
<div height="100%" width="100%" apply="demo.DeleteRangeComposer">
	<div height="3px"></div>
	<menupopup id="cellMenupopup">
		<menuitem id="shiftCellLeft" label="Shift cells left"></menuitem>
		<menuitem id="shiftCellUp" label="Shift cells up"/>
		<menuitem id="deleteEntireRow" label="Entire row" />
		<menuitem id="deleteEntireColumn" 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;
Worksheet 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 DeleteRange Menu.png

Shift Cells Left

public void onClick$shiftCellLeft() {
	Range rng = Ranges.range(currentSheet, rowIndex, colIndex);
	rng.delete(Range.SHIFT_LEFT);
}

ZKSsEss Spreadsheet DeleteRange ShiftLeft.png

Shift Cells Up

public void onClick$shiftCellUp() {
	final Range rng = Ranges.range(currentSheet, rowIndex, colIndex);
	rng.delete(Range.SHIFT_UP);
}

ZKSsEss Spreadsheet DeleteRange ShiftUp.png

Delete Entire Row

public void onClick$deleteEntireRow() {
	Row row = currentSheet.getRow(rowIndex);
	int lCol = row.getFirstCellNum();
	int rCol  = row.getLastCellNum();
	Ranges.range(currentSheet, rowIndex, lCol, rowIndex, rCol).delete(Range.SHIFT_UP);
}

ZKSsEss Spreadsheet DeleteRange Row.png

Delete Entire Column

public void onClick$deleteEntireColumn() {
	int tRow = currentSheet.getFirstRowNum();
	int bRow = currentSheet.getPhysicalNumberOfRows();
	Ranges.range(currentSheet, tRow, colIndex, bRow, colIndex).delete(Range.SHIFT_LEFT);
}

ZKSsEss Spreadsheet DeleteRange Column.png

Version History

Last Update : 2022/01/19


Version Date Content
     


All source code listed in this book is at Github.


Last Update : 2022/01/19

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