Package 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

    • 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.