Merged VPopupView showPopupView javadoc from 6.1

svn changeset:9589/svn branch:6.2

1 files changed, 11 insertions, 0 deletions

diff --git a/src/com/vaadin/terminal/gwt/client/ui/VPopupView.java b/src/com/vaadin/terminal/gwt/client/ui/VPopupView.java
index 36706bdede..630302eeaf 100644
--- a/src/com/vaadin/terminal/gwt/client/ui/VPopupView.java
+++ b/src/com/vaadin/terminal/gwt/client/ui/VPopupView.java
@@ -150,6 +150,17 @@ public class VPopupView extends HTML implements Container, Iterable<Widget> {
         popup.show();
     }
 
+    /**
+     * Determines the correct position for a popup and displays the popup at
+     * that position.
+     * 
+     * By default, the popup is shown centered relative to its host component,
+     * ensuring it is visible on the screen if possible.
+     *
+     * Can be overridden to customize the popup position.
+     *
+     * @param popup
+     */
     protected void showPopup(final CustomPopup popup) {
         int windowTop = RootPanel.get().getAbsoluteTop();
         int windowLeft = RootPanel.get().getAbsoluteLeft();