Contact us
Create app
com.vaadin.client.ui.

Class VWindow

  • All Implemented Interfaces:

    com.google.gwt.event.dom.client.BlurHandler, com.google.gwt.event.dom.client.FocusHandler, com.google.gwt.event.dom.client.KeyDownHandler, com.google.gwt.event.dom.client.ScrollHandler, com.google.gwt.event.logical.shared.CloseHandler<com.google.gwt.user.client.ui.PopupPanel>, com.google.gwt.event.logical.shared.HasAttachHandlers, com.google.gwt.event.logical.shared.HasCloseHandlers<com.google.gwt.user.client.ui.PopupPanel>, com.google.gwt.event.shared.EventHandler, com.google.gwt.event.shared.HasHandlers, com.google.gwt.user.client.EventListener, com.google.gwt.user.client.EventPreview, com.google.gwt.user.client.ui.AcceptsOneWidget, com.google.gwt.user.client.ui.HasAnimation, com.google.gwt.user.client.ui.HasOneWidget, com.google.gwt.user.client.ui.HasVisibility, com.google.gwt.user.client.ui.HasWidgets, com.google.gwt.user.client.ui.HasWidgets.ForIsWidget, com.google.gwt.user.client.ui.IsWidget, com.google.gwt.user.client.ui.SourcesPopupEvents, Focusable, ShortcutActionHandler.ShortcutActionHandlerOwner, Iterable<com.google.gwt.user.client.ui.Widget>

    public class VWindow
extends VOverlay
implements ShortcutActionHandler.ShortcutActionHandlerOwner, com.google.gwt.event.dom.client.ScrollHandler, com.google.gwt.event.dom.client.KeyDownHandler, com.google.gwt.event.dom.client.FocusHandler, com.google.gwt.event.dom.client.BlurHandler, Focusable

    "Sub window" component.

    Author:

    Vaadin Ltd

    • Nested Class Summary

      • Nested classes/interfaces inherited from class com.google.gwt.user.client.ui.PopupPanel

        com.google.gwt.user.client.ui.PopupPanel.AnimationType, com.google.gwt.user.client.ui.PopupPanel.PositionCallback

      • Nested classes/interfaces inherited from class com.google.gwt.user.client.ui.UIObject

        com.google.gwt.user.client.ui.UIObject.DebugIdImpl, com.google.gwt.user.client.ui.UIObject.DebugIdImplEnabled

      • Nested classes/interfaces inherited from interface com.google.gwt.user.client.ui.HasWidgets

        com.google.gwt.user.client.ui.HasWidgets.ForIsWidget

    • Constructor Summary

      Constructors
      Constructor Description
      VWindow()  

    • Method Summary

      All Methods
      Modifier and Type Method Description
      com.google.gwt.event.shared.HandlerRegistration addMoveHandler​(WindowMoveHandler handler)

      Adds a Handler for when user moves the window.
      void addStyleDependentName​(String styleSuffix)  
      static com.google.gwt.event.shared.HandlerRegistration addWindowOrderHandler​(WindowOrderHandler handler)

      Adds a Handler for window order change event.
      void bringToFront()  
      protected void constructDOM()  
      static void deferOrdering()

      Calling this method will defer ordering algorithm, to order windows based on servers bringToFront and modality instructions.
      void focus()

      Sets focus to this widget.
      List<Connector> getAssistiveDescription()

      Gets the connectors that are used as assistive description.
      String getAssistivePostfix()

      Getter for the text for assistive devices the window caption is postfixed with.
      String getAssistivePrefix()

      Getter for the text for assistive devices the window caption is prefixed with.
      protected com.google.gwt.user.client.Element getContainerElement()  
      protected com.google.gwt.user.client.Element getModalityCurtain()  
      ShortcutActionHandler getShortcutActionHandler()

      Returns the ShortCutActionHandler currently used or null if there is currently no shortcutactionhandler
      String getTabStopBottomAssistiveText()

      Gets the message that is provided to users of assistive devices when the user reaches the bottom of the window when leaving a window with the tab key is prevented.
      String getTabStopTopAssistiveText()

      Gets the message that is provided to users of assistive devices when the user reaches the top of the window when leaving a window with the tab key is prevented.
      int getWindowOrder()

      Returns window position in list of opened and shown windows.
      void hide()  
      protected boolean isClosable()

      Returns the closable state of the sub window.
      static boolean isModalWindowOpen()

      Checks if a modal window is currently open.
      protected void onAttach()  
      void onBlur​(com.google.gwt.event.dom.client.BlurEvent event)  
      void onBrowserEvent​(com.google.gwt.user.client.Event event)  
      protected void onDetach()  
      boolean onEventPreview​(com.google.gwt.user.client.Event event)  
      void onFocus​(com.google.gwt.event.dom.client.FocusEvent event)  
      void onKeyDown​(com.google.gwt.event.dom.client.KeyDownEvent event)  
      void onScroll​(com.google.gwt.event.dom.client.ScrollEvent event)  
      void setAssistiveDescription​(Connector[] connectors)

      Allows to specify which connectors contain the description for the window.
      void setAssistivePostfix​(String assistivePostfix)

      Setter for the text for assistive devices the window caption is postfixed with.
      void setAssistivePrefix​(String assistivePrefix)

      Setter for the text for assistive devices the window caption is prefixed with.
      void setCaption​(String c)  
      void setCaption​(String c, String iconURL)  
      void setCaption​(String c, String iconURL, boolean asHtml)  
      void setClosable​(boolean closable)

      Sets the closable state of the window.
      void setDraggable​(boolean draggable)

      For internal use only.
      void setHeight​(String height)  
      void setPopupPosition​(int left, int top)  
      void setPopupPositionNoUpdate​(int left, int top)  
      void setResizable​(boolean resizability)

      For internal use only.
      void setTabStopBottomAssistiveText​(String bottomMessage)

      Sets the message that is provided to users of assistive devices when the user reaches the bottom of the window when leaving a window with the tab key is prevented.
      void setTabStopEnabled​(boolean doTabStop)

      Registers the handlers that prevent to leave the window using the Tab-key.
      void setTabStopTopAssistiveText​(String topMessage)

      Sets the message that is provided to users of assistive devices when the user reaches the top of the window when leaving a window with the tab key is prevented.
      void setVaadinModality​(boolean modality)

      For internal use only.
      void setVisible​(boolean visible)  
      void setWaiAriaRole​(WindowRole role)

      Sets the WAI-ARIA role the window.
      void setWidth​(String width)  
      void setWindowOrderAndPosition()

      For internal use only.
      protected void setZIndex​(int zIndex)

      Set the z-index (visual stack position) for this overlay.
      void show()  
      void updateContentsSize()  
      void updateMaximizeRestoreClassName​(boolean visible, WindowMode windowMode)  

      • Methods inherited from class com.google.gwt.user.client.ui.PopupPanel

        addAutoHidePartner, addCloseHandler, addPopupListener, getAnimationType, getGlassElement, getGlassStyleName, getOffsetHeight, getOffsetWidth, getPopupLeft, getPopupTop, getStyleElement, getTitle, isAnimationEnabled, isAutoHideEnabled, isAutoHideOnHistoryEventsEnabled, isGlassEnabled, isModal, isPreviewingAllNativeEvents, isShowing, isVisible, onKeyDownPreview, onKeyPressPreview, onKeyUpPreview, onPreviewNativeEvent, onUnload, removeAutoHidePartner, removePopupListener, setAnimationEnabled, setAnimationType, setAutoHideEnabled, setAutoHideOnHistoryEventsEnabled, setGlassEnabled, setGlassStyleName, setModal, setPopupPositionAndShow, setPreviewingAllNativeEvents, setTitle, setWidget, showRelativeTo

      • Methods inherited from class com.google.gwt.user.client.ui.SimplePanel

        add, getWidget, iterator, remove, setWidget

      • Methods inherited from class com.google.gwt.user.client.ui.Panel

        add, adopt, clear, doAttachChildren, doDetachChildren, orphan, remove

      • Methods inherited from class com.google.gwt.user.client.ui.Widget

        addAttachHandler, addBitlessDomHandler, addDomHandler, addHandler, asWidget, asWidgetOrNull, createHandlerManager, delegateEvent, fireEvent, getHandlerCount, getLayoutData, getParent, isAttached, isOrWasAttached, onLoad, removeFromParent, setLayoutData, unsinkEvents

      • Methods inherited from class com.google.gwt.user.client.ui.UIObject

        addStyleName, ensureDebugId, ensureDebugId, ensureDebugId, getAbsoluteLeft, getAbsoluteTop, getElement, getStyleName, getStyleName, getStylePrimaryName, getStylePrimaryName, isVisible, onEnsureDebugId, removeStyleDependentName, removeStyleName, resolvePotentialElement, setElement, setElement, setPixelSize, setSize, setStyleDependentName, setStyleName, setStyleName, setStyleName, setStyleName, setStylePrimaryName, setStylePrimaryName, setVisible, sinkBitlessEvent, toString

      • Methods inherited from interface com.google.gwt.event.logical.shared.CloseHandler

        onClose

      • Methods inherited from interface com.google.gwt.event.shared.HasHandlers

        fireEvent

      • Methods inherited from interface com.google.gwt.user.client.ui.HasWidgets

        add, clear, iterator, remove

    • Field Detail

      • contents

        public com.google.gwt.dom.client.Element contents

        For internal use only. May be removed or replaced in the future.

      • header

        public com.google.gwt.dom.client.Element header

        For internal use only. May be removed or replaced in the future.

      • footer

        public com.google.gwt.dom.client.Element footer

        For internal use only. May be removed or replaced in the future.

      • contentPanel

        public final FocusableScrollPanel contentPanel

        For internal use only. May be removed or replaced in the future.

      • closeBox

        public com.google.gwt.dom.client.Element closeBox

        For internal use only. May be removed or replaced in the future.

      • maximizeRestoreBox

        public com.google.gwt.dom.client.Element maximizeRestoreBox

        For internal use only. May be removed or replaced in the future.

      • client

        public ApplicationConnection client

        For internal use only. May be removed or replaced in the future.

      • id

        public String id

        For internal use only. May be removed or replaced in the future.

      • shortcutHandler

        public ShortcutActionHandler shortcutHandler

        For internal use only. May be removed or replaced in the future.

      • vaadinModality

        public boolean vaadinModality

        For internal use only. May be removed or replaced in the future.

      • resizable

        public boolean resizable

        For internal use only. May be removed or replaced in the future.

      • resizeLazy

        public boolean resizeLazy

        For internal use only. May be removed or replaced in the future.

      • centered

        public boolean centered

        If centered (via UIDL), the window should stay in the centered -mode until a position is received from the server, or the user moves or resizes the window.

        For internal use only. May be removed or replaced in the future.

      • immediate

        public boolean immediate

        For internal use only. May be removed or replaced in the future.

      • visibilityChangesDisabled

        public boolean visibilityChangesDisabled

        For internal use only. May be removed or replaced in the future.

      • bringToFrontSequence

        public int bringToFrontSequence

        For internal use only. May be removed or replaced in the future.

    • Constructor Detail

      • VWindow

        public VWindow()

    • Method Detail

      • onAttach

        protected void onAttach()

        Overrides:

        onAttach in class Overlay

      • onDetach

        protected void onDetach()

        Overrides:

        onDetach in class Overlay

      • bringToFront

        public void bringToFront()

      • setWindowOrderAndPosition

        public void setWindowOrderAndPosition()

        For internal use only. May be removed or replaced in the future.

      • getWindowOrder

        public final int getWindowOrder()

        Returns window position in list of opened and shown windows.

        Since:

        7.7.12

      • setZIndex

        protected void setZIndex​(int zIndex)

        Description copied from class: Overlay

        Set the z-index (visual stack position) for this overlay.

        Overrides:

        setZIndex in class Overlay

        Parameters:

        zIndex - The new z-index

      • getModalityCurtain

        protected com.google.gwt.user.client.Element getModalityCurtain()

      • constructDOM

        protected void constructDOM()

      • setTabStopTopAssistiveText

        public void setTabStopTopAssistiveText​(String topMessage)

        Sets the message that is provided to users of assistive devices when the user reaches the top of the window when leaving a window with the tab key is prevented.

        This message is not visible on the screen.

        Parameters:

        topMessage - String provided when the user navigates with Shift-Tab keys to the top of the window

      • setTabStopBottomAssistiveText

        public void setTabStopBottomAssistiveText​(String bottomMessage)

        Sets the message that is provided to users of assistive devices when the user reaches the bottom of the window when leaving a window with the tab key is prevented.

        This message is not visible on the screen.

        Parameters:

        bottomMessage - String provided when the user navigates with the Tab key to the bottom of the window

      • getTabStopTopAssistiveText

        public String getTabStopTopAssistiveText()

        Gets the message that is provided to users of assistive devices when the user reaches the top of the window when leaving a window with the tab key is prevented.

        Returns:

        the top message

      • getTabStopBottomAssistiveText

        public String getTabStopBottomAssistiveText()

        Gets the message that is provided to users of assistive devices when the user reaches the bottom of the window when leaving a window with the tab key is prevented.

        Returns:

        the bottom message

      • deferOrdering

        public static void deferOrdering()

        Calling this method will defer ordering algorithm, to order windows based on servers bringToFront and modality instructions. Non changed windows will be left intact.

        For internal use only. May be removed or replaced in the future.

      • setVisible

        public void setVisible​(boolean visible)

        Specified by:

        setVisible in interface com.google.gwt.user.client.ui.HasVisibility

        Overrides:

        setVisible in class Overlay

      • setDraggable

        public void setDraggable​(boolean draggable)

        For internal use only. May be removed or replaced in the future.

      • setClosable

        public void setClosable​(boolean closable)

        Sets the closable state of the window. Additionally hides/shows the close button according to the new state.

        Parameters:

        closable - true if the window can be closed by the user

      • isClosable

        protected boolean isClosable()

        Returns the closable state of the sub window. If the sub window is closable a decoration (typically an X) is shown to the user. By clicking on the X the user can close the window.

        Returns:

        true if the sub window is closable

      • show

        public void show()

        Overrides:

        show in class Overlay

      • hide

        public void hide()

        Overrides:

        hide in class Overlay

      • setVaadinModality

        public void setVaadinModality​(boolean modality)

        For internal use only. May be removed or replaced in the future.

      • setResizable

        public void setResizable​(boolean resizability)

        For internal use only. May be removed or replaced in the future.

      • updateMaximizeRestoreClassName

        public void updateMaximizeRestoreClassName​(boolean visible,
                                           WindowMode windowMode)

      • setPopupPositionNoUpdate

        public void setPopupPositionNoUpdate​(int left,
                                     int top)

      • setPopupPosition

        public void setPopupPosition​(int left,
                             int top)

        Overrides:

        setPopupPosition in class Overlay

      • setCaption

        public void setCaption​(String c)

      • setCaption

        public void setCaption​(String c,
                       String iconURL)

      • setCaption

        public void setCaption​(String c,
                       String iconURL,
                       boolean asHtml)

      • setAssistivePrefix

        public void setAssistivePrefix​(String assistivePrefix)

        Setter for the text for assistive devices the window caption is prefixed with.

        Parameters:

        assistivePrefix - the assistivePrefix to set

      • getAssistivePrefix

        public String getAssistivePrefix()

        Getter for the text for assistive devices the window caption is prefixed with.

        Returns:

        the assistivePrefix

      • setAssistivePostfix

        public void setAssistivePostfix​(String assistivePostfix)

        Setter for the text for assistive devices the window caption is postfixed with.

        Parameters:

        assistivePostfix - the assistivePostfix to set

      • getAssistivePostfix

        public String getAssistivePostfix()

        Getter for the text for assistive devices the window caption is postfixed with.

        Returns:

        the assistivePostfix

      • getContainerElement

        protected com.google.gwt.user.client.Element getContainerElement()

        Overrides:

        getContainerElement in class com.google.gwt.user.client.ui.PopupPanel

      • onBrowserEvent

        public void onBrowserEvent​(com.google.gwt.user.client.Event event)

        Specified by:

        onBrowserEvent in interface com.google.gwt.user.client.EventListener

        Overrides:

        onBrowserEvent in class com.google.gwt.user.client.ui.Widget

      • updateContentsSize

        public void updateContentsSize()

      • onEventPreview

        public boolean onEventPreview​(com.google.gwt.user.client.Event event)

        Specified by:

        onEventPreview in interface com.google.gwt.user.client.EventPreview

        Overrides:

        onEventPreview in class com.google.gwt.user.client.ui.PopupPanel

      • addStyleDependentName

        public void addStyleDependentName​(String styleSuffix)

        Overrides:

        addStyleDependentName in class com.google.gwt.user.client.ui.UIObject

      • onScroll

        public void onScroll​(com.google.gwt.event.dom.client.ScrollEvent event)

        Specified by:

        onScroll in interface com.google.gwt.event.dom.client.ScrollHandler

      • onKeyDown

        public void onKeyDown​(com.google.gwt.event.dom.client.KeyDownEvent event)

        Specified by:

        onKeyDown in interface com.google.gwt.event.dom.client.KeyDownHandler

      • onBlur

        public void onBlur​(com.google.gwt.event.dom.client.BlurEvent event)

        Specified by:

        onBlur in interface com.google.gwt.event.dom.client.BlurHandler

      • onFocus

        public void onFocus​(com.google.gwt.event.dom.client.FocusEvent event)

        Specified by:

        onFocus in interface com.google.gwt.event.dom.client.FocusHandler

      • focus

        public void focus()

        Description copied from interface: Focusable

        Sets focus to this widget.

        Specified by:

        focus in interface Focusable

      • setAssistiveDescription

        public void setAssistiveDescription​(Connector[] connectors)

        Allows to specify which connectors contain the description for the window. Text contained in the widgets of the connectors will be read by assistive devices when it is opened.

        When the provided array is empty, an existing description is removed.

        Parameters:

        connectors - with the connectors of the widgets to use as description

      • getAssistiveDescription

        public List<Connector> getAssistiveDescription()

        Gets the connectors that are used as assistive description. Text contained in these connectors will be read by assistive devices when the window is opened.

        Returns:

        list of previously set connectors

      • setWaiAriaRole

        public void setWaiAriaRole​(WindowRole role)

        Sets the WAI-ARIA role the window. This role defines how an assistive device handles a window. Available roles are alertdialog and dialog (@see Roles Model). The default role is dialog.

        Parameters:

        role - WAI-ARIA role to set for the window

      • setTabStopEnabled

        public void setTabStopEnabled​(boolean doTabStop)

        Registers the handlers that prevent to leave the window using the Tab-key.

        The value of the parameter doTabStop is stored and used for non-modal windows. For modal windows, the handlers are always registered, while preserving the stored value.

        Parameters:

        doTabStop - true to prevent leaving the window, false to allow leaving the window for non modal windows

      • addMoveHandler

        public com.google.gwt.event.shared.HandlerRegistration addMoveHandler​(WindowMoveHandler handler)

        Adds a Handler for when user moves the window.

        Returns:

        HandlerRegistration used to remove the handler

        Since:

        7.1.9

      • addWindowOrderHandler

        public static com.google.gwt.event.shared.HandlerRegistration addWindowOrderHandler​(WindowOrderHandler handler)

        Adds a Handler for window order change event.

        Returns:

        registration object to deregister the handler

        Since:

        7.7.12

      • isModalWindowOpen

        public static boolean isModalWindowOpen()

        Checks if a modal window is currently open.

        Returns:

        true if a modal window is open, false otherwise.