|
GWT 2.7.0 | |||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||
java.lang.Objectcom.google.gwt.user.client.ui.UIObject
com.google.gwt.user.client.ui.Widget
com.google.gwt.user.client.ui.Composite
com.google.gwt.user.client.ui.TabPanel
public class TabPanel
A panel that represents a tabbed set of pages, each of which contains another widget. Its child widgets are shown as the user selects the various tabs associated with them. The tabs can contain arbitrary HTML.
This widget will only work in quirks mode. If your application is in
Standards Mode, use TabLayoutPanel instead.
Note that this widget is not a panel per se, but rather a
Composite that aggregates a
TabBar and a
DeckPanel. It does, however, implement
HasWidgets.
public class TabPanelExample implements EntryPoint {
public void onModuleLoad() {
// Create a tab panel with three tabs, each of which displays a different
// piece of text.
TabPanel tp = new TabPanel();
tp.add(new HTML("Foo"), "foo");
tp.add(new HTML("Bar"), "bar");
tp.add(new HTML("Baz"), "baz");
// Show the 'bar' tab initially.
tp.selectTab(1);
// Add it to the root panel.
RootPanel.get().add(tp);
}
}
TabLayoutPanel| Nested Class Summary |
|---|
| Nested classes/interfaces inherited from class com.google.gwt.user.client.ui.UIObject |
|---|
UIObject.DebugIdImpl, UIObject.DebugIdImplEnabled |
| Nested classes/interfaces inherited from interface com.google.gwt.user.client.ui.HasWidgets |
|---|
HasWidgets.ForIsWidget |
| Field Summary |
|---|
| Fields inherited from class com.google.gwt.user.client.ui.Widget |
|---|
eventsToSink |
| Fields inherited from class com.google.gwt.user.client.ui.UIObject |
|---|
DEBUG_ID_PREFIX, MISSING_ELEMENT_ERROR, SETELEMENT_TWICE_ERROR |
| Constructor Summary | |
|---|---|
TabPanel()
Creates an empty tab panel. |
|
| Method Summary | |
|---|---|
void |
add(IsWidget w,
IsWidget tabWidget)
Convenience overload to allow IsWidget to be used directly. |
void |
add(IsWidget w,
java.lang.String tabText)
Convenience overload to allow IsWidget to be used directly. |
void |
add(IsWidget w,
java.lang.String tabText,
boolean asHTML)
Convenience overload to allow IsWidget to be used directly. |
void |
add(Widget w)
Adds a child widget. |
void |
add(Widget w,
java.lang.String tabText)
Adds a widget to the tab panel. |
void |
add(Widget w,
java.lang.String tabText,
boolean asHTML)
Adds a widget to the tab panel. |
void |
add(Widget w,
Widget tabWidget)
Adds a widget to the tab panel. |
HandlerRegistration |
addBeforeSelectionHandler(BeforeSelectionHandler<java.lang.Integer> handler)
Adds a BeforeSelectionEvent handler. |
HandlerRegistration |
addSelectionHandler(SelectionHandler<java.lang.Integer> handler)
Adds a SelectionEvent handler. |
void |
addTabListener(TabListener listener)
Deprecated. Use addBeforeSelectionHandler(com.google.gwt.event.logical.shared.BeforeSelectionHandler and addSelectionHandler(com.google.gwt.event.logical.shared.SelectionHandler instead |
void |
clear()
Removes all child widgets. |
protected SimplePanel |
createTabTextWrapper()
Create a SimplePanel that will wrap the contents in a tab. |
DeckPanel |
getDeckPanel()
Gets the deck panel within this tab panel. |
TabBar |
getTabBar()
Gets the tab bar within this tab panel. |
Widget |
getWidget(int index)
Gets the child widget at the specified index. |
int |
getWidgetCount()
Gets the number of child widgets in this panel. |
int |
getWidgetIndex(IsWidget child)
Convenience overload to allow IsWidget to be used directly. |
int |
getWidgetIndex(Widget widget)
Gets the index of the specified child widget. |
void |
insert(IsWidget widget,
IsWidget tabWidget,
int beforeIndex)
Convenience overload to allow IsWidget to be used directly. |
void |
insert(IsWidget widget,
java.lang.String tabText,
boolean asHTML,
int beforeIndex)
Convenience overload to allow IsWidget to be used directly. |
void |
insert(IsWidget widget,
java.lang.String tabText,
int beforeIndex)
Convenience overload to allow IsWidget to be used directly. |
void |
insert(Widget widget,
java.lang.String tabText,
boolean asHTML,
int beforeIndex)
Inserts a widget into the tab panel. |
void |
insert(Widget widget,
java.lang.String tabText,
int beforeIndex)
Inserts a widget into the tab panel. |
void |
insert(Widget widget,
Widget tabWidget,
int beforeIndex)
Inserts a widget into the tab panel. |
boolean |
isAnimationEnabled()
Returns true if animations are enabled, false if not. |
java.util.Iterator<Widget> |
iterator()
Gets an iterator for the contained widgets. |
boolean |
onBeforeTabSelected(SourcesTabEvents sender,
int tabIndex)
Deprecated. Use BeforeSelectionHandler.onBeforeSelection(com.google.gwt.event.logical.shared.BeforeSelectionEvent instead |
protected void |
onEnsureDebugId(java.lang.String baseID)
Affected Elements: -bar = The tab bar. -bar-tab# = The element containing the content of the tab itself. -bar-tab-wrapper# = The cell containing the tab at the index. -bottom = The panel beneath the tab bar. |
void |
onTabSelected(SourcesTabEvents sender,
int tabIndex)
Deprecated. Use SelectionHandler.onSelection(com.google.gwt.event.logical.shared.SelectionEvent instead |
boolean |
remove(int index)
Removes the widget at the specified index. |
boolean |
remove(Widget widget)
Removes the given widget, and its associated tab. |
void |
removeTabListener(TabListener listener)
Deprecated. Use the HandlerRegistration.removeHandler()
method on the object returned by and add*Handler method instead |
void |
selectTab(int index)
Programmatically selects the specified tab and fires events. |
void |
selectTab(int index,
boolean fireEvents)
Programmatically selects the specified tab. |
void |
setAnimationEnabled(boolean enable)
Enable or disable animations. |
| Methods inherited from class com.google.gwt.user.client.ui.Composite |
|---|
claimElement, getWidget, initializeClaimedElement, initWidget, isAttached, onAttach, onBrowserEvent, onDetach, render, render, resolvePotentialElement, setWidget |
| Methods inherited from class com.google.gwt.user.client.ui.Widget |
|---|
addAttachHandler, addBitlessDomHandler, addDomHandler, addHandler, asWidget, asWidgetOrNull, createHandlerManager, delegateEvent, doAttachChildren, doDetachChildren, ensureHandlers, fireEvent, getHandlerCount, getHandlerManager, getLayoutData, getParent, isOrWasAttached, onLoad, onUnload, removeFromParent, replaceElement, setLayoutData, setParent, sinkEvents, unsinkEvents |
| 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, removeStyleDependentName, removeStyleName, setElement, setElement, setHeight, setPixelSize, setSize, setStyleDependentName, setStyleName, setStyleName, setStyleName, setStyleName, setStylePrimaryName, setStylePrimaryName, setTitle, setVisible, setVisible, setWidth, sinkBitlessEvent, toString |
| Methods inherited from class java.lang.Object |
|---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
| Methods inherited from interface com.google.gwt.event.shared.HasHandlers |
|---|
fireEvent |
| Constructor Detail |
|---|
public TabPanel()
| Method Detail |
|---|
public void add(IsWidget w,
IsWidget tabWidget)
IsWidget to be used directly.
public void add(IsWidget w,
java.lang.String tabText)
IsWidget to be used directly.
public void add(IsWidget w,
java.lang.String tabText,
boolean asHTML)
IsWidget to be used directly.
public void add(Widget w)
HasWidgets
add in interface HasWidgetsw - the widget to be added
public void add(Widget w,
java.lang.String tabText)
w - the widget to be addedtabText - the text to be shown on its tab
public void add(Widget w,
java.lang.String tabText,
boolean asHTML)
w - the widget to be addedtabText - the text to be shown on its tabasHTML - true to treat the specified text as HTML
public void add(Widget w,
Widget tabWidget)
w - the widget to be addedtabWidget - the widget to be shown in the tabpublic HandlerRegistration addBeforeSelectionHandler(BeforeSelectionHandler<java.lang.Integer> handler)
HasBeforeSelectionHandlersBeforeSelectionEvent handler.
addBeforeSelectionHandler in interface HasBeforeSelectionHandlers<java.lang.Integer>handler - the handler
public HandlerRegistration addSelectionHandler(SelectionHandler<java.lang.Integer> handler)
HasSelectionHandlersSelectionEvent handler.
addSelectionHandler in interface HasSelectionHandlers<java.lang.Integer>handler - the handler
@Deprecated public void addTabListener(TabListener listener)
addBeforeSelectionHandler(com.google.gwt.event.logical.shared.BeforeSelectionHandler) and addSelectionHandler(com.google.gwt.event.logical.shared.SelectionHandler) instead
SourcesTabEvents
addTabListener in interface SourcesTabEventslistener - the listener interface to addpublic void clear()
HasWidgets
clear in interface HasWidgetspublic DeckPanel getDeckPanel()
public TabBar getTabBar()
public Widget getWidget(int index)
IndexedPanel
getWidget in interface IndexedPanelindex - the child widget's index
public int getWidgetCount()
IndexedPanel
getWidgetCount in interface IndexedPanelpublic int getWidgetIndex(IsWidget child)
IsWidget to be used directly.
getWidgetIndex in interface IndexedPanel.ForIsWidgetpublic int getWidgetIndex(Widget widget)
IndexedPanel
getWidgetIndex in interface IndexedPanelwidget - the widget to be found
-1 if it is not a child of this
panel
public void insert(IsWidget widget,
IsWidget tabWidget,
int beforeIndex)
IsWidget to be used directly.
public void insert(IsWidget widget,
java.lang.String tabText,
boolean asHTML,
int beforeIndex)
IsWidget to be used directly.
public void insert(IsWidget widget,
java.lang.String tabText,
int beforeIndex)
IsWidget to be used directly.
public void insert(Widget widget,
java.lang.String tabText,
boolean asHTML,
int beforeIndex)
widget - the widget to be insertedtabText - the text to be shown on its tabasHTML - true to treat the specified text as HTMLbeforeIndex - the index before which it will be inserted
public void insert(Widget widget,
java.lang.String tabText,
int beforeIndex)
widget - the widget to be insertedtabText - the text to be shown on its tabbeforeIndex - the index before which it will be inserted
public void insert(Widget widget,
Widget tabWidget,
int beforeIndex)
widget - the widget to be inserted.tabWidget - the widget to be shown on its tab.beforeIndex - the index before which it will be inserted.public boolean isAnimationEnabled()
HasAnimation
isAnimationEnabled in interface HasAnimationpublic java.util.Iterator<Widget> iterator()
HasWidgetsIterator.remove().
iterator in interface HasWidgetsiterator in interface java.lang.Iterable<Widget>
@Deprecated
public boolean onBeforeTabSelected(SourcesTabEvents sender,
int tabIndex)
BeforeSelectionHandler.onBeforeSelection(com.google.gwt.event.logical.shared.BeforeSelectionEvent) instead
TabListener
onBeforeTabSelected in interface TabListenersender - the TabBar or TabPanel whose tab was
selected.tabIndex - the index of the tab about to be selected
false to disallow the selection. If any listener
returns false, then the selection will be disallowed.
@Deprecated
public void onTabSelected(SourcesTabEvents sender,
int tabIndex)
SelectionHandler.onSelection(com.google.gwt.event.logical.shared.SelectionEvent) instead
TabListener
onTabSelected in interface TabListenersender - the TabBar or TabPanel whose tab was selectedtabIndex - the index of the tab that was selectedpublic boolean remove(int index)
IndexedPanel
remove in interface IndexedPanelindex - the index of the widget to be removed
false if the widget is not presentpublic boolean remove(Widget widget)
remove in interface HasWidgetswidget - the widget to be removed
true if the widget was present@Deprecated public void removeTabListener(TabListener listener)
HandlerRegistration.removeHandler()
method on the object returned by and add*Handler method instead
SourcesTabEvents
removeTabListener in interface SourcesTabEventslistener - the listener interface to removepublic void selectTab(int index)
index - the index of the tab to be selected
public void selectTab(int index,
boolean fireEvents)
index - the index of the tab to be selectedfireEvents - true to fire events, false not topublic void setAnimationEnabled(boolean enable)
HasAnimation
setAnimationEnabled in interface HasAnimationenable - true to enable, false to disableprotected SimplePanel createTabTextWrapper()
SimplePanel that will wrap the contents in a tab.
Subclasses can use this method to wrap tabs in decorator panels.
SimplePanel to wrap the tab contents, or null to leave
tabs unwrappedprotected void onEnsureDebugId(java.lang.String baseID)
onEnsureDebugId in class UIObjectbaseID - the base ID used by the main elementUIObject.onEnsureDebugId(String)
|
GWT 2.7.0 | |||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||