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

java.lang.Object
  com.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

All Implemented Interfaces:

EventListener, HasWidgets, IndexedPanel, SourcesTabEvents, TabListener

public class TabPanel
extends Composite
implements TabListener, SourcesTabEvents, HasWidgets, IndexedPanel

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.

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.

CSS Style Rules

• .gwt-TabPanel { the tab panel itself }
• .gwt-TabPanelBottom { the bottom section of the tab panel (the deck containing the widget) }

Example

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);
  }
}

Constructor Summary

TabPanel()
Creates an empty tab panel.

Method Summary

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.
void	addTabListener(TabListener listener) Adds a listener interface to receive click events.
void	clear() Removes all child widgets.
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(Widget widget) Gets the index of the specified child widget.
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.
java.util.Iterator	iterator() Gets an iterator for the contained widgets.
boolean	onBeforeTabSelected(SourcesTabEvents sender, int tabIndex) Fired just before a tab is selected.
void	onTabSelected(SourcesTabEvents sender, int tabIndex) Fired when a tab is selected.
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) Removes a previously added listener interface.
void	selectTab(int index) Programmatically selects the specified tab.

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

getElement, getWidget, initWidget, isAttached, onAttach, onDetach, setWidget

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

doAttachChildren, doDetachChildren, getParent, onBrowserEvent, onLoad, onUnload, removeFromParent, setElement

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

addStyleDependentName, addStyleName, getAbsoluteLeft, getAbsoluteTop, getOffsetHeight, getOffsetWidth, getStyleElement, getStyleName, getStyleName, getStylePrimaryName, getStylePrimaryName, getTitle, isVisible, isVisible, removeStyleDependentName, removeStyleName, 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

Constructor Detail

TabPanel

public TabPanel()

Creates an empty tab panel.

Method Detail

add

public void add(Widget w)

Description copied from interface: HasWidgets

Adds a child widget.

Specified by:

add in interface HasWidgets

Parameters:

w - the widget to be added

add

public void add(Widget w,
                java.lang.String tabText)

Adds a widget to the tab panel. If the Widget is already attached to the TabPanel, it will be moved to the right-most index.

Parameters:

w - the widget to be added

tabText - the text to be shown on its tab

add

public void add(Widget w,
                java.lang.String tabText,
                boolean asHTML)

Adds a widget to the tab panel. If the Widget is already attached to the TabPanel, it will be moved to the right-most index.

Parameters:

w - the widget to be added

tabText - the text to be shown on its tab

asHTML - true to treat the specified text as HTML

add

public void add(Widget w,
                Widget tabWidget)

Adds a widget to the tab panel. If the Widget is already attached to the TabPanel, it will be moved to the right-most index.

Parameters:

w - the widget to be added

tabWidget - the widget to be shown in the tab

addTabListener

public void addTabListener(TabListener listener)

Description copied from interface: SourcesTabEvents

Adds a listener interface to receive click events.

Specified by:

addTabListener in interface SourcesTabEvents

Parameters:

listener - the listener interface to add

clear

public void clear()

Description copied from interface: HasWidgets

Removes all child widgets.

Specified by:

clear in interface HasWidgets

getDeckPanel

public DeckPanel getDeckPanel()

Gets the deck panel within this tab panel. Adding or removing Widgets from the DeckPanel is not supported and will throw UnsupportedOperationExceptions.

Returns:

the deck panel

getTabBar

public TabBar getTabBar()

Gets the tab bar within this tab panel. Adding or removing tabs from from the TabBar is not supported and will throw UnsupportedOperationExceptions.

Returns:

the tab bar

getWidget

public Widget getWidget(int index)

Description copied from interface: IndexedPanel

Gets the child widget at the specified index.

Specified by:

getWidget in interface IndexedPanel

Parameters:

index - the child widget's index

Returns:

the child widget

getWidgetCount

public int getWidgetCount()

Description copied from interface: IndexedPanel

Gets the number of child widgets in this panel.

Specified by:

getWidgetCount in interface IndexedPanel

Returns:

the number of children

getWidgetIndex

public int getWidgetIndex(Widget widget)

Description copied from interface: IndexedPanel

Gets the index of the specified child widget.

Specified by:

getWidgetIndex in interface IndexedPanel

Parameters:

widget - the widget to be found

Returns:

the widget's index, or -1 if it is not a child of this panel

insert

public void insert(Widget widget,
                   java.lang.String tabText,
                   boolean asHTML,
                   int beforeIndex)

Inserts a widget into the tab panel. If the Widget is already attached to the TabPanel, it will be moved to the requested index.

Parameters:

widget - the widget to be inserted

tabText - the text to be shown on its tab

asHTML - true to treat the specified text as HTML

beforeIndex - the index before which it will be inserted

insert

public void insert(Widget widget,
                   Widget tabWidget,
                   int beforeIndex)

Inserts a widget into the tab panel. If the Widget is already attached to the TabPanel, it will be moved to the requested index.

Parameters:

widget - the widget to be inserted.

tabWidget - the widget to be shown on its tab.

beforeIndex - the index before which it will be inserted.

insert

public void insert(Widget widget,
                   java.lang.String tabText,
                   int beforeIndex)

Inserts a widget into the tab panel. If the Widget is already attached to the TabPanel, it will be moved to the requested index.

Parameters:

widget - the widget to be inserted

tabText - the text to be shown on its tab

beforeIndex - the index before which it will be inserted

iterator

public java.util.Iterator iterator()

Description copied from interface: HasWidgets

Gets an iterator for the contained widgets. This iterator is required to implement Iterator.remove().

Specified by:

iterator in interface HasWidgets

onBeforeTabSelected

public boolean onBeforeTabSelected(SourcesTabEvents sender,
                                   int tabIndex)

Description copied from interface: TabListener

Fired just before a tab is selected.

Specified by:

onBeforeTabSelected in interface TabListener

Parameters:

sender - the TabBar or TabPanel whose tab was selected.

tabIndex - the index of the tab about to be selected

Returns:

false to disallow the selection. If any listener returns false, then the selection will be disallowed.

onTabSelected

public void onTabSelected(SourcesTabEvents sender,
                          int tabIndex)

Description copied from interface: TabListener

Fired when a tab is selected.

Specified by:

onTabSelected in interface TabListener

Parameters:

sender - the TabBar or TabPanel whose tab was selected

tabIndex - the index of the tab that was selected

remove

public boolean remove(int index)

Description copied from interface: IndexedPanel

Removes the widget at the specified index.

Specified by:

remove in interface IndexedPanel

Parameters:

index - the index of the widget to be removed

Returns:

false if the widget is not present

remove

public boolean remove(Widget widget)

Removes the given widget, and its associated tab.

Specified by:

remove in interface HasWidgets

Parameters:

widget - the widget to be removed

Returns:

true if the widget was present

removeTabListener

public void removeTabListener(TabListener listener)

Description copied from interface: SourcesTabEvents

Removes a previously added listener interface.

Specified by:

removeTabListener in interface SourcesTabEvents

Parameters:

listener - the listener interface to remove

selectTab

public void selectTab(int index)

Programmatically selects the specified tab.

Parameters:

index - the index of the tab to be selected