Class TabBar
A horizontal bar of folder-style tabs, most commonly used as part of a
TabPanel.

CSS Style Rules
- .gwt-TabBar { the tab bar itself }
- .gwt-TabBar .gwt-TabBarFirst { the left edge of the bar }
- .gwt-TabBar .gwt-TabBarRest { the right edge of the bar }
- .gwt-TabBar .gwt-TabBarItem { unselected tabs }
- .gwt-TabBar .gwt-TabBarItem-selected { additional style for selected tabs }
Example
public class TabBarExample implements EntryPoint {
public void onModuleLoad() {
// Create a tab bar with three items.
TabBar bar = new TabBar();
bar.addTab("foo");
bar.addTab("bar");
bar.addTab("baz");
// Hook up a tab listener to do something when the user selects a tab.
bar.addTabListener(new TabListener() {
public void onTabSelected(SourcesTabEvents sender, int tabIndex) {
// Let the user know what they just did.
Window.alert("You clicked tab " + tabIndex);
}
public boolean onBeforeTabSelected(SourcesTabEvents sender,
int tabIndex) {
// Just for fun, let's disallow selection of 'bar'.
if (tabIndex == 1)
return false;
return true;
}
});
// Add it to the root panel.
RootPanel.get().add(bar);
}
}
Constructors
Methods
Constructor Detail
TabBar
public TabBar()
Creates an empty tab bar.
Method Detail
addTab
public void
addTab(
String text)
Adds a new tab with the specified text.
Parameters
- text
- the new tab's text
addTab
public void
addTab(
String text, boolean asHTML)
Adds a new tab with the specified text.
Parameters
- text
- the new tab's text
- asHTML
-
true
to treat the specified text as html
addTabListener
Adds a listener interface to receive click events.
Parameters
- listener
- the listener interface to add
getSelectedTab
public int getSelectedTab()
Gets the tab that is currently selected.
Return Value
the selected tab
getTabCount
public int getTabCount()
Gets the number of tabs present.
Return Value
the tab count
getTabHTML
public
String getTabHTML(
int index)
Gets the specified tab's HTML.
Parameters
- index
- the index of the tab whose HTML is to be retrieved
Return Value
the tab's HTML
insertTab
public void
insertTab(
String text, boolean asHTML, int beforeIndex)
Inserts a new tab at the specified index.
Parameters
- text
- the new tab's text
- asHTML
-
true
to treat the specified text as HTML
- beforeIndex
- the index before which this tab will be inserted
insertTab
public void
insertTab(
String text, int beforeIndex)
Inserts a new tab at the specified index.
Parameters
- text
- the new tab's text
- beforeIndex
- the index before which this tab will be inserted
onClick
public void
onClick(
Widget sender)
Fired when the user clicks on a widget.
Parameters
- sender
- the widget sending the event.
removeTab
public void removeTab(int index)
Removes the tab at the specified index.
Parameters
- index
- the index of the tab to be removed
removeTabListener
Removes a previously added listener interface.
Parameters
- listener
- the listener interface to remove
selectTab
public boolean selectTab(int index)
Programmatically selects the specified tab.
Parameters
- index
- the index of the tab to be selected
Return Value
true
if successful,
false
if the
change is denied by the
TabListener.