From 125fb56e4bb2e6f0b850278006714912018db65f Mon Sep 17 00:00:00 2001
From: Matti Tahvonen <matti.tahvonen@itmill.com>
Date: Wed, 4 May 2011 07:52:01 +0000
Subject: Enhanced javadoc

svn changeset:18623/svn branch:6.6
---
 src/com/vaadin/ui/Table.java | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

(limited to 'src')

diff --git a/src/com/vaadin/ui/Table.java b/src/com/vaadin/ui/Table.java
index a76153f772..93987cff35 100644
--- a/src/com/vaadin/ui/Table.java
+++ b/src/com/vaadin/ui/Table.java
@@ -3139,7 +3139,16 @@ public class Table extends AbstractSelect implements Action.Container,
     }
 
     /**
-     * Returns the list of items on the current page
+     * Returns item identifiers of the items which are currently rendered on the
+     * client.
+     * <p>
+     * Note, that some due to historical reasons the name of the method is bit
+     * misleading. Some items may be partly or totally out of the viewport of
+     * the table's scrollable area. Actully detecting rows which can be actually
+     * seen by the end user may be problematic due to the client server
+     * architecture. Using {@link #getCurrentPageFirstItemId()} combined with
+     * {@link #getPageLength()} may produce good enough estimates in some
+     * situations.
      * 
      * @see com.vaadin.ui.Select#getVisibleItemIds()
      */
-- 
cgit v1.2.3