com.google.gwt.user.client.ui
Class DialogBox

java.lang.Object
  com.google.gwt.user.client.ui.UIObject
      com.google.gwt.user.client.ui.Widget
          com.google.gwt.user.client.ui.Panel
              com.google.gwt.user.client.ui.SimplePanel
                  com.google.gwt.user.client.ui.PopupPanel
                      com.google.gwt.user.client.ui.DecoratedPopupPanel
                          com.google.gwt.user.client.ui.DialogBox

All Implemented Interfaces:

HasCloseHandlers<PopupPanel>, HasHandlers, EventListener, EventPreview, HasAnimation, HasHTML, HasText, HasWidgets, MouseListener, SourcesPopupEvents, java.lang.Iterable<Widget>

public class DialogBox
extends DecoratedPopupPanel
implements HasHTML, MouseListener

A form of popup that has a caption area at the top and can be dragged by the user. Unlike a PopupPanel, calls to PopupPanel.setWidth(String) and PopupPanel.setHeight(String) will set the width and height of the dialog box itself, even if a widget has not been added as yet.

CSS Style Rules

• .gwt-DialogBox { the outside of the dialog }
• .gwt-DialogBox .Caption { the caption }
• .gwt-DialogBox .dialogContent { the wrapper around the content }
• .gwt-DialogBox .dialogTopLeft { the top left cell }
• .gwt-DialogBox .dialogTopLeftInner { the inner element of the cell }
• .gwt-DialogBox .dialogTopCenter { the top center cell, where the caption is located }
• .gwt-DialogBox .dialogTopCenterInner { the inner element of the cell }
• .gwt-DialogBox .dialogTopRight { the top right cell }
• .gwt-DialogBox .dialogTopRightInner { the inner element of the cell }
• .gwt-DialogBox .dialogMiddleLeft { the middle left cell }
• .gwt-DialogBox .dialogMiddleLeftInner { the inner element of the cell }
• .gwt-DialogBox .dialogMiddleCenter { the middle center cell, where the content is located }
• .gwt-DialogBox .dialogMiddleCenterInner { the inner element of the cell }
• .gwt-DialogBox .dialogMiddleRight { the middle right cell }
• .gwt-DialogBox .dialogMiddleRightInner { the inner element of the cell }
• .gwt-DialogBox .dialogBottomLeft { the bottom left cell }
• .gwt-DialogBox .dialogBottomLeftInner { the inner element of the cell }
• .gwt-DialogBox .dialogBottomCenter { the bottom center cell }
• .gwt-DialogBox .dialogBottomCenterInner { the inner element of the cell }
• .gwt-DialogBox .dialogBottomRight { the bottom right cell }
• .gwt-DialogBox .dialogBottomRightInner { the inner element of the cell }

Example

Use in UiBinder Templates

DialogBox elements in UiBinder templates can have one widget child and one <g:caption> child. (Note the lower case "c", meant to signal that the caption is not a runtime object, and so cannot have a ui:field attribute.) The body of the caption can be html.

For example:

 <g:DialogBox autoHide="true" modal="true">
   <g:caption><b>Caption text</b></g:caption>
   <g:HTMLPanel>
     Body text
     <g:Button ui:field='cancelButton'>Cancel</g:Button>
     <g:Button ui:field='okButton'>Okay</g:Button>
   </g:HTMLPanel>
 </g:DialogBox>
 

Nested Class Summary

static interface

DialogBox.Caption Set of characteristic interfaces supported by the DialogBox caption Note that this set might expand over time, so implement this interface at your own risk.

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

PopupPanel.PositionCallback

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

UIObject.DebugIdImpl, UIObject.DebugIdImplEnabled

Field Summary

Fields inherited from class com.google.gwt.user.client.ui.UIObject

DEBUG_ID_PREFIX

Constructor Summary

DialogBox()
Creates an empty dialog box.

DialogBox(boolean autoHide)
Creates an empty dialog box specifying its "auto-hide" property.

DialogBox(boolean autoHide, boolean modal)
Creates an empty dialog box specifying its "auto-hide" property.

Method Summary

DialogBox.Caption	getCaption() Provides access to the dialog's caption.
java.lang.String	getHTML() Gets this object's contents as HTML.
java.lang.String	getText() Gets this object's text.
void	hide() Hides the popup and detaches it from the page.
void	onBrowserEvent(Event event) Fired whenever a browser event is received.
void	onMouseDown(Widget sender, int x, int y) Deprecated. Use beginDragging(com.google.gwt.event.dom.client.MouseDownEvent) and getCaption() instead
void	onMouseEnter(Widget sender) Deprecated. Use HasMouseOverHandlers.addMouseOverHandler(com.google.gwt.event.dom.client.MouseOverHandler) instead
void	onMouseLeave(Widget sender) Deprecated. Use HasMouseOutHandlers.addMouseOutHandler(com.google.gwt.event.dom.client.MouseOutHandler) instead
void	onMouseMove(Widget sender, int x, int y) Deprecated. Use continueDragging(com.google.gwt.event.dom.client.MouseMoveEvent) and getCaption() instead
void	onMouseUp(Widget sender, int x, int y) Deprecated. Use endDragging(com.google.gwt.event.dom.client.MouseUpEvent) and getCaption() instead
void	setHTML(java.lang.String html) Sets the html string inside the caption.
void	setText(java.lang.String text) Sets the text inside the caption.
void	show() Shows the popup and attach it to the page.

Methods inherited from class com.google.gwt.user.client.ui.DecoratedPopupPanel

clear, getWidget, iterator, remove, setWidget

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

addAutoHidePartner, addCloseHandler, addPopupListener, center, getGlassStyleName, getOffsetHeight, getOffsetWidth, getPopupLeft, getPopupTop, getTitle, hide, isAnimationEnabled, isAutoHideEnabled, isAutoHideOnHistoryEventsEnabled, isGlassEnabled, isModal, isPreviewingAllNativeEvents, isShowing, isVisible, onEventPreview, onKeyDownPreview, onKeyPressPreview, onKeyUpPreview, removeAutoHidePartner, removePopupListener, setAnimationEnabled, setAutoHideEnabled, setAutoHideOnHistoryEventsEnabled, setGlassEnabled, setGlassStyleName, setHeight, setModal, setPopupPosition, setPopupPositionAndShow, setPreviewingAllNativeEvents, setTitle, setVisible, setWidth, showRelativeTo

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

add

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

fireEvent, getLayoutData, getParent, isAttached, removeFromParent, setLayoutData, sinkEvents

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

addStyleDependentName, addStyleName, ensureDebugId, ensureDebugId, getAbsoluteLeft, getAbsoluteTop, getElement, getStyleName, getStylePrimaryName, isVisible, removeStyleDependentName, removeStyleName, setPixelSize, setSize, setStyleDependentName, setStyleName, setStyleName, setStylePrimaryName, setVisible, toString, unsinkEvents

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

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

fireEvent

Constructor Detail

DialogBox

public DialogBox()

Creates an empty dialog box. It should not be shown until its child widget has been added using SimplePanel.add(Widget).

DialogBox

public DialogBox(boolean autoHide)

Creates an empty dialog box specifying its "auto-hide" property. It should not be shown until its child widget has been added using SimplePanel.add(Widget).

Parameters:

autoHide - true if the dialog should be automatically hidden when the user clicks outside of it

DialogBox

public DialogBox(boolean autoHide,
                 boolean modal)

Creates an empty dialog box specifying its "auto-hide" property. It should not be shown until its child widget has been added using SimplePanel.add(Widget).

Parameters:

autoHide - true if the dialog should be automatically hidden when the user clicks outside of it

modal - true if keyboard and mouse events for widgets not contained by the dialog should be ignored

Method Detail

getCaption

public final DialogBox.Caption getCaption()

Provides access to the dialog's caption. This method is final because the Caption interface will expand. Therefore it is highly likely that subclasses which implemented this method would end up breaking.

Returns:

the logical caption for this dialog box

getHTML

public java.lang.String getHTML()

Description copied from interface: HasHTML

Gets this object's contents as HTML.

Specified by:

getHTML in interface HasHTML

Returns:

the object's HTML

getText

public java.lang.String getText()

Description copied from interface: HasText

Gets this object's text.

Specified by:

getText in interface HasText

Returns:

the object's text

hide

public void hide()

Description copied from class: PopupPanel

Hides the popup and detaches it from the page. This has no effect if it is not currently showing.

Overrides:

hide in class PopupPanel

onBrowserEvent

public void onBrowserEvent(Event event)

Description copied from interface: EventListener

Fired whenever a browser event is received.

Specified by:

onBrowserEvent in interface EventListener

Overrides:

onBrowserEvent in class Widget

Parameters:

event - the event received

onMouseDown

@Deprecated
public void onMouseDown(Widget sender,
                                   int x,
                                   int y)

Deprecated. Use beginDragging(com.google.gwt.event.dom.client.MouseDownEvent) and getCaption() instead

Description copied from interface: MouseListener

Fired when the user depresses the mouse button over a widget.

Specified by:

onMouseDown in interface MouseListener

Parameters:

sender - the widget sending the event

x - the x coordinate of the mouse

y - the y coordinate of the mouse

onMouseEnter

@Deprecated
public void onMouseEnter(Widget sender)

Deprecated. Use HasMouseOverHandlers.addMouseOverHandler(com.google.gwt.event.dom.client.MouseOverHandler) instead

Description copied from interface: MouseListener

Fired when the mouse enters a widget's area.

Specified by:

onMouseEnter in interface MouseListener

Parameters:

sender - the widget sending the event

onMouseLeave

@Deprecated
public void onMouseLeave(Widget sender)

Deprecated. Use HasMouseOutHandlers.addMouseOutHandler(com.google.gwt.event.dom.client.MouseOutHandler) instead

Description copied from interface: MouseListener

Fired when the mouse leaves a widget's area.

Specified by:

onMouseLeave in interface MouseListener

Parameters:

sender - the widget sending the event

onMouseMove

@Deprecated
public void onMouseMove(Widget sender,
                                   int x,
                                   int y)

Deprecated. Use continueDragging(com.google.gwt.event.dom.client.MouseMoveEvent) and getCaption() instead

Description copied from interface: MouseListener

Fired when the user moves the mouse over a widget.

Specified by:

onMouseMove in interface MouseListener

Parameters:

sender - the widget sending the event

x - the x coordinate of the mouse

y - the y coordinate of the mouse

onMouseUp

@Deprecated
public void onMouseUp(Widget sender,
                                 int x,
                                 int y)

Deprecated. Use endDragging(com.google.gwt.event.dom.client.MouseUpEvent) and getCaption() instead

Description copied from interface: MouseListener

Fired when the user releases the mouse button over a widget.

Specified by:

onMouseUp in interface MouseListener

Parameters:

sender - the widget sending the event

x - the x coordinate of the mouse

y - the y coordinate of the mouse

setHTML

public void setHTML(java.lang.String html)

Sets the html string inside the caption. Use DecoratedPopupPanel.setWidget(Widget) to set the contents inside the DialogBox.

Specified by:

setHTML in interface HasHTML

Parameters:

html - the object's new HTML

setText

public void setText(java.lang.String text)

Sets the text inside the caption. Use DecoratedPopupPanel.setWidget(Widget) to set the contents inside the DialogBox.

Specified by:

setText in interface HasText

Parameters:

text - the object's new text

show

public void show()

Description copied from class: PopupPanel

Shows the popup and attach it to the page. It must have a child widget before this method is called.

Overrides:

show in class PopupPanel