com.google.gwt.user.client.ui
Class HTMLPanel
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.ComplexPanel
com.google.gwt.user.client.ui.HTMLPanel
- All Implemented Interfaces:
- EventListener, HasWidgets, IndexedPanel, java.lang.Iterable<Widget>
public class HTMLPanel
- extends ComplexPanel
A panel that contains HTML, and which can attach child widgets to identified
elements within that HTML.
Constructor Summary |
HTMLPanel(java.lang.String html)
Creates an HTML panel with the specified HTML contents. |
Method Summary |
void |
add(Widget widget,
java.lang.String id)
Adds a child widget to the panel, contained within the HTML element
specified by a given id. |
void |
addAndReplaceElement(Widget widget,
java.lang.String id)
Adds a child widget to the panel, replacing the HTML element specified by a
given id. |
static java.lang.String |
createUniqueId()
A helper method for creating unique IDs for elements within dynamically-
generated HTML. |
Element |
getElementById(java.lang.String id)
Finds an element within this panel by its id. |
Methods inherited from class com.google.gwt.user.client.ui.ComplexPanel |
add, adjustIndex, checkIndexBoundsForAccess, checkIndexBoundsForInsertion, getChildren, getWidget, getWidgetCount, getWidgetIndex, insert, insert, iterator, remove, remove |
Methods inherited from class com.google.gwt.user.client.ui.UIObject |
addStyleDependentName, addStyleName, ensureDebugId, ensureDebugId, ensureDebugId, getAbsoluteLeft, getAbsoluteTop, getElement, getOffsetHeight, getOffsetWidth, getStyleElement, getStyleName, getStyleName, getStylePrimaryName, getStylePrimaryName, getTitle, isVisible, isVisible, onEnsureDebugId, removeStyleDependentName, removeStyleName, setElement, setElement, setHeight, setPixelSize, setSize, setStyleName, setStyleName, setStyleName, setStylePrimaryName, setStylePrimaryName, setTitle, setVisible, setVisible, setWidth, sinkEvents, toString, unsinkEvents |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
HTMLPanel
public HTMLPanel(java.lang.String html)
- Creates an HTML panel with the specified HTML contents. Any element within
this HTML that has a specified id can contain a child widget.
- Parameters:
html
- the panel's HTML
createUniqueId
public static java.lang.String createUniqueId()
- A helper method for creating unique IDs for elements within dynamically-
generated HTML. This is important because no two elements in a document
should have the same id.
- Returns:
- a new unique identifier
add
public void add(Widget widget,
java.lang.String id)
- Adds a child widget to the panel, contained within the HTML element
specified by a given id.
- Parameters:
widget
- the widget to be addedid
- the id of the element within which it will be contained
addAndReplaceElement
public void addAndReplaceElement(Widget widget,
java.lang.String id)
- Adds a child widget to the panel, replacing the HTML element specified by a
given id.
- Parameters:
widget
- the widget to be addedid
- the id of the element to be replaced by the widget
getElementById
public Element getElementById(java.lang.String id)
- Finds an
element
within this panel by its id.
- Parameters:
id
- the id of the element to be found
- Returns:
- the element with the given id, or
null
if none is found