Update javadoc for bug 56129

git-svn-id: https://svn.apache.org/repos/asf/poi/trunk@1702805 13f79535-47bb-0310-9956-ffa450edef68

diff --git a/src/java/org/apache/poi/ss/usermodel/Workbook.java b/src/java/org/apache/poi/ss/usermodel/Workbook.java
index 7de84fa88f939d3006438b76e5b09f0ff7c515d3..e5fc3c9de7632aee931be4b0ecdd313d4c9e3c8a 100644 (file)
--- a/src/java/org/apache/poi/ss/usermodel/Workbook.java
+++ b/src/java/org/apache/poi/ss/usermodel/Workbook.java
@@ -551,7 +551,10 @@ public interface Workbook extends Closeable {
     boolean isSheetVeryHidden(int sheetIx);
 
     /**
-     * Hide or unhide a sheet
+     * Hide or unhide a sheet.
+     * 
+     * Please note that the sheet currently set as active sheet (sheet 0 in a newly 
+     * created workbook or the one set via setActiveSheet()) cannot be hidden. 
      *
      * @param sheetIx the sheet index (0-based)
      * @param hidden True to mark the sheet as hidden, false otherwise
@@ -566,6 +569,10 @@ public interface Workbook extends Closeable {
      *  <li>1 - hidden. </li>
      *  <li>2 - very hidden.</li>
      * </ul>
+     * 
+     * Please note that the sheet currently set as active sheet (sheet 0 in a newly 
+     * created workbook or the one set via setActiveSheet()) cannot be hidden.
+     *  
      * @param sheetIx the sheet index (0-based)
      * @param hidden one of the following <code>Workbook</code> constants:
      *        <code>Workbook.SHEET_STATE_VISIBLE</code>,

diff --git a/src/ooxml/java/org/apache/poi/xssf/streaming/SXSSFWorkbook.java b/src/ooxml/java/org/apache/poi/xssf/streaming/SXSSFWorkbook.java
index f437b6a1a7a85c7ab16b109abbc9d7556a558964..413b5adb519436aa5d2d8c1207fe074686f55ba5 100644 (file)
--- a/src/ooxml/java/org/apache/poi/xssf/streaming/SXSSFWorkbook.java
+++ b/src/ooxml/java/org/apache/poi/xssf/streaming/SXSSFWorkbook.java
@@ -1187,6 +1187,9 @@ public class SXSSFWorkbook implements Workbook {
 
     /**
      * Hide or unhide a sheet
+     * 
+     * Please note that the sheet currently set as active sheet (sheet 0 in a newly 
+     * created workbook or the one set via setActiveSheet()) cannot be hidden. 
      *
      * @param sheetIx the sheet index (0-based)
      * @param hidden True to mark the sheet as hidden, false otherwise
@@ -1205,6 +1208,10 @@ public class SXSSFWorkbook implements Workbook {
      *  <li>1 - hidden. </li>
      *  <li>2 - very hidden.</li>
      * </ul>
+     * 
+     * Please note that the sheet currently set as active sheet (sheet 0 in a newly 
+     * created workbook or the one set via setActiveSheet()) cannot be hidden.
+     *  
      * @param sheetIx the sheet index (0-based)
      * @param hidden one of the following <code>Workbook</code> constants:
      *        <code>Workbook.SHEET_STATE_VISIBLE</code>,

diff --git a/src/ooxml/java/org/apache/poi/xssf/usermodel/XSSFWorkbook.java b/src/ooxml/java/org/apache/poi/xssf/usermodel/XSSFWorkbook.java
index 4b4a30e0b687621bea88f394673d200e9eebc800..c1cd1ff3f7904052a96dc8f3304ac0816db971bd 100644 (file)
--- a/src/ooxml/java/org/apache/poi/xssf/usermodel/XSSFWorkbook.java
+++ b/src/ooxml/java/org/apache/poi/xssf/usermodel/XSSFWorkbook.java
@@ -1714,6 +1714,9 @@ public class XSSFWorkbook extends POIXMLDocument implements Workbook, Iterable<X
      *   Calling <code>setSheetHidden(sheetIndex, false)</code> is equivalent to
      *   <code>setSheetHidden(sheetIndex, Workbook.SHEET_STATE_VISIBLE)</code>.
      * </p>
+     * 
+     * Please note that the sheet currently set as active sheet (sheet 0 in a newly 
+     * created workbook or the one set via setActiveSheet()) cannot be hidden. 
      *
      * @param sheetIx   the 0-based index of the sheet
      * @param hidden whether this sheet is hidden
@@ -1732,6 +1735,10 @@ public class XSSFWorkbook extends POIXMLDocument implements Workbook, Iterable<X
      *  <li>1 - hidden. </li>
      *  <li>2 - very hidden.</li>
      * </ul>
+     * 
+     * Please note that the sheet currently set as active sheet (sheet 0 in a newly 
+     * created workbook or the one set via setActiveSheet()) cannot be hidden.
+     *  
      * @param sheetIx the sheet index (0-based)
      * @param state one of the following <code>Workbook</code> constants:
      *        <code>Workbook.SHEET_STATE_VISIBLE</code>,