public class TabSet extends Canvas implements HasAddTabClickedHandlers, HasCloseClickHandlers, HasTabContextMenuHandlers, HasTabDeselectedHandlers, HasTabIconClickHandlers, HasTabSelectedHandlers, HasTabsReorderedHandlers, HasTabTitleChangedHandlers
Tabs are configured via the tabs
property, each of which has a
pane
property which will be displayed in the main pane when that tab is selected.
config, configOnly, factoryCreated, factoryProperties, id, nativeObject, scClassName
Constructor and Description |
---|
TabSet() |
TabSet(com.google.gwt.core.client.JavaScriptObject jsObj) |
Modifier and Type | Method and Description |
---|---|
com.google.gwt.event.shared.HandlerRegistration |
addAddTabClickedHandler(AddTabClickedHandler handler)
Add a addTabClicked handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addCloseClickHandler(CloseClickHandler handler)
Add a closeClick handler.
|
void |
addTab(Tab tab)
Add a tab
|
void |
addTab(Tab tab,
int position)
Add a tab
|
com.google.gwt.event.shared.HandlerRegistration |
addTabContextMenuHandler(TabContextMenuHandler handler)
Add a tabContextMenu handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addTabDeselectedHandler(TabDeselectedHandler handler)
Add a tabDeselected handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addTabIconClickHandler(TabIconClickHandler handler)
Add a tabIconClick handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addTabSelectedHandler(TabSelectedHandler handler)
Add a tabSelected handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addTabsReorderedHandler(TabsReorderedHandler handler)
Add a tabsReordered handler.
|
com.google.gwt.event.shared.HandlerRegistration |
addTabTitleChangedHandler(TabTitleChangedHandler handler)
Add a tabTitleChanged handler.
|
void |
cancelTabTitleEditing()
If the user is currently editing a tab title (see
canEditTabTitles ), dismiss the editor and discard the edit value entered by the user. |
static void |
changeAutoChildDefaults(java.lang.String autoChildName,
Canvas defaults)
Changes the defaults for Canvas AutoChildren named
autoChildName . |
static void |
changeAutoChildDefaults(java.lang.String autoChildName,
FormItem defaults)
Changes the defaults for FormItem AutoChildren named
autoChildName . |
protected com.google.gwt.core.client.JavaScriptObject |
create() |
void |
disableTab(int tabIndex)
If the specified tab is enabled, disable it now.
|
void |
disableTab(java.lang.String ID)
If the specified tab is enabled, disable it now.
|
void |
disableTab(Tab tab)
If the specified tab is enabled, disable it now.
|
void |
editTabTitle(int tab)
Places an editor in the title of the parameter tab and allows the user to edit the title.
|
void |
editTabTitle(java.lang.String tab)
Places an editor in the title of the parameter tab and allows the user to edit the title.
|
void |
enableTab(int tabIndex)
If the specified tab is disabled, enable it now.
|
void |
enableTab(java.lang.String ID)
If the specified tab is disabled, enable it now.
|
void |
enableTab(Tab tab)
If the specified tab is disabled, enable it now.
|
ImgButton |
getAddTabButton()
Appears when
canAddTabs is enabled. |
java.lang.String |
getAddTabButtonIcon()
Icon for the
addTabButton . |
java.lang.Boolean |
getAnimateTabScrolling()
If
showTabScroller is true, should tabs be scrolled
into view via an animation when the user interacts with the scroller buttons? |
java.lang.String |
getAriaCloseableSuffix()
When
screen reader mode is enabled and a tab is closeable , the ariaCloseableSuffix is a string that
is appended to the label of closeable tabs. |
java.lang.Boolean |
getCanAddTabs()
|
java.lang.Boolean |
getCanCloseTabs()
Should tabs in this tabSet show an icon allowing the user to dismiss the tab by
clicking on it directly.
|
java.lang.Boolean |
getCanEditTabTitles()
If true, users can edit the titles of tabs in this TabSet when the
titleEditEvent fires. |
java.lang.Boolean |
getCanReorderTabs()
If true, tabs can be reordered by dragging on them.
|
java.lang.String |
getCloseTabIcon()
Default src for the close icon for tabs to display if
canCloseTabs is true. |
int |
getCloseTabIconSize()
Size in pixels of the icon for closing tabs, displayed when
canCloseTabs is true. |
java.lang.Integer |
getDefaultTabHeight()
|
java.lang.Integer |
getDefaultTabWidth()
|
java.lang.Boolean |
getDestroyPanes()
|
java.lang.String |
getEditProxyConstructor()
Default class used to construct the
EditProxy for this component when the component is
first placed into edit mode . |
java.lang.String |
getLocateTabsBy()
When
AutoTest.getElement() is used to parse locator strings
generated by AutoTest.getLocator() , how should tabs within this
tabset be identified? If the locator has a specified Tab.ID or Tab.name , no fallback approach will be used as those attributes (with
Tab.ID having priority) are each alone considered to definitively
locate it. |
com.smartgwt.logicalstructure.core.LogicalStructureObject |
getLogicalStructure()
Getter implementing the
LogicalStructure interface,
which supports Eclipse's logical structure debugging facility. |
Tab |
getMoreTab()
|
int |
getMoreTabCount()
This property defines the number tab buttons that should be shown before automatically adding a "more" button to handle
the remaining tabs.
|
java.lang.String |
getMoreTabImage()
If
showMoreTab is enabled this property determines the
image to display on the "More" tab button. |
VLayout |
getMoreTabPane()
Pane contents for the "more" tab based on a VLayout.
|
Canvas |
getMoreTabPaneDefaults()
Default properties for the "more" tab's pane.
|
NavigationBar |
getMoreTabPaneNavBar()
Navigation bar shown in the
moreTabPane ; |
Canvas |
getMoreTabPaneProperties()
Properties to apply to the "more" tab's pane created by this TabSet.
|
TableView |
getMoreTabPaneTable()
TableView used to show links to other tabs in the moreTabPane ; |
Tab |
getMoreTabProperties()
Properties to apply to the "more" tab created by this TabSet.
|
java.lang.String |
getMoreTabTitle()
Title for the "More" tab.
|
int |
getNumTabs()
The number of tabs
|
static TabSet |
getOrCreateRef(com.google.gwt.core.client.JavaScriptObject jsObj) |
VLayout |
getPaneContainer()
Container where the component specified by
Tab.pane is shown. |
java.lang.String |
getPaneContainerClassName()
CSS style used for the paneContainer.
|
Overflow |
getPaneContainerOverflow()
Specifies the overflow of the pane container (the component that holds the pane contents for all tabs).
|
int |
getPaneMargin()
Space to leave around the panes in our paneContainer
|
java.lang.String |
getPickerButtonHSrc()
If
showTabPicker is true, and symmetricPickerButton is set to true, this property
governs the base URL for the picker button image, when displayed in a horizontal tab-bar [IE tabBarPosition is set to "top" or
"bottom" ]. |
int |
getPickerButtonSize()
If
showTabPicker is true and isTouch is false , this property governs the size of the tab
picker button. |
java.lang.String |
getPickerButtonSrc()
If
showTabPicker is true, this property governs the base
URL for the picker button image, when symmetricPickerButton is set to false |
java.lang.String |
getPickerButtonVSrc()
If
showTabPicker is true, and symmetricPickerButton is set to true, this property
governs the base URL for the picker button image, when displayed in a verricaL tab-bar [IE tabBarPosition is set to "LEFT" or
"right" ]. |
StretchImgButton |
getScroller()
A component containing back and forward buttons for scrolling through all of the tabs of the TabSet.
|
int |
getScrollerButtonSize()
If
showTabScroller is true, this property governs the
size of scroller buttons. |
java.lang.String |
getScrollerHSrc()
If this TabSet is showing
tab scroller buttons , and
symmetricScroller is true, this property governs the
base URL for the tab bar back and forward scroller button images for horizontal tab bars [IE for tab sets with tabBarPosition set to "top" or "bottom"]. |
java.lang.String |
getScrollerSrc()
If this TabSet is showing
tab scroller buttons , and
symmetricScroller is false, this property governs
the base URL for the tab bar back and forward scroller button images. |
java.lang.String |
getScrollerVSrc()
If this TabSet is showing
tab scroller buttons , and
symmetricScroller is true, this property governs the
base URL for the tab bar back and forward scroller button images for vertical tab bars [IE for tab sets with tabBarPosition set to "left" or "right"]. |
Tab |
getSelectedTab()
The currently selected tab.
|
int |
getSelectedTabNumber()
Returns the index of the currently selected tab object.
|
java.lang.Boolean |
getShowMoreTab()
Should tabs exceeding
moreTabCount be shown on a "more"
tab? |
java.lang.Boolean |
getShowPaneContainerEdges()
Should the paneContainer for this tabset show
edges . |
java.lang.Boolean |
getShowPartialEdges()
If the paneContainer for this tab set is showing
edges , setting
this attribute to true will set the paneContainer to show customEdges for the three sides opposing the tabBarPosition. |
java.lang.Boolean |
getShowTabBar()
Should the tabBar be displayed or not If shrinkElementOnHide is true, the paneContainer will expand over the space
occupied by TabBar
|
java.lang.Boolean |
getShowTabPicker()
If there is not enough space to display all the tab-buttons in this tabSet, should a drop-down "picker" be displayed to
allow selection of tabs that are clipped?
|
java.lang.Boolean |
getShowTabScroller()
If there is not enough space to display all the tab-buttons in this tabSet, should scroll buttons be displayed to allow
access to tabs that are clipped? If unset, defaults to false for
handsets and true otherwise. |
java.lang.String |
getSimpleTabBaseStyle()
If
useSimpleTabs is true,
simpleTabBaseStyle will be the base style used to determine the css style to apply to the tabs. |
java.lang.String |
getSimpleTabIconOnlyBaseStyle()
If
useSimpleTabs is true,
simpleTabIconOnlyBaseStyle will be the base style used to determine the css style to apply to the tabs if
Tab.canAdaptWidth is set and the title is not being shown. |
java.lang.String |
getSkinImgDir()
Default directory for skin images (those defined by the class), relative to the Page-wide
skinDir . |
java.lang.Boolean |
getSymmetricEdges()
If this tabSet will
show edges for the
paneContainer, this property determines whether the same edge media will be used regardless of the tab bar position, or
whether different media should be used (necessary if the edge appearance is not symmetrical on all sides). |
java.lang.Boolean |
getSymmetricPickerButton()
If this TabSet is showing a
tab picker button , this
property determines whether the pickerButtonHSrc and
pickerButtonVSrc media will be used for vertical and
horizontal tab-bar picker buttons, or whether separate media should be used for each possible tabBarPosition based on the pickerButtonSrc property for this tabSet. |
java.lang.Boolean |
getSymmetricScroller()
If this TabSet is showing
tab scroller buttons , this
property determines whether the scrollerHSrc and scrollerVSrc media will be used for vertical and horizontal
tab-bar scroller buttons, or whether separate media should be used for each possible tabBarPosition based on the scrollerSrc property for this tabSet. |
Tab |
getTab(int tabIndex)
Retrieves a Tab definition from within this tabSet by index.
|
Tab |
getTab(java.lang.String ID)
Retrieves a Tab definition from within this tabSet by ID.
|
TabBar |
getTabBar()
TabBar for this TabSet, an instance of
TabBar . |
Side |
getTabBarAlign()
Alignment of the tabBar.
|
Alignment |
getTabBarAlignAsAlignment()
Alignment of the tabBar.
|
Layout |
getTabBarControlLayout()
com.smartgwt.client.types.AutoChild of type Layout that holds the
tabBarControls as well as the built-in controls such as
the tab picker menu . |
Side |
getTabBarPosition()
Which side of the TabSet the TabBar should appear on.
|
int |
getTabBarThickness()
Thickness of tabBar, applies to either orientation (specifies height for horizontal, width for vertical orientation).
|
StatefulCanvas |
getTabCanvas(int tabIndex)
Get the live Canvas representing a tab by index.
|
StatefulCanvas |
getTabCanvas(java.lang.String ID)
Get the live Canvas representing a tab by index.
|
int |
getTabNumber(java.lang.String ID)
Get the index of a tab from the tabID.
|
ImgButton |
getTabPicker()
A button control that allows tabs to be picked directly from a popup menu.
|
Tab[] |
getTabs()
The tabs
|
TabTitleEditEvent |
getTitleEditEvent()
The event that triggers title editing on this TabSet.
|
TextItem |
getTitleEditor()
TextItem we use to edit tab titles in this TabSet.
|
java.lang.Integer |
getTitleEditorLeftOffset()
If set, offsets the tab title editor further in from the left-hand edge of the tab, by the number of pixels set in this
property.
|
TextItem |
getTitleEditorProperties()
Properties for the auto-generated
titleEditor . |
java.lang.Integer |
getTitleEditorRightOffset()
If set, offsets the tab title editor further in from the right-hand edge of the tab, by the number of pixels set in this
property.
|
java.lang.Integer |
getTitleEditorTopOffset()
If set, offsets the tab title editor further down from the top edge of the tab, by the number of pixels set in this
property.
|
int |
getTouchPickerButtonSize()
The size of the tab picker button when
isTouch is true . |
java.lang.Boolean |
getUseIOSTabs()
Setting this to true turns on a different appearance for tabs, similar to iOS tabs from the "Music" app, where the
tab.icon is enlarged and shown as a black and white mask.
|
java.lang.Boolean |
getUseSimpleTabs()
Should we use simple button based tabs styled with CSS rather than image based
ImgTab tabs? |
void |
hideTab(int tab)
Hide a tab in this tabset at runtime.
|
void |
hideTab(java.lang.String tab)
Hide a tab in this tabset at runtime.
|
void |
hideTab(Tab tab)
Hide a tab in this tabset at runtime.
|
static void |
preloadImages()
Preload primary tab skin images.
|
void |
removeLastTab()
Removes the last tab in the TabSet, excluding the
moreTab if
present. |
void |
removeTab(int tabIndex)
Remove a tab.
|
void |
removeTab(java.lang.String ID)
Remove a tab.
|
void |
removeTab(Tab tab)
Remove a tab.
|
void |
removeTabs(int[] tabIndexes)
Remove one or more tabs.
|
void |
removeTabs(java.lang.String[] ids)
Remove one or more tabs.
|
void |
reorderTab(Tab tab)
Move a tab to another location in the tabset.
|
void |
reorderTab(Tab tab,
int moveToPosition)
Move a tab to another location in the tabset.
|
void |
revealChild(Canvas child)
Reveals the child Canvas passed in by selecting the tab containing that child if it is not already selected.
|
void |
revealChild(java.lang.String childID)
Reveals the child Canvas passed in by selecting the tab containing that child if it is not already selected.
|
void |
saveTabTitle()
If the user is currently editing a tab title (see
canEditTabTitles ), save the edited tab title and hide the editor. |
void |
scrollBack()
If there is not enough space to display all the tabs in this tabSet, this method will scroll the previous tab (that
first tab that is clipped at the beginning of the tab-bar) into view.
|
void |
scrollForward()
If there is not enough space to display all the tabs in this tabSet, this method will scroll the next tab (that first
tab that is clipped at the end of the tab-bar) into view.
|
void |
selectTab(int tabIndex)
Select a tab.
|
void |
selectTab(java.lang.String ID)
Select a tab.
|
void |
selectTab(Tab tab)
Select a tab.
|
TabSet |
setAddTabButtonIcon(java.lang.String addTabButtonIcon)
Icon for the
addTabButton . |
TabSet |
setAnimateTabScrolling(java.lang.Boolean animateTabScrolling)
If
showTabScroller is true, should tabs be scrolled
into view via an animation when the user interacts with the scroller buttons? |
TabSet |
setAriaCloseableSuffix(java.lang.String ariaCloseableSuffix)
When
screen reader mode is enabled and a tab is closeable , the ariaCloseableSuffix is a string that
is appended to the label of closeable tabs. |
TabSet |
setCanAddTabs(java.lang.Boolean canAddTabs)
|
void |
setCanCloseTab(Tab tab,
boolean canClose)
Sets the given tab's
canClose property to the boolean parameter
canClose. |
TabSet |
setCanCloseTabs(java.lang.Boolean canCloseTabs)
Should tabs in this tabSet show an icon allowing the user to dismiss the tab by
clicking on it directly.
|
TabSet |
setCanEditTabTitles(java.lang.Boolean canEditTabTitles)
If true, users can edit the titles of tabs in this TabSet when the
titleEditEvent fires. |
TabSet |
setCanReorderTabs(java.lang.Boolean canReorderTabs)
If true, tabs can be reordered by dragging on them.
|
TabSet |
setCloseTabIcon(java.lang.String closeTabIcon)
Default src for the close icon for tabs to display if
canCloseTabs is true. |
TabSet |
setCloseTabIconSize(int closeTabIconSize)
Size in pixels of the icon for closing tabs, displayed when
canCloseTabs is true. |
static void |
setDefaultProperties(TabSet tabSetProperties)
Class level method to set the default properties of this class.
|
TabSet |
setDefaultTabHeight(java.lang.Integer defaultTabHeight)
|
TabSet |
setDefaultTabWidth(java.lang.Integer defaultTabWidth)
|
TabSet |
setDestroyPanes(java.lang.Boolean destroyPanes)
|
TabSet |
setEditProxyConstructor(java.lang.String editProxyConstructor)
Default class used to construct the
EditProxy for this component when the component is
first placed into edit mode . |
TabSet |
setLocateTabsBy(java.lang.String locateTabsBy)
When
AutoTest.getElement() is used to parse locator strings
generated by AutoTest.getLocator() , how should tabs within this
tabset be identified? If the locator has a specified Tab.ID or Tab.name , no fallback approach will be used as those attributes (with
Tab.ID having priority) are each alone considered to definitively
locate it. |
com.smartgwt.logicalstructure.core.LogicalStructureObject |
setLogicalStructure(com.smartgwt.logicalstructure.widgets.tab.TabSetLogicalStructure s)
Setter implementing the
LogicalStructure interface,
which supports Eclipse's logical structure debugging facility. |
TabSet |
setMoreTabCount(int moreTabCount)
This property defines the number tab buttons that should be shown before automatically adding a "more" button to handle
the remaining tabs.
|
TabSet |
setMoreTabImage(java.lang.String moreTabImage)
If
showMoreTab is enabled this property determines the
image to display on the "More" tab button. |
TabSet |
setMoreTabPaneDefaults(Canvas moreTabPaneDefaults)
Default properties for the "more" tab's pane.
|
TabSet |
setMoreTabPaneProperties(Canvas moreTabPaneProperties)
Properties to apply to the "more" tab's pane created by this TabSet.
|
TabSet |
setMoreTabProperties(Tab moreTabProperties)
Properties to apply to the "more" tab created by this TabSet.
|
TabSet |
setMoreTabTitle(java.lang.String moreTabTitle)
Title for the "More" tab.
|
TabSet |
setPaneContainerClassName(java.lang.String paneContainerClassName)
CSS style used for the paneContainer.
|
TabSet |
setPaneContainerOverflow(Overflow paneContainerOverflow)
Specifies the overflow of the pane container (the component that holds the pane contents for all tabs).
|
void |
setPaneContainerProperties(Canvas paneContainerProperties)
Properties of the container where the component specified by Tab.pane is shown.
|
TabSet |
setPaneMargin(int paneMargin)
Space to leave around the panes in our paneContainer
|
TabSet |
setPickerButtonHSrc(java.lang.String pickerButtonHSrc)
If
showTabPicker is true, and symmetricPickerButton is set to true, this property
governs the base URL for the picker button image, when displayed in a horizontal tab-bar [IE tabBarPosition is set to "top" or
"bottom" ]. |
TabSet |
setPickerButtonSize(int pickerButtonSize)
If
showTabPicker is true and isTouch is false , this property governs the size of the tab
picker button. |
TabSet |
setPickerButtonSrc(java.lang.String pickerButtonSrc)
If
showTabPicker is true, this property governs the base
URL for the picker button image, when symmetricPickerButton is set to false |
TabSet |
setPickerButtonVSrc(java.lang.String pickerButtonVSrc)
If
showTabPicker is true, and symmetricPickerButton is set to true, this property
governs the base URL for the picker button image, when displayed in a verricaL tab-bar [IE tabBarPosition is set to "LEFT" or
"right" ]. |
TabSet |
setScrollerButtonSize(int scrollerButtonSize)
If
showTabScroller is true, this property governs the
size of scroller buttons. |
TabSet |
setScrollerHSrc(java.lang.String scrollerHSrc)
If this TabSet is showing
tab scroller buttons , and
symmetricScroller is true, this property governs the
base URL for the tab bar back and forward scroller button images for horizontal tab bars [IE for tab sets with tabBarPosition set to "top" or "bottom"]. |
TabSet |
setScrollerSrc(java.lang.String scrollerSrc)
If this TabSet is showing
tab scroller buttons , and
symmetricScroller is false, this property governs
the base URL for the tab bar back and forward scroller button images. |
TabSet |
setScrollerVSrc(java.lang.String scrollerVSrc)
If this TabSet is showing
tab scroller buttons , and
symmetricScroller is true, this property governs the
base URL for the tab bar back and forward scroller button images for vertical tab bars [IE for tab sets with tabBarPosition set to "left" or "right"]. |
void |
setSelectedTab(int selectedTab)
Specifies the index of the initially selected tab.
|
TabSet |
setShowMoreTab(java.lang.Boolean showMoreTab)
Should tabs exceeding
moreTabCount be shown on a "more"
tab? |
TabSet |
setShowPaneContainerEdges(java.lang.Boolean showPaneContainerEdges)
Should the paneContainer for this tabset show
edges . |
TabSet |
setShowPartialEdges(java.lang.Boolean showPartialEdges)
If the paneContainer for this tab set is showing
edges , setting
this attribute to true will set the paneContainer to show customEdges for the three sides opposing the tabBarPosition. |
TabSet |
setShowTabBar(java.lang.Boolean showTabBar)
Should the tabBar be displayed or not If shrinkElementOnHide is true, the paneContainer will expand over the space
occupied by TabBar
|
TabSet |
setShowTabPicker(java.lang.Boolean showTabPicker)
If there is not enough space to display all the tab-buttons in this tabSet, should a drop-down "picker" be displayed to
allow selection of tabs that are clipped?
|
TabSet |
setShowTabScroller(java.lang.Boolean showTabScroller)
If there is not enough space to display all the tab-buttons in this tabSet, should scroll buttons be displayed to allow
access to tabs that are clipped? If unset, defaults to false for
handsets and true otherwise. |
TabSet |
setSimpleTabBaseStyle(java.lang.String simpleTabBaseStyle)
If
useSimpleTabs is true,
simpleTabBaseStyle will be the base style used to determine the css style to apply to the tabs. |
TabSet |
setSimpleTabIconOnlyBaseStyle(java.lang.String simpleTabIconOnlyBaseStyle)
If
useSimpleTabs is true,
simpleTabIconOnlyBaseStyle will be the base style used to determine the css style to apply to the tabs if
Tab.canAdaptWidth is set and the title is not being shown. |
TabSet |
setSkinImgDir(java.lang.String skinImgDir)
Default directory for skin images (those defined by the class), relative to the Page-wide
skinDir . |
TabSet |
setSymmetricEdges(java.lang.Boolean symmetricEdges)
If this tabSet will
show edges for the
paneContainer, this property determines whether the same edge media will be used regardless of the tab bar position, or
whether different media should be used (necessary if the edge appearance is not symmetrical on all sides). |
TabSet |
setSymmetricPickerButton(java.lang.Boolean symmetricPickerButton)
If this TabSet is showing a
tab picker button , this
property determines whether the pickerButtonHSrc and
pickerButtonVSrc media will be used for vertical and
horizontal tab-bar picker buttons, or whether separate media should be used for each possible tabBarPosition based on the pickerButtonSrc property for this tabSet. |
TabSet |
setSymmetricScroller(java.lang.Boolean symmetricScroller)
If this TabSet is showing
tab scroller buttons , this
property determines whether the scrollerHSrc and scrollerVSrc media will be used for vertical and horizontal
tab-bar scroller buttons, or whether separate media should be used for each possible tabBarPosition based on the scrollerSrc property for this tabSet. |
TabSet |
setTabBarAlign(Alignment tabBarAlign)
Alignment of the tabBar.
|
TabSet |
setTabBarAlign(Side tabBarAlign)
Alignment of the tabBar.
|
void |
setTabBarControls(java.lang.Object... tabBarControls)
This property determines what controls should show up after the tabBar for this TabSet.
|
TabSet |
setTabBarPosition(Side tabBarPosition)
Which side of the TabSet the TabBar should appear on.
|
void |
setTabBarProperties(TabBar tabBarProperties)
This attribute allows developers to specify custom properties for this tabset's
tabBar |
TabSet |
setTabBarThickness(int tabBarThickness)
Thickness of tabBar, applies to either orientation (specifies height for horizontal, width for vertical orientation).
|
void |
setTabIcon(int tabIndex,
java.lang.String iconURL)
Changes the icon of a tab
|
void |
setTabIcon(java.lang.String ID,
java.lang.String iconURL)
Changes the icon of a tab
|
void |
setTabIcon(Tab tab,
java.lang.String iconURL)
Changes the icon of a tab
|
void |
setTabPane(int tabIndex,
Canvas pane)
Apply a new
pane to an existing tab in this tabSet |
void |
setTabPane(java.lang.String tabID,
Canvas pane)
Apply a new
pane to an existing tab in this tabSet |
void |
setTabPickerTitle(Tab tab,
java.lang.String pickerTitle)
Changes the title of the picker menu item of a tab
|
void |
setTabs(Tab... tabs)
An array of
Tab objects, specifying the title
and pane contents of each tab in the TabSet. |
void |
setTabTitle(int tabIndex,
java.lang.String title)
Changes the title of a tab
|
void |
setTabTitle(java.lang.String ID,
java.lang.String title)
Changes the title of a tab
|
void |
setTabTitle(Tab tab,
java.lang.String title)
Changes the title of a tab
|
void |
setTitleEditEvent(TabTitleEditEvent titleEditEvent)
The event that triggers title editing on this TabSet.
|
TabSet |
setTitleEditorLeftOffset(java.lang.Integer titleEditorLeftOffset)
If set, offsets the tab title editor further in from the left-hand edge of the tab, by the number of pixels set in this
property.
|
TabSet |
setTitleEditorProperties(TextItem titleEditorProperties)
Properties for the auto-generated
titleEditor . |
TabSet |
setTitleEditorRightOffset(java.lang.Integer titleEditorRightOffset)
If set, offsets the tab title editor further in from the right-hand edge of the tab, by the number of pixels set in this
property.
|
TabSet |
setTitleEditorTopOffset(java.lang.Integer titleEditorTopOffset)
If set, offsets the tab title editor further down from the top edge of the tab, by the number of pixels set in this
property.
|
TabSet |
setTouchPickerButtonSize(int touchPickerButtonSize)
The size of the tab picker button when
isTouch is true . |
TabSet |
setUseIOSTabs(java.lang.Boolean useIOSTabs)
Setting this to true turns on a different appearance for tabs, similar to iOS tabs from the "Music" app, where the
tab.icon is enlarged and shown as a black and white mask.
|
TabSet |
setUseSimpleTabs(java.lang.Boolean useSimpleTabs)
Should we use simple button based tabs styled with CSS rather than image based
ImgTab tabs? |
void |
showTab(int tab)
Show a
hidden tab at runtime. |
void |
showTab(java.lang.String tab)
Show a
hidden tab at runtime. |
void |
showTab(Tab tab)
Show a
hidden tab at runtime. |
Tab |
tabForPane(Canvas pane)
Search for a tab that contains a pane.
|
boolean |
tabIsVisible(int tab)
Is the tab
hidden or visible ? |
boolean |
tabIsVisible(java.lang.String tab)
Is the tab
hidden or visible ? |
boolean |
tabIsVisible(Tab tab)
Is the tab
hidden or visible ? |
void |
updateTab(int tabIndex,
Canvas pane)
Set the pane for a tab.
|
void |
updateTab(Tab tab,
Canvas pane)
Set the pane for a tab.
|
addChild, addChild, addChild, addChild, addChild, addClearHandler, addClickHandler, addDoubleClickHandler, addDragMoveHandler, addDragRepositionMoveHandler, addDragRepositionStartHandler, addDragRepositionStopHandler, addDragResizeMoveHandler, addDragResizeStartHandler, addDragResizeStopHandler, addDragStartHandler, addDragStopHandler, addDropHandler, addDropMoveHandler, addDropOutHandler, addDropOverHandler, addFocusChangedHandler, addHoverHandler, addHoverHiddenHandler, addKeyDownHandler, addKeyPressHandler, addMouseDownHandler, addMouseMoveHandler, addMouseOutHandler, addMouseOverHandler, addMouseStillDownHandler, addMouseUpHandler, addMouseWheelHandler, addMovedHandler, addParentMovedHandler, addPeer, addPeer, addPeer, addPeer, addResizedHandler, addRightMouseDownHandler, addRuleContextChangedHandler, addScrolledHandler, addShowContextMenuHandler, addSnapAlignCandidate, addStyleName, addVisibilityChangedHandler, adjustForContent, animateFade, animateFade, animateFade, animateFade, animateFade, animateFade, animateFade, animateFade, animateHide, animateHide, animateHide, animateHide, animateHide, animateHide, animateHide, animateMove, animateMove, animateMove, animateMove, animateRect, animateRect, animateRect, animateRect, animateResize, animateResize, animateResize, animateResize, animateScroll, animateScroll, animateScroll, animateScroll, animateScroll, animateScroll, animateShow, animateShow, animateShow, animateShow, animateShow, animateShow, animateShow, asSGWTComponent, blur, bringToFront, clear, clearExplicitTabIndex, clickMaskUp, clickMaskUp, contains, contains, containsEvent, containsEventTarget, containsFocus, containsPoint, containsPoint, dataContextChanged, deparent, depeer, disable, enable, encloses, focus, focusAfterGroup, focusAtEnd, focusInNextTabElement, focusInPreviousTabElement, getAbsoluteLeft, getAbsoluteTop, getAccessKey, getAdaptiveHeightPriority, getAdaptiveWidthPriority, getAlwaysManageFocusNavigation, getAlwaysShowScrollbars, getAnimateAcceleration, getAnimateFadeTime, getAnimateHideAcceleration, getAnimateHideEffect, getAnimateHideTime, getAnimateMoveAcceleration, getAnimateMoveTime, getAnimateRectAcceleration, getAnimateRectTime, getAnimateResizeAcceleration, getAnimateResizeLayoutMode, getAnimateResizeTime, getAnimateScrollAcceleration, getAnimateScrollTime, getAnimateShowAcceleration, getAnimateShowEffect, getAnimateShowTime, getAnimateTime, getAppImgDir, getAriaHandleID, getAriaRole, getAriaStateDefaults, getAutoMaskComponents, getAutoParent, getAutoPopulateData, getAutoShowParent, getBackgroundColor, getBackgroundImage, getBackgroundPosition, getBackgroundRepeat, getBorder, getBorderRadius, getBottom, getById, getByJSObject, getByLocalId, getCanAcceptDrop, getCanAdaptHeight, getCanAdaptWidth, getCanDrag, getCanDragReposition, getCanDragResize, getCanDragScroll, getCanDrop, getCanDropBefore, getCanFocus, getCanHover, getCanSelectText, getCanvasAutoChild, getCanvasItem, getChildren, getChildrenResizeSnapAlign, getChildrenSnapAlign, getChildrenSnapCenterAlign, getChildrenSnapEdgeAlign, getChildrenSnapResizeToGrid, getChildrenSnapToGrid, getChildTabPosition, getClassName, getComponentMask, getComponentMaskDefaults, getContentElement, getContents, getContextMenu, getCorrectZoomOverflow, getCursor, getDataContext, getDataPath, getDefaultHeight, getDefaultWidth, getDestroyed, getDestroying, getDisabled, getDisabledCursor, getDisableTouchScrollingForDrag, getDoubleClickDelay, getDragAppearance, getDragIntersectStyle, getDragMaskType, getDragMaxHeight, getDragMaxWidth, getDragMinHeight, getDragMinWidth, getDragOpacity, getDragRepositionAppearance, getDragRepositionCursor, getDragResizeAppearance, getDragScrollDelay, getDragStartDistance, getDragTarget, getDragTargetAsString, getDragType, getDropTarget, getDropTargetAsString, getDropTypes, getDropTypesAsString, getDynamicContents, getEdgeBackgroundColor, getEdgeCenterBackgroundColor, getEdgeImage, getEdgeMarginSize, getEdgeOffset, getEdgeOpacity, getEdgeShowCenter, getEdgeSize, getEditNode, getEditProxy, getElement, getElement, getEnableWhen, getEndLine, getEventEdge, getEventEdge, getExtraSpace, getFacetId, getFloatingScrollbars, getFormItemAutoChild, getForwardSVGeventsToObject, getFullDataPath, getGroupBorderCSS, getGroupLabelBackgroundColor, getGroupLabelStyleName, getGroupPadding, getGroupTitle, getHeight, getHeightAsString, getHideUsingDisplayNone, getHoverAlign, getHoverAutoDestroy, getHoverAutoFitMaxWidth, getHoverAutoFitMaxWidthAsString, getHoverAutoFitWidth, getHoverComponent, getHoverDelay, getHoverFocusKey, getHoverHeight, getHoverHTML, getHoverMoveWithMouse, getHoverOpacity, getHoverPersist, getHoverScreen, getHoverStyle, getHoverVAlign, getHoverWidth, getHoverWrap, getHSnapPosition, getHSnapPosition, getHtmlElement, getHtmlElementAsString, getHtmlPosition, getImage, getImgURL, getImgURL, getInnerContentHeight, getInnerContentWidth, getInnerHeight, getInnerWidth, getIsGroup, getIsPrinting, getIsRuleScope, getIsSnapAlignCandidate, getKeepInParentRect, getLayoutAlign, getLeaveGroupLabelSpace, getLeavePageSpace, getLeft, getLeftAsString, getLocalId, getLocateByIDOnly, getLocateChildrenBy, getLocateChildrenType, getLocatePeersBy, getLocatePeersType, getLocatorName, getMargin, getMasterCanvas, getMasterElement, getMatchElement, getMatchElementHeight, getMatchElementWidth, getMaxHeight, getMaxWidth, getMaxZoomOverflowError, getMenuConstructor, getMinHeight, getMinNonEdgeSize, getMinWidth, getMomentumScrollMinSpeed, getMouseStillDownDelay, getMouseStillDownInitialDelay, getName, getNativeAutoHideScrollbars, getNextZIndex, getNoDoubleClicks, getNoDropCursor, getOffsetHeight, getOffsetWidth, getOffsetX, getOffsetY, getOpacity, getOuterElement, getOverflow, getPadding, getPageBottom, getPageLeft, getPageRect, getPageRight, getPageTop, getPaletteDefaults, getPanelContainer, getParentCanvas, getParentElement, getPeers, getPercentBox, getPercentSource, getPersistentMatchElement, getPointerSettings, getPointerTarget, getPointerTargetAsString, getPosition, getPrefix, getPrintChildrenAbsolutelyPositioned, getPrintHTML, getPrintHTML, getPrintStyleName, getPrompt, getProportionalResizeModifiers, getProportionalResizing, getReceiveScrollbarEvents, getRect, getRedrawOnResize, getResizeBarTarget, getResizeFrom, getRight, getRuleContext, getRuleContext, getRuleScope, getScrollbarSize, getScrollBottom, getScrollHeight, getScrollLeft, getScrollRight, getScrollTop, getScrollWidth, getShadowColor, getShadowDepth, getShadowHOffset, getShadowImage, getShadowOffset, getShadowSoftness, getShadowSpread, getShadowVOffset, getShouldPrint, getShowCustomScrollbars, getShowDragShadow, getShowEdges, getShowHover, getShowHoverComponents, getShowPointer, getShowResizeBar, getShowShadow, getShowSnapGrid, getShrinkElementOnHide, getSizeMayChangeOnRedraw, getSnapAlignCandidates, getSnapAlignCenterLineStyle, getSnapAlignEdgeLineStyle, getSnapAxis, getSnapEdge, getSnapGridLineProperties, getSnapGridStyle, getSnapHDirection, getSnapHGap, getSnapOffsetLeft, getSnapOffsetTop, getSnapOnDrop, getSnapPosition, getSnapPosition, getSnapResizeToAlign, getSnapResizeToGrid, getSnapTo, getSnapToAlign, getSnapToCenterAlign, getSnapToEdgeAlign, getSnapToGrid, getSnapVDirection, getSnapVGap, getStartLine, getStyleName, getTabIndex, getTestDataContext, getTestInstance, getTitle, getTooltip, getTop, getTopAsString, getTopElement, getUISummary, getUpdateTabPositionOnDraw, getUpdateTabPositionOnReparent, getUseBackMask, getUseCSSShadow, getUseDragMask, getUseImageForSVG, getUseNativeDrag, getUseOpacityFilter, getUseTouchScrolling, getValuesManager, getValuesManagerAsString, getViewportHeight, getViewportWidth, getVisibility, getVisibleHeight, getVisibleWhen, getVisibleWidth, getVSnapPosition, getVSnapPosition, getWidth, getWidthAsString, getZIndex, getZIndex, handleHover, hide, hideClickMask, hideClickMask, hideComponentMask, hideComponentMask, hideContextMenu, imgHTML, imgHTML, imgHTML, intersects, isDirty, isDisabled, isFocused, isVisible, keyUp, layoutChildren, linkHTML, linkHTML, linkHTML, linkHTML, linkHTML, linkHTML, markForDestroy, markForRedraw, markForRedraw, moveAbove, moveBelow, moveBy, moveTo, onAttach, onDetach, onInit, pageScrollDown, pageScrollUp, parentResized, placeNear, placeNear, placeNear, print, print, print, print, printComponents, provideRuleContext, provideRuleContext, redraw, redraw, registerFontScaledPaddingStyles, removeChild, removeChild, removePeer, removePeer, removeRuleContext, removeSnapAlignCandidate, resizeAutoChildAttributes, resizeBy, resizeControls, resizeControlsTo, resizeFonts, resizeFonts, resizeFonts, resizeFontsTo, resizeIcons, resizePadding, resizePadding, resizeTo, resizeTo, scrollBy, scrollByPercent, scrollTo, scrollTo, scrollTo, scrollToBottom, scrollToLeft, scrollToPercent, scrollToRight, scrollToTop, sendToBack, setAccessKey, setAdaptHeightByCustomizer, setAdaptiveHeightPriority, setAdaptiveWidthPriority, setAdaptWidthByCustomizer, setAlign, setAllowExternalFilters, setAlwaysManageFocusNavigation, setAlwaysShowScrollbars, setAnimateAcceleration, setAnimateFadeTime, setAnimateHideAcceleration, setAnimateHideEffect, setAnimateHideTime, setAnimateMoveAcceleration, setAnimateMoveTime, setAnimateRectAcceleration, setAnimateRectTime, setAnimateResizeAcceleration, setAnimateResizeLayoutMode, setAnimateResizeTime, setAnimateScrollAcceleration, setAnimateScrollTime, setAnimateShowAcceleration, setAnimateShowEffect, setAnimateShowTime, setAnimateTime, setAppImgDir, setAriaRole, setAriaState, setAutoChildConstructor, setAutoChildProperties, setAutoChildProperties, setAutoChildProperties, setAutoChildProperties, setAutoChildVisibility, setAutoHeight, setAutoMaskComponents, setAutoParent, setAutoPopulateData, setAutoResizeAutoChildAttributes, setAutoResizeIcons, setAutoShowParent, setAutoWidth, setBackgroundColor, setBackgroundImage, setBackgroundPosition, setBackgroundRepeat, setBorder, setBorderRadius, setBottom, setCanAcceptDrop, setCanAdaptHeight, setCanAdaptWidth, setCanDrag, setCanDragReposition, setCanDragResize, setCanDragScroll, setCanDrop, setCanDropBefore, setCanFocus, setCanHover, setCanSelectText, setChildren, setChildrenResizeSnapAlign, setChildrenSnapAlign, setChildrenSnapCenterAlign, setChildrenSnapEdgeAlign, setChildrenSnapResizeToGrid, setChildrenSnapToGrid, setComponentMaskDefaults, setContents, setContextMenu, setCorrectZoomOverflow, setCursor, setDataContext, setDataPath, setDefaultHeight, setDefaultPageSpace, setDefaultProperties, setDefaultShowCustomScrollbars, setDefaultWidth, setDisabled, setDisabledCursor, setDisableTouchScrollingForDrag, setDoubleClickDelay, setDragAppearance, setDragIntersectStyle, setDragMaskType, setDragMaxHeight, setDragMaxWidth, setDragMinHeight, setDragMinWidth, setDragOpacity, setDragRepositionAppearance, setDragRepositionCursor, setDragResizeAppearance, setDragScrollDelay, setDragStartDistance, setDragTarget, setDragTarget, setDragType, setDropTarget, setDropTarget, setDropTypes, setDropTypes, setDynamicContents, setEdgeBackgroundColor, setEdgeCenterBackgroundColor, setEdgeImage, setEdgeMarginSize, setEdgeOffset, setEdgeOpacity, setEdgeShowCenter, setEdgeSize, setEditMode, setEditMode, setEditMode, setElement, setEnableWhen, setEndLine, setExtraSpace, setFacetId, setFloatingScrollbars, setForwardSVGeventsToObject, setGroupBorderCSS, setGroupLabelBackgroundColor, setGroupLabelStyleName, setGroupPadding, setGroupTitle, setHeight, setHeight, setHeight, setHeight100, setHideUsingDisplayNone, setHoverAlign, setHoverAutoDestroy, setHoverAutoFitMaxWidth, setHoverAutoFitMaxWidth, setHoverAutoFitWidth, setHoverDelay, setHoverFocusKey, setHoverHeight, setHoverMoveWithMouse, setHoverOpacity, setHoverPersist, setHoverScreen, setHoverStyle, setHoverVAlign, setHoverWidth, setHoverWrap, setHtmlElement, setHtmlElement, setHtmlPosition, setImage, setImage, setInitHandler, setIsGroup, setIsRuleScope, setIsSnapAlignCandidate, setKeepInParentRect, setKeepInParentRect, setKeepInParentRect, setLayoutAlign, setLayoutAlign, setLeaveGroupLabelSpace, setLeavePageSpace, setLeft, setLeft, setLocateByIDOnly, setLocateChildrenBy, setLocateChildrenType, setLocatePeersBy, setLocatePeersType, setLocatorName, setLocatorParent, setLocatorParent, setLogicalStructure, setMargin, setMatchElement, setMatchElementHeight, setMatchElementWidth, setMaxHeight, setMaxWidth, setMaxZoomOverflowError, setMenuConstructor, setMinHeight, setMinNonEdgeSize, setMinWidth, setMomentumScrollMinSpeed, setMouseStillDownDelay, setMouseStillDownInitialDelay, setName, setNativeAutoHideScrollbars, setNeverUseFilters, setNoDoubleClicks, setNoDropCursor, setOpacity, setOverflow, setPadding, setPageLeft, setPageTop, setPanelContainer, setParentCanvas, setParentElement, setPeers, setPercentBox, setPercentSource, setPersistentMatchElement, setPointerSettings, setPointerTarget, setPosition, setPrefix, setPrintChildrenAbsolutelyPositioned, setPrintStyleName, setPrompt, setProportionalResizeModifiers, setProportionalResizing, setReceiveScrollbarEvents, setRect, setRect, setRedrawOnResize, setRelativeTabPosition, setResizeBarTarget, setResizeFrom, setResizeFrom, setRight, setRuleScope, setScrollbarConstructor, setScrollbarSize, setShadowColor, setShadowDepth, setShadowHOffset, setShadowImage, setShadowOffset, setShadowSoftness, setShadowSpread, setShadowVOffset, setShouldPrint, setShowCustomScrollbars, setShowDragShadow, setShowEdges, setShowHover, setShowHoverComponents, setShowPointer, setShowResizeBar, setShowShadow, setShowSnapGrid, setShrinkElementOnHide, setSizeMayChangeOnRedraw, setSmoothFade, setSnapAlignCandidates, setSnapAlignCenterLineStyle, setSnapAlignEdgeLineStyle, setSnapAxis, setSnapEdge, setSnapGridLineProperties, setSnapGridStyle, setSnapHDirection, setSnapHGap, setSnapOffsetLeft, setSnapOffsetTop, setSnapOnDrop, setSnapResizeToAlign, setSnapResizeToGrid, setSnapTo, setSnapToAlign, setSnapToCenterAlign, setSnapToEdgeAlign, setSnapToGrid, setSnapVDirection, setSnapVGap, setStartLine, setStyleName, setTabIndex, setTestDataContext, setTitle, setTooltip, setTop, setTop, setUpdateTabPositionOnDraw, setUpdateTabPositionOnReparent, setUseBackMask, setUseCSSShadow, setUseDragMask, setUseImageForSVG, setUseNativeDrag, setUseOpacityFilter, setUseTouchScrolling, setValuesManager, setValuesManager, setVisibility, setVisible, setVisibleWhen, setWidth, setWidth, setWidth, setWidth100, setZIndex, shouldDragScroll, show, showClickMask, showComponentMask, showComponentMask, showNextTo, showNextTo, showNextTo, showNextTo, showPrintPreview, showPrintPreview, showPrintPreview, showPrintPreview, showRecursively, updateChildTabPosition, updateChildTabPositions, updateEditNode, updateHover, updateHover, updateShadow, updateTabPositionForDraw, visibleAtPoint, willAcceptDrop
addDrawHandler, addDynamicProperty, addDynamicProperty, addDynamicProperty, addDynamicProperty, applyFactoryProperties, clearDynamicProperty, completeCreation, destroy, doAddHandler, doInit, doOnRender, draw, equals, error, errorIfNotCreated, getAttribute, getAttributeAsBoolean, getAttributeAsDate, getAttributeAsDateArray, getAttributeAsDouble, getAttributeAsElement, getAttributeAsFloat, getAttributeAsFloatArray, getAttributeAsInt, getAttributeAsIntArray, getAttributeAsJavaScriptObject, getAttributeAsMap, getAttributeAsObject, getAttributeAsRecord, getAttributeAsString, getAttributeAsStringArray, getConfig, getDOM, getHandlerCount, getID, getInnerHTML, getJsObj, getOrCreateJsObj, getRef, getScClassName, hasAutoAssignedID, hasDynamicProperty, hashCode, initNativeObject, internalSetID, internalSetID, isConfigOnly, isCreated, isDrawn, isFactoryCreated, onBind, onDestroy, onDraw, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setConfig, setConfigOnly, setDefaultProperties, setDragTracker, setFactoryCreated, setID, setJavaScriptObject, setLogicalStructure, setLogicalStructure, setNullProperty, setPosition, setProperty, setProperty, setProperty, setProperty, setProperty, setProperty, setProperty, setScClassName, toString
addAttachHandler, addBitlessDomHandler, addDomHandler, addHandler, asWidget, asWidgetOrNull, createHandlerManager, delegateEvent, doAttachChildren, doDetachChildren, fireEvent, getLayoutData, getParent, isAttached, isOrWasAttached, onBrowserEvent, onLoad, onUnload, removeFromParent, setLayoutData, sinkEvents, unsinkEvents
addStyleDependentName, ensureDebugId, ensureDebugId, ensureDebugId, getStyleElement, getStyleName, getStylePrimaryName, getStylePrimaryName, isVisible, onEnsureDebugId, removeStyleDependentName, removeStyleName, resolvePotentialElement, setElement, setPixelSize, setSize, setStyleDependentName, setStyleName, setStyleName, setStyleName, setStylePrimaryName, setStylePrimaryName, setVisible, sinkBitlessEvent
public TabSet()
public TabSet(com.google.gwt.core.client.JavaScriptObject jsObj)
public static TabSet getOrCreateRef(com.google.gwt.core.client.JavaScriptObject jsObj)
public static void changeAutoChildDefaults(java.lang.String autoChildName, Canvas defaults)
autoChildName
.autoChildName
- name of an AutoChild to customize the defaults for.defaults
- Canvas defaults to apply. These defaults override any existing properties
without destroying or wiping out non-overridden properties. For usage tips on this
param, see SGWTProperties
.AutoChildUsage
public static void changeAutoChildDefaults(java.lang.String autoChildName, FormItem defaults)
autoChildName
.autoChildName
- name of an AutoChild to customize the defaults for.defaults
- FormItem defaults to apply. These defaults override any existing properties
without destroying or wiping out non-overridden properties. For usage tips on this
param, see SGWTProperties
.AutoChildUsage
protected com.google.gwt.core.client.JavaScriptObject create()
public ImgButton getAddTabButton() throws java.lang.IllegalStateException
canAddTabs
is enabled.
This component is an AutoChild named "addTabButton". For an overview of how to use and
configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if this widget has not yet been rendered.public TabSet setAddTabButtonIcon(java.lang.String addTabButtonIcon) throws java.lang.IllegalStateException
addTabButton
.public java.lang.String getAddTabButtonIcon()
addTabButton
.SCImgURL
public TabSet setAnimateTabScrolling(java.lang.Boolean animateTabScrolling) throws java.lang.IllegalStateException
showTabScroller
is true, should tabs be scrolled
into view via an animation when the user interacts with the scroller buttons?animateTabScrolling
- New animateTabScrolling value. Default value is trueTabSet
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getAnimateTabScrolling()
showTabScroller
is true, should tabs be scrolled
into view via an animation when the user interacts with the scroller buttons?public TabSet setAriaCloseableSuffix(java.lang.String ariaCloseableSuffix) throws java.lang.IllegalStateException
screen reader mode
is enabled and a tab is closeable
, the ariaCloseableSuffix
is a string that
is appended to the label of closeable tabs. This suffix is hidden from sighted users, but is announced by screen readers
to indicate that the tab may be closed. Set to null
to disable appending this suffix.
Note : This is an advanced setting
ariaCloseableSuffix
- New ariaCloseableSuffix value. Default value is ", closeable"TabSet
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.String getAriaCloseableSuffix()
screen reader mode
is enabled and a tab is closeable
, the ariaCloseableSuffix
is a string that
is appended to the label of closeable tabs. This suffix is hidden from sighted users, but is announced by screen readers
to indicate that the tab may be closed. Set to null
to disable appending this suffix.
public TabSet setCanAddTabs(java.lang.Boolean canAddTabs) throws java.lang.IllegalStateException
addTabButton
to appear after the tabs
and before the tabBarControls
. There is no default behavior for what
happens when the addTabButton
is clicked. Add a handler for the TabSet.addTabClicked()
event to implement a behavior.
canAddTabs
- New canAddTabs value. Default value is nullTabSet
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getCanAddTabs()
addTabButton
to appear after the tabs
and before the tabBarControls
. There is no default behavior for what
happens when the addTabButton
is clicked. Add a handler for the TabSet.addTabClicked()
event to implement a behavior.
public TabSet setCanCloseTabs(java.lang.Boolean canCloseTabs)
Tab.canClose
.
The URL for this icon's image will be derived from closeTabIcon
by
default, but may be overridden by explicitly specifying Tab.closeIcon
.
Note: Currently, tabs can only show a single icon, so a closable tab will show
the close icon only even if Tab.icon
is set. To work around this,
add the icon
as an HTML <img> tag to the Tab.title
property, for example:
tab.setTitle("<span>" + Canvas.imgHTML("path/to/icon.png") + " Tab Title</span>");
canCloseTabs
property.canCloseTabs
- the new value for canCloseTabs. Default value is nullTabSet
instance, for chaining setter callscom.smartgwt.client.widgets.tab.TabSet#closeClick
public java.lang.Boolean getCanCloseTabs()
Tab.canClose
.
The URL for this icon's image will be derived from closeTabIcon
by
default, but may be overridden by explicitly specifying Tab.closeIcon
.
Note: Currently, tabs can only show a single icon, so a closable tab will show
the close icon only even if Tab.icon
is set. To work around this,
add the icon
as an HTML <img> tag to the Tab.title
property, for example:
tab.setTitle("<span>" + Canvas.imgHTML("path/to/icon.png") + " Tab Title</span>");
com.smartgwt.client.widgets.tab.TabSet#closeClick
public TabSet setCanEditTabTitles(java.lang.Boolean canEditTabTitles)
titleEditEvent
fires. You can override this behavior per tab
with the Tab.canEditTitle
property. Note that this
TabSet's titleEditEvent
must be set to a supported
TabTitleEditEvent
in order for users to be able to edit the titles of tabs.
canEditTabTitles
- New canEditTabTitles value. Default value is falseTabSet
instance, for chaining setter callspublic java.lang.Boolean getCanEditTabTitles()
titleEditEvent
fires. You can override this behavior per tab
with the Tab.canEditTitle
property. Note that this
TabSet's titleEditEvent
must be set to a supported
TabTitleEditEvent
in order for users to be able to edit the titles of tabs.
public TabSet setCanReorderTabs(java.lang.Boolean canReorderTabs) throws java.lang.IllegalStateException
To disallow drag-reorder of a specific tab, see Tab.canReorder
.
canReorderTabs
- New canReorderTabs value. Default value is nullTabSet
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdDragdrop overview and related methods
public java.lang.Boolean getCanReorderTabs()
To disallow drag-reorder of a specific tab, see Tab.canReorder
.
Dragdrop overview and related methods
public TabSet setCloseTabIcon(java.lang.String closeTabIcon) throws java.lang.IllegalStateException
canCloseTabs
is true.closeTabIcon
- New closeTabIcon value. Default value is [SKIN]/TabSet/close.pngTabSet
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdSCImgURL
,
Appearance overview and related methods
public java.lang.String getCloseTabIcon()
canCloseTabs
is true.SCImgURL
,
Appearance overview and related methods
public TabSet setCloseTabIconSize(int closeTabIconSize) throws java.lang.IllegalStateException
canCloseTabs
is true.closeTabIconSize
- New closeTabIconSize value. Default value is 16TabSet
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic int getCloseTabIconSize()
canCloseTabs
is true.public TabSet setDefaultTabHeight(java.lang.Integer defaultTabHeight) throws java.lang.IllegalStateException
tabBarPosition
is set to "left"
or "right"
. If unset, height will be picked up from the
Tab constructor class defaults. Note that tabs expand to fit their content so this height acts as a minimum. May be
customized by individual skins
.
defaultTabHeight
- New defaultTabHeight value. Default value is nullTabSet
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Integer getDefaultTabHeight()
tabBarPosition
is set to "left"
or "right"
. If unset, height will be picked up from the
Tab constructor class defaults. Note that tabs expand to fit their content so this height acts as a minimum. May be
customized by individual skins
.
public TabSet setDefaultTabWidth(java.lang.Integer defaultTabWidth) throws java.lang.IllegalStateException
tabBarPosition
is set to "top"
or "bottom"
. If unset, width will be picked up from the
Tab constructor class defaults. Tabs expand to fit their content, so this width acts as a minimum. Setting width:1 will
result in tabs that are only as wide as their titles. May be customized by individual skins
.
defaultTabWidth
- New defaultTabWidth value. Default value is nullTabSet
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Integer getDefaultTabWidth()
tabBarPosition
is set to "top"
or "bottom"
. If unset, width will be picked up from the
Tab constructor class defaults. Tabs expand to fit their content, so this width acts as a minimum. Setting width:1 will
result in tabs that are only as wide as their titles. May be customized by individual skins
.
public TabSet setDestroyPanes(java.lang.Boolean destroyPanes) throws java.lang.IllegalStateException
destroy()
should be called on Tab.pane
when it a tab is removed via removeTab()
. With the default setting of null
panes
will be automatically destroyed. An application might set this to false in order to re-use panes in different tabs or in
different parts of the application.
destroyPanes
- New destroyPanes value. Default value is nullTabSet
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getDestroyPanes()
destroy()
should be called on Tab.pane
when it a tab is removed via removeTab()
. With the default setting of null
panes
will be automatically destroyed. An application might set this to false in order to re-use panes in different tabs or in
different parts of the application.
public TabSet setEditProxyConstructor(java.lang.String editProxyConstructor) throws java.lang.IllegalStateException
EditProxy
for this component when the component is
first placed into edit mode
.setEditProxyConstructor
in class Canvas
editProxyConstructor
- New editProxyConstructor value. Default value is "TabSetEditProxy"TabSet
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdSCClassName
public java.lang.String getEditProxyConstructor()
EditProxy
for this component when the component is
first placed into edit mode
.getEditProxyConstructor
in class Canvas
SCClassName
public TabSet setLocateTabsBy(java.lang.String locateTabsBy)
AutoTest.getElement()
is used to parse locator strings
generated by AutoTest.getLocator()
, how should tabs within this
tabset be identified? If the locator has a specified Tab.ID
or Tab.name
, no fallback approach will be used as those attributes (with
Tab.ID
having priority) are each alone considered to definitively
locate it. Otherwise, the following options are available:
"title"
use the title as an
identifier"index"
use the index of the tab in the tabset as an identifierIf unset, and the locator has no specified ID or name, default behavior is to identify by title (if available), otherwise by index.
Note : This is an advanced setting
locateTabsBy
- New locateTabsBy value. Default value is nullTabSet
instance, for chaining setter callsLocatorStrategy
public java.lang.String getLocateTabsBy()
AutoTest.getElement()
is used to parse locator strings
generated by AutoTest.getLocator()
, how should tabs within this
tabset be identified? If the locator has a specified Tab.ID
or Tab.name
, no fallback approach will be used as those attributes (with
Tab.ID
having priority) are each alone considered to definitively
locate it. Otherwise, the following options are available:
"title"
use the title as an
identifier"index"
use the index of the tab in the tabset as an identifierIf unset, and the locator has no specified ID or name, default behavior is to identify by title (if available), otherwise by index.
LocatorStrategy
public Tab getMoreTab() throws java.lang.IllegalStateException
Tab
to be shown when showMoreTab
is enabled more than moreTabCount
tabs are provided.
This component is an AutoChild named "moreTab". For an overview of how to use and
configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if this widget has not yet been rendered.public TabSet setMoreTabCount(int moreTabCount) throws java.lang.IllegalStateException
showMoreTab
is enabled.moreTabCount
- New moreTabCount value. Default value is 5TabSet
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic int getMoreTabCount()
showMoreTab
is enabled.public TabSet setMoreTabImage(java.lang.String moreTabImage) throws java.lang.IllegalStateException
showMoreTab
is enabled this property determines the
image to display on the "More" tab button.public java.lang.String getMoreTabImage()
showMoreTab
is enabled this property determines the
image to display on the "More" tab button.SCImgURL
public VLayout getMoreTabPane() throws java.lang.IllegalStateException
NavigationBar
and TableView
.
This component is an AutoChild named "moreTabPane". For an overview of how to use and
configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if this widget has not yet been rendered.public TabSet setMoreTabPaneDefaults(Canvas moreTabPaneDefaults) throws java.lang.IllegalStateException
Currently constructs a VLayout with a NavigationBar
and TableView
.
moreTabPaneDefaults
- New moreTabPaneDefaults value. Default value is nullTabSet
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdSGWTProperties
public Canvas getMoreTabPaneDefaults()
Currently constructs a VLayout with a NavigationBar
and TableView
.
public NavigationBar getMoreTabPaneNavBar() throws java.lang.IllegalStateException
moreTabPane
;
This component is an AutoChild named "moreTabPaneNavBar". For an overview of how to use and
configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if this widget has not yet been rendered.public TabSet setMoreTabPaneProperties(Canvas moreTabPaneProperties) throws java.lang.IllegalStateException
moreTabPaneProperties
- New moreTabPaneProperties value. Default value is nullTabSet
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdSGWTProperties
public Canvas getMoreTabPaneProperties()
public TableView getMoreTabPaneTable() throws java.lang.IllegalStateException
TableView
used to show links to other tabs in the moreTabPane
;
This component is an AutoChild named "moreTabPaneTable". For an overview of how to use and
configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if this widget has not yet been rendered.public TabSet setMoreTabProperties(Tab moreTabProperties) throws java.lang.IllegalStateException
moreTabProperties
- New moreTabProperties value. Default value is nullTabSet
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic Tab getMoreTabProperties()
public TabSet setMoreTabTitle(java.lang.String moreTabTitle) throws java.lang.IllegalStateException
moreTabTitle
- New moreTabTitle value. Default value is "More"TabSet
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.String getMoreTabTitle()
public VLayout getPaneContainer() throws java.lang.IllegalStateException
Tab.pane
is shown.
Note: paneContainer and showEdges:true for rounded tabsets: you can enable decorative
image-based edges on the paneContainer by setting showEdges:true
via paneContainerDefaults (to skin all tabsets) or paneContainerProperties (to use
edges on one instance). In this structure, the BaseLine
should use media
that matches the appearance of the decorative edges and fully overlaps the edge of the
paneContainer that it is adjacent to. In the most typical appearance (symmetric edges
on all 4 sides), both TabBar.baseLineCapSize
and
TabBar.baseLineThickness
match the edgeSize
set on the paneContainer. See the
load_skin.js file for the "Smart GWT" skin for an example of setting all relevant
properties.
To disable edges for a particular TabSet, which you may want to do for a TabSet that is already within a clearly defined container, configure the paneContainer to show only it's top edge:
paneContainerProperties : { customEdges:["T"] },To completely flatten even the top edge of the TabSet:
paneContainerProperties : { customEdges:["T"] }, tabBarProperties :{ baseLineCapSize:0 },This "flattens" the baseLine so that only the center image is used.
This component is an AutoChild named "paneContainer". For an overview of how to use and
configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if this widget has not yet been rendered.public TabSet setPaneContainerClassName(java.lang.String paneContainerClassName)
paneContainerClassName
- New paneContainerClassName value. Default value is nullTabSet
instance, for chaining setter callsCSSStyleName
,
Appearance overview and related methods
public java.lang.String getPaneContainerClassName()
CSSStyleName
,
Appearance overview and related methods
public TabSet setPaneContainerOverflow(Overflow paneContainerOverflow)
For other values and their meaning, see Overflow
If this method is called after the component has been drawn/initialized:
Update paneContainerOverflow
after creation.
Note : This is an advanced setting
paneContainerOverflow
- new overflow setting. Default value is Canvas.AUTOTabSet
instance, for chaining setter callspublic Overflow getPaneContainerOverflow()
For other values and their meaning, see Overflow
public TabSet setPaneMargin(int paneMargin) throws java.lang.IllegalStateException
Note that this property may be specified on a per-tab basis via
Tab.paneMargin
.
paneMargin
- New paneMargin value. Default value is 0TabSet
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic int getPaneMargin()
Note that this property may be specified on a per-tab basis via
Tab.paneMargin
.
public TabSet setPickerButtonHSrc(java.lang.String pickerButtonHSrc) throws java.lang.IllegalStateException
showTabPicker
is true, and symmetricPickerButton
is set to true, this property
governs the base URL for the picker button image, when displayed in a horizontal tab-bar [IE tabBarPosition
is set to "top"
or
"bottom"
]. Note that if symmetricPickerButton
is false, the pickerButtonSrc
property will be used instead.
This base
URL will have a suffix of "Down"
appended when the user holds the mouse down over the button, and
"Disabled"
if the tabset as a whole is disabled.
pickerButtonHSrc
- New pickerButtonHSrc value. Default value is "[SKIN]hpicker.gif"TabSet
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdsetSymmetricPickerButton(java.lang.Boolean)
,
SCImgURL
public java.lang.String getPickerButtonHSrc()
showTabPicker
is true, and symmetricPickerButton
is set to true, this property
governs the base URL for the picker button image, when displayed in a horizontal tab-bar [IE tabBarPosition
is set to "top"
or
"bottom"
]. Note that if symmetricPickerButton
is false, the pickerButtonSrc
property will be used instead.
This base
URL will have a suffix of "Down"
appended when the user holds the mouse down over the button, and
"Disabled"
if the tabset as a whole is disabled.
getSymmetricPickerButton()
,
SCImgURL
public TabSet setPickerButtonSize(int pickerButtonSize) throws java.lang.IllegalStateException
showTabPicker
is true
and isTouch
is false
, this property governs the size of the tab
picker button. This value is applied as the width of the tab picker button if the tabBar
is horizontal, or the height if the tabBar
is
vertical. Note that the other dimension is determined by this.tabBarThickness
. On touch browsers (where isTouch
is true
), touchPickerButtonSize
is used instead.
pickerButtonSize
- New pickerButtonSize value. Default value is 16TabSet
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic int getPickerButtonSize()
showTabPicker
is true
and isTouch
is false
, this property governs the size of the tab
picker button. This value is applied as the width of the tab picker button if the tabBar
is horizontal, or the height if the tabBar
is
vertical. Note that the other dimension is determined by this.tabBarThickness
. On touch browsers (where isTouch
is true
), touchPickerButtonSize
is used instead.
public TabSet setPickerButtonSrc(java.lang.String pickerButtonSrc) throws java.lang.IllegalStateException
showTabPicker
is true, this property governs the base
URL for the picker button image, when symmetricPickerButton
is set to false Note that if symmetricPickerButton
is true, the pickerButtonHSrc
and pickerButtonVSrc
properties will be used instead.
To get the path to the image to display, this base URL will be modified as follows:
"Down"
or "Disabled"
will be appended.tabBarPosition
for this tabSet will be appended.pickerButtonSrc
- New pickerButtonSrc value. Default value is "[SKIN]/picker.gif"TabSet
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdsetSymmetricPickerButton(java.lang.Boolean)
,
SCImgURL
public java.lang.String getPickerButtonSrc()
showTabPicker
is true, this property governs the base
URL for the picker button image, when symmetricPickerButton
is set to false Note that if symmetricPickerButton
is true, the pickerButtonHSrc
and pickerButtonVSrc
properties will be used instead.
To get the path to the image to display, this base URL will be modified as follows:
"Down"
or "Disabled"
will be appended.tabBarPosition
for this tabSet will be appended.getSymmetricPickerButton()
,
SCImgURL
public TabSet setPickerButtonVSrc(java.lang.String pickerButtonVSrc) throws java.lang.IllegalStateException
showTabPicker
is true, and symmetricPickerButton
is set to true, this property
governs the base URL for the picker button image, when displayed in a verricaL tab-bar [IE tabBarPosition
is set to "LEFT"
or
"right"
]. Note that if symmetricPickerButton
is false, the pickerButtonSrc
property will be used instead.
This base
URL will have a suffix of "Down"
appended when the user holds the mouse down over the button, and
"Disabled"
if the tabset as a whole is disabled.
pickerButtonVSrc
- New pickerButtonVSrc value. Default value is "[SKIN]vpicker.gif"TabSet
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdsetSymmetricPickerButton(java.lang.Boolean)
,
SCImgURL
public java.lang.String getPickerButtonVSrc()
showTabPicker
is true, and symmetricPickerButton
is set to true, this property
governs the base URL for the picker button image, when displayed in a verricaL tab-bar [IE tabBarPosition
is set to "LEFT"
or
"right"
]. Note that if symmetricPickerButton
is false, the pickerButtonSrc
property will be used instead.
This base
URL will have a suffix of "Down"
appended when the user holds the mouse down over the button, and
"Disabled"
if the tabset as a whole is disabled.
getSymmetricPickerButton()
,
SCImgURL
public StretchImgButton getScroller() throws java.lang.IllegalStateException
"tabScroller"
is specified in the tabBarControls
. By default, the scroller constructor is
StretchImgButton
. Note that the scroller items
are determined automatically, so any items set in
scrollerProperties will be ignored.
This component is an AutoChild named "scroller". For an overview of how to use and
configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if this widget has not yet been rendered.public TabSet setScrollerButtonSize(int scrollerButtonSize) throws java.lang.IllegalStateException
showTabScroller
is true, this property governs the
size of scroller buttons. Applied as the width of buttons if the tabBar is horizontal, or the height if tabBar is
vertical. Note that the other dimension is determined by this.tabBarThickness
scrollerButtonSize
- New scrollerButtonSize value. Default value is 16TabSet
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic int getScrollerButtonSize()
showTabScroller
is true, this property governs the
size of scroller buttons. Applied as the width of buttons if the tabBar is horizontal, or the height if tabBar is
vertical. Note that the other dimension is determined by this.tabBarThickness
public TabSet setScrollerHSrc(java.lang.String scrollerHSrc) throws java.lang.IllegalStateException
tab scroller buttons
, and
symmetricScroller
is true, this property governs the
base URL for the tab bar back and forward scroller button images for horizontal tab bars [IE for tab sets with tabBarPosition
set to "top" or "bottom"]. Note that if
symmetricScroller
is false, scrollerSrc
will be used instead.
To get the path to the image to display, this base URL will be modified as follows:
"Down"
or "Disabled"
will be appended."forward"
or
"back"
will be appended for the forward or backward scrolling button."[SKIN]hscroll.gif"
, the image displayed for the back-scroller button on a tabSet
with tabBarPosition
set to "top" and symmetricScroller
set to true would be one of
"[SKIN]hscroll_back.gif"
, "[SKIN]hscroll_Down_back.gif"
, and
"[SKIN]hscroll_Disabled_back.gif"
. Note that for best results the media should be sized to match the
scroller button sizes, determined by tabBarThickness
and scrollerButtonSize
.
scrollerHSrc
- New scrollerHSrc value. Default value is "[SKIN]hscroll.gif"TabSet
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdsetSymmetricScroller(java.lang.Boolean)
,
SCImgURL
public java.lang.String getScrollerHSrc()
tab scroller buttons
, and
symmetricScroller
is true, this property governs the
base URL for the tab bar back and forward scroller button images for horizontal tab bars [IE for tab sets with tabBarPosition
set to "top" or "bottom"]. Note that if
symmetricScroller
is false, scrollerSrc
will be used instead.
To get the path to the image to display, this base URL will be modified as follows:
"Down"
or "Disabled"
will be appended."forward"
or
"back"
will be appended for the forward or backward scrolling button."[SKIN]hscroll.gif"
, the image displayed for the back-scroller button on a tabSet
with tabBarPosition
set to "top" and symmetricScroller
set to true would be one of
"[SKIN]hscroll_back.gif"
, "[SKIN]hscroll_Down_back.gif"
, and
"[SKIN]hscroll_Disabled_back.gif"
. Note that for best results the media should be sized to match the
scroller button sizes, determined by tabBarThickness
and scrollerButtonSize
.
getSymmetricScroller()
,
SCImgURL
public TabSet setScrollerSrc(java.lang.String scrollerSrc) throws java.lang.IllegalStateException
tab scroller buttons
, and
symmetricScroller
is false, this property governs
the base URL for the tab bar back and forward scroller button images. Note that if symmetricScroller
is true, scrollerHSrc
and scrollerVSrc
will be used instead.
To get the path to the image to display, this base URL will be modified as follows:
"Down"
or "Disabled"
will be appended.tabBarPosition
for this tabSet will be appended."forward"
or "back"
will be appended for the forward or backward scrolling
button."[SKIN]scroll.gif"
, the image displayed for
the back-scroller button on a tabSet with tabBarPosition
set to "top" and symmetricScroller
set to false would be one of "[SKIN]scroll_top_back.gif"
, "[SKIN]scroll_Down_top_back.gif"
,
and "[SKIN]scroll_Disabled_top_back.gif"
. Note that for best results the media should be sized to match
the scroller button sizes, determined by tabBarThickness
and scrollerButtonSize
.
scrollerSrc
- New scrollerSrc value. Default value is "[SKIN]/scroll.gif"TabSet
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdsetSymmetricScroller(java.lang.Boolean)
,
SCImgURL
public java.lang.String getScrollerSrc()
tab scroller buttons
, and
symmetricScroller
is false, this property governs
the base URL for the tab bar back and forward scroller button images. Note that if symmetricScroller
is true, scrollerHSrc
and scrollerVSrc
will be used instead.
To get the path to the image to display, this base URL will be modified as follows:
"Down"
or "Disabled"
will be appended.tabBarPosition
for this tabSet will be appended."forward"
or "back"
will be appended for the forward or backward scrolling
button."[SKIN]scroll.gif"
, the image displayed for
the back-scroller button on a tabSet with tabBarPosition
set to "top" and symmetricScroller
set to false would be one of "[SKIN]scroll_top_back.gif"
, "[SKIN]scroll_Down_top_back.gif"
,
and "[SKIN]scroll_Disabled_top_back.gif"
. Note that for best results the media should be sized to match
the scroller button sizes, determined by tabBarThickness
and scrollerButtonSize
.
getSymmetricScroller()
,
SCImgURL
public TabSet setScrollerVSrc(java.lang.String scrollerVSrc) throws java.lang.IllegalStateException
tab scroller buttons
, and
symmetricScroller
is true, this property governs the
base URL for the tab bar back and forward scroller button images for vertical tab bars [IE for tab sets with tabBarPosition
set to "left" or "right"]. Note that if
symmetricScroller
is false, scrollerSrc
will be used instead.
To get the path to the image to display, this base URL will be modified as follows:
"Down"
or "Disabled"
will be appended."forward"
or
"back"
will be appended for the forward or backward scrolling button."[SKIN]vscroll.gif"
, the image displayed for the back-scroller button on a tabSet
with tabBarPosition
set to "left" and symmetricScroller
set to true would be one of
"[SKIN]vscroll_back.gif"
, "[SKIN]vscroll_Down_back.gif"
, and
"[SKIN]vscroll_Disabled_back.gif"
. Note that for best results the media should be sized to match the
scroller button sizes, determined by tabBarThickness
and scrollerButtonSize
.
scrollerVSrc
- New scrollerVSrc value. Default value is "[SKIN]vscroll.gif"TabSet
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdsetSymmetricScroller(java.lang.Boolean)
,
SCImgURL
public java.lang.String getScrollerVSrc()
tab scroller buttons
, and
symmetricScroller
is true, this property governs the
base URL for the tab bar back and forward scroller button images for vertical tab bars [IE for tab sets with tabBarPosition
set to "left" or "right"]. Note that if
symmetricScroller
is false, scrollerSrc
will be used instead.
To get the path to the image to display, this base URL will be modified as follows:
"Down"
or "Disabled"
will be appended."forward"
or
"back"
will be appended for the forward or backward scrolling button."[SKIN]vscroll.gif"
, the image displayed for the back-scroller button on a tabSet
with tabBarPosition
set to "left" and symmetricScroller
set to true would be one of
"[SKIN]vscroll_back.gif"
, "[SKIN]vscroll_Down_back.gif"
, and
"[SKIN]vscroll_Disabled_back.gif"
. Note that for best results the media should be sized to match the
scroller button sizes, determined by tabBarThickness
and scrollerButtonSize
.
getSymmetricScroller()
,
SCImgURL
public TabSet setShowMoreTab(java.lang.Boolean showMoreTab) throws java.lang.IllegalStateException
moreTabCount
be shown on a "more"
tab? This setting is used to emulate an iPhone-style tab bar "more" button.
showMoreTab
- New showMoreTab value. Default value is nullTabSet
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getShowMoreTab()
moreTabCount
be shown on a "more"
tab? This setting is used to emulate an iPhone-style tab bar "more" button.
public TabSet setShowPaneContainerEdges(java.lang.Boolean showPaneContainerEdges)
edges
.
Note : This is an advanced setting
showPaneContainerEdges
- New showPaneContainerEdges value. Default value is nullTabSet
instance, for chaining setter callspublic java.lang.Boolean getShowPaneContainerEdges()
edges
.public TabSet setShowPartialEdges(java.lang.Boolean showPartialEdges) throws java.lang.IllegalStateException
edges
, setting
this attribute to true
will set the paneContainer to show customEdges
for the three sides opposing the tabBarPosition.
Note : This is an advanced setting
showPartialEdges
- New showPartialEdges value. Default value is falseTabSet
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getShowPartialEdges()
edges
, setting
this attribute to true
will set the paneContainer to show customEdges
for the three sides opposing the tabBarPosition.public TabSet setShowTabBar(java.lang.Boolean showTabBar)
showTabBar
- New showTabBar value. Default value is trueTabSet
instance, for chaining setter callspublic java.lang.Boolean getShowTabBar()
public TabSet setShowTabPicker(java.lang.Boolean showTabPicker) throws java.lang.IllegalStateException
showTabPicker
- New showTabPicker value. Default value is trueTabSet
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getShowTabPicker()
public TabSet setShowTabScroller(java.lang.Boolean showTabScroller) throws java.lang.IllegalStateException
handsets
and true otherwise.showTabScroller
- New showTabScroller value. Default value is nullTabSet
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getShowTabScroller()
handsets
and true otherwise.public TabSet setSimpleTabBaseStyle(java.lang.String simpleTabBaseStyle)
useSimpleTabs
is true,
simpleTabBaseStyle
will be the base style used to determine the css style to apply to the tabs.This property will be suffixed with the side on which the tab-bar will appear, followed by with the tab's state (selected, over, etc), resolving to a className like "tabButtonTopOver".
simpleTabBaseStyle
- New simpleTabBaseStyle value. Default value is "tabButton"TabSet
instance, for chaining setter callsButton.setBaseStyle(java.lang.String)
,
setSimpleTabIconOnlyBaseStyle(java.lang.String)
,
CSSStyleName
,
Appearance overview and related methods
public java.lang.String getSimpleTabBaseStyle()
useSimpleTabs
is true,
simpleTabBaseStyle
will be the base style used to determine the css style to apply to the tabs.This property will be suffixed with the side on which the tab-bar will appear, followed by with the tab's state (selected, over, etc), resolving to a className like "tabButtonTopOver".
Button.getBaseStyle()
,
getSimpleTabIconOnlyBaseStyle()
,
CSSStyleName
,
Appearance overview and related methods
public TabSet setSimpleTabIconOnlyBaseStyle(java.lang.String simpleTabIconOnlyBaseStyle)
useSimpleTabs
is true,
simpleTabIconOnlyBaseStyle
will be the base style used to determine the css style to apply to the tabs if
Tab.canAdaptWidth
is set and the title is not being shown.
This property will be suffixed with the side on which the tab-bar will appear, followed by with the tab's state (selected, over, etc), resolving to a className like "iconOnlyTabButtonTopOver".
Note that this property is only
defined for certain skins, where it's needed. If not defined, simpleTabBaseStyle
will serve as base style whether or not
the title is hidden.
simpleTabIconOnlyBaseStyle
- New simpleTabIconOnlyBaseStyle value. Default value is variesTabSet
instance, for chaining setter callsButton.setBaseStyle(java.lang.String)
,
Button.setIconOnlyBaseStyle(java.lang.String)
,
setSimpleTabBaseStyle(java.lang.String)
,
CSSStyleName
public java.lang.String getSimpleTabIconOnlyBaseStyle()
useSimpleTabs
is true,
simpleTabIconOnlyBaseStyle
will be the base style used to determine the css style to apply to the tabs if
Tab.canAdaptWidth
is set and the title is not being shown.
This property will be suffixed with the side on which the tab-bar will appear, followed by with the tab's state (selected, over, etc), resolving to a className like "iconOnlyTabButtonTopOver".
Note that this property is only
defined for certain skins, where it's needed. If not defined, simpleTabBaseStyle
will serve as base style whether or not
the title is hidden.
Button.getBaseStyle()
,
Button.getIconOnlyBaseStyle()
,
getSimpleTabBaseStyle()
,
CSSStyleName
public TabSet setSkinImgDir(java.lang.String skinImgDir) throws java.lang.IllegalStateException
skinDir
.setSkinImgDir
in class Canvas
skinImgDir
- New skinImgDir value. Default value is "images/TabSet/"TabSet
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdSCImgURL
,
Images overview and related methods
public java.lang.String getSkinImgDir()
skinDir
.getSkinImgDir
in class Canvas
SCImgURL
,
Images overview and related methods
public TabSet setSymmetricEdges(java.lang.Boolean symmetricEdges) throws java.lang.IllegalStateException
show edges
for the
paneContainer, this property determines whether the same edge media will be used regardless of the tab bar position, or
whether different media should be used (necessary if the edge appearance is not symmetrical on all sides). If this
property is set to false the paneContainer edge image URLs will be prefixed with the tabBarPosition of the tabSet - for
example "[SKIN]edge_top_T.gif"
rather than just "[SKIN]edge_T.gif"
.
When
symmetricEdges
is false, custom edge sizes for the pane container may be specified via topEdgeSizes
et al, and custom edge offsets via topEdgeOffsets
et al.
symmetricEdges
- New symmetricEdges value. Default value is trueTabSet
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdAppearance overview and related methods
public java.lang.Boolean getSymmetricEdges()
show edges
for the
paneContainer, this property determines whether the same edge media will be used regardless of the tab bar position, or
whether different media should be used (necessary if the edge appearance is not symmetrical on all sides). If this
property is set to false the paneContainer edge image URLs will be prefixed with the tabBarPosition of the tabSet - for
example "[SKIN]edge_top_T.gif"
rather than just "[SKIN]edge_T.gif"
.
When
symmetricEdges
is false, custom edge sizes for the pane container may be specified via topEdgeSizes
et al, and custom edge offsets via topEdgeOffsets
et al.
Appearance overview and related methods
public TabSet setSymmetricPickerButton(java.lang.Boolean symmetricPickerButton) throws java.lang.IllegalStateException
tab picker button
, this
property determines whether the pickerButtonHSrc
and
pickerButtonVSrc
media will be used for vertical and
horizontal tab-bar picker buttons, or whether separate media should be used for each possible tabBarPosition
based on the pickerButtonSrc
property for this tabSet.symmetricPickerButton
- New symmetricPickerButton value. Default value is trueTabSet
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getSymmetricPickerButton()
tab picker button
, this
property determines whether the pickerButtonHSrc
and
pickerButtonVSrc
media will be used for vertical and
horizontal tab-bar picker buttons, or whether separate media should be used for each possible tabBarPosition
based on the pickerButtonSrc
property for this tabSet.public TabSet setSymmetricScroller(java.lang.Boolean symmetricScroller) throws java.lang.IllegalStateException
tab scroller buttons
, this
property determines whether the scrollerHSrc
and scrollerVSrc
media will be used for vertical and horizontal
tab-bar scroller buttons, or whether separate media should be used for each possible tabBarPosition
based on the scrollerSrc
property for this tabSet.symmetricScroller
- New symmetricScroller value. Default value is trueTabSet
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getSymmetricScroller()
tab scroller buttons
, this
property determines whether the scrollerHSrc
and scrollerVSrc
media will be used for vertical and horizontal
tab-bar scroller buttons, or whether separate media should be used for each possible tabBarPosition
based on the scrollerSrc
property for this tabSet.public TabBar getTabBar() throws java.lang.IllegalStateException
TabBar
.
This component is an AutoChild named "tabBar". For an overview of how to use and
configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if this widget has not yet been rendered.public TabSet setTabBarAlign(Side tabBarAlign)
If the tabBarPosition
is
"top" or "bottom", then this attribute may be set to "left", "right" or "center". The default is "left", or "right" in
RTL mode
.
If the tabBarPosition
is "left" or "right", then this attribute may
be set to "top", "bottom" or "center". The default is "top".
tabBarAlign
- New tabBarAlign value. Default value is see belowTabSet
instance, for chaining setter callspublic Side getTabBarAlign()
If the tabBarPosition
is
"top" or "bottom", then this attribute may be set to "left", "right" or "center". The default is "left", or "right" in
RTL mode
.
If the tabBarPosition
is "left" or "right", then this attribute may
be set to "top", "bottom" or "center". The default is "top".
public TabSet setTabBarAlign(Alignment tabBarAlign)
If the tabBarPosition
is
"top" or "bottom", then this attribute may be set to "left", "right" or "center". The default is "left", or "right" in
RTL mode
.
If the tabBarPosition
is "left" or "right", then this attribute may
be set to "top", "bottom" or "center". The default is "top".
tabBarAlign
- New tabBarAlign value. Default value is see belowTabSet
instance, for chaining setter callspublic Alignment getTabBarAlignAsAlignment()
If the tabBarPosition
is
"top" or "bottom", then this attribute may be set to "left", "right" or "center". The default is "left", or "right" in
RTL mode
.
If the tabBarPosition
is "left" or "right", then this attribute may
be set to "top", "bottom" or "center". The default is "top".
public Layout getTabBarControlLayout() throws java.lang.IllegalStateException
com.smartgwt.client.types.AutoChild
of type Layout
that holds the
tabBarControls
as well as the built-in controls such as
the tab picker menu
.
This component is an AutoChild named "tabBarControlLayout". For an overview of how to use and
configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if this widget has not yet been rendered.public TabSet setTabBarPosition(Side tabBarPosition) throws java.lang.IllegalStateException
tabBarPosition
- New tabBarPosition value. Default value is Canvas.TOPTabSet
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic Side getTabBarPosition()
public TabSet setTabBarThickness(int tabBarThickness)
tabBarThickness
- New tabBarThickness value. Default value is 21TabSet
instance, for chaining setter callspublic int getTabBarThickness()
public ImgButton getTabPicker() throws java.lang.IllegalStateException
"tabPicker"
is specified in the tabBarControls
.
This component is an AutoChild named "tabPicker". For an overview of how to use and
configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if this widget has not yet been rendered.public TextItem getTitleEditor() throws java.lang.IllegalStateException
com.smartgwt.client.types.AutoChild
facilities.
This component is an AutoChild named "titleEditor". For an overview of how to use and
configure AutoChildren, see Using AutoChildren
.
java.lang.IllegalStateException
- if this widget has not yet been rendered.getCanEditTabTitles()
,
Tab.getCanEditTitle()
,
editTabTitle(java.lang.String)
public TabSet setTitleEditorLeftOffset(java.lang.Integer titleEditorLeftOffset)
titleEditorLeftOffset
- New titleEditorLeftOffset value. Default value is nullTabSet
instance, for chaining setter callssetTitleEditorRightOffset(java.lang.Integer)
,
setTitleEditorTopOffset(java.lang.Integer)
public java.lang.Integer getTitleEditorLeftOffset()
getTitleEditorRightOffset()
,
getTitleEditorTopOffset()
public TabSet setTitleEditorProperties(TextItem titleEditorProperties) throws java.lang.IllegalStateException
titleEditor
. This is the
text item we use to edit tab titles in this tabSet.titleEditorProperties
- New titleEditorProperties value. Default value is nullTabSet
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdcom.smartgwt.client.widgets.tab.TabSet#setTitleEditor
,
setCanEditTabTitles(java.lang.Boolean)
public TextItem getTitleEditorProperties()
titleEditor
. This is the
text item we use to edit tab titles in this tabSet.getTitleEditor()
,
getCanEditTabTitles()
public TabSet setTitleEditorRightOffset(java.lang.Integer titleEditorRightOffset)
titleEditorRightOffset
- New titleEditorRightOffset value. Default value is nullTabSet
instance, for chaining setter callssetTitleEditorLeftOffset(java.lang.Integer)
,
setTitleEditorTopOffset(java.lang.Integer)
public java.lang.Integer getTitleEditorRightOffset()
getTitleEditorLeftOffset()
,
getTitleEditorTopOffset()
public TabSet setTitleEditorTopOffset(java.lang.Integer titleEditorTopOffset)
Note: The height of the editor is an attribute of the editor
itself, and can be set by specifying a "height" property in titleEditorDefaults
.
titleEditorTopOffset
- New titleEditorTopOffset value. Default value is nullTabSet
instance, for chaining setter callssetTitleEditorLeftOffset(java.lang.Integer)
,
setTitleEditorRightOffset(java.lang.Integer)
public java.lang.Integer getTitleEditorTopOffset()
Note: The height of the editor is an attribute of the editor
itself, and can be set by specifying a "height" property in titleEditorDefaults
.
getTitleEditorLeftOffset()
,
getTitleEditorRightOffset()
public TabSet setTouchPickerButtonSize(int touchPickerButtonSize) throws java.lang.IllegalStateException
isTouch
is true
.touchPickerButtonSize
- New touchPickerButtonSize value. Default value is 16TabSet
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdsetPickerButtonSize(int)
public int getTouchPickerButtonSize()
isTouch
is true
.getPickerButtonSize()
public TabSet setUseIOSTabs(java.lang.Boolean useIOSTabs) throws java.lang.IllegalStateException
This attribute only has an effect for tabs that are not closable
, and only for Mobile WebKit.
useIOSTabs
- New useIOSTabs value. Default value is falseTabSet
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getUseIOSTabs()
This attribute only has an effect for tabs that are not closable
, and only for Mobile WebKit.
public TabSet setUseSimpleTabs(java.lang.Boolean useSimpleTabs) throws java.lang.IllegalStateException
ImgTab
tabs? If set to true tabs will instances of Button
, styled according to the simpleTabBaseStyle
.
Note : This is an advanced setting
useSimpleTabs
- New useSimpleTabs value. Default value is falseTabSet
instance, for chaining setter callsjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic java.lang.Boolean getUseSimpleTabs()
ImgTab
tabs? If set to true tabs will instances of Button
, styled according to the simpleTabBaseStyle
.
public com.google.gwt.event.shared.HandlerRegistration addAddTabClickedHandler(AddTabClickedHandler handler)
Event that fires when the TabSet.addTabButton
is clicked.
No default behavior.
addAddTabClickedHandler
in interface HasAddTabClickedHandlers
handler
- the addTabClicked handlerHandlerRegistration
used to remove this handlerpublic void cancelTabTitleEditing()
canEditTabTitles
), dismiss the editor and discard the edit value entered by the user.public int getSelectedTabNumber()
public void hideTab(int tab)
Note that this does not remove a tab from the tabset entirely (see removeTab()
) The tab will no longer be visible to the user or
selectable by the user, but the configuration will still existing in the tabs array
for this tabSet. Developers should particularly be aware of
this when calling methods that refer to tabs by index - the index includes both hidden and visible tabs in the tabset.
Tabs may be marked as hidden at init-time via Tab.hidden
.
To test whether a tab is currently visible, use tabIsVisible()
tab
- Tab to hidepublic void hideTab(java.lang.String tab)
Note that this does not remove a tab from the tabset entirely (see removeTab()
) The tab will no longer be visible to the user or
selectable by the user, but the configuration will still existing in the tabs array
for this tabSet. Developers should particularly be aware of
this when calling methods that refer to tabs by index - the index includes both hidden and visible tabs in the tabset.
Tabs may be marked as hidden at init-time via Tab.hidden
.
To test whether a tab is currently visible, use tabIsVisible()
tab
- Tab to hidepublic void hideTab(Tab tab)
Note that this does not remove a tab from the tabset entirely (see removeTab()
) The tab will no longer be visible to the user or
selectable by the user, but the configuration will still existing in the tabs array
for this tabSet. Developers should particularly be aware of
this when calling methods that refer to tabs by index - the index includes both hidden and visible tabs in the tabset.
Tabs may be marked as hidden at init-time via Tab.hidden
.
To test whether a tab is currently visible, use tabIsVisible()
tab
- Tab to hidepublic com.google.gwt.event.shared.HandlerRegistration addCloseClickHandler(CloseClickHandler handler)
When TabSet.canCloseTabs
is set, this notification method
fired when the user clicks the "close" icon for a tab. Call TabCloseClickEvent.cancel()
from within CloseClickHandler.onCloseClick(com.smartgwt.client.widgets.tab.events.TabCloseClickEvent)
to cancel default behavior of removing the tab
from the TabSet
addCloseClickHandler
in interface HasCloseClickHandlers
handler
- the closeClick handlerHandlerRegistration
used to remove this handlerpublic void removeLastTab()
moreTab
if
present.public void reorderTab(Tab tab)
tab
- tab to movepublic void reorderTab(Tab tab, int moveToPosition)
tab
- tab to movemoveToPosition
- the index to move the tab to - defaults to the end of the tabset if not passedpublic void saveTabTitle()
canEditTabTitles
), save the edited tab title and hide the editor.public void scrollBack()
public void scrollForward()
public void setCanCloseTab(Tab tab, boolean canClose)
canClose
property to the boolean parameter
canClose. If canClose is null, this will have the effect of causing the tab to fall back on canCloseTabs
.tab
- tab to changecanClose
- new value for the tab's canClose property, or null to clear itpublic void setTabPickerTitle(Tab tab, java.lang.String pickerTitle)
tab
- pickerTitle
- new title.
See HTMLString
public void showTab(int tab)
hidden tab
at runtime. To test whether a tab is
currently visible, use tabIsVisible()
tab
- Tab to hidepublic void showTab(java.lang.String tab)
hidden tab
at runtime. To test whether a tab is
currently visible, use tabIsVisible()
tab
- Tab to hidepublic void showTab(Tab tab)
hidden tab
at runtime. To test whether a tab is
currently visible, use tabIsVisible()
tab
- Tab to hidepublic com.google.gwt.event.shared.HandlerRegistration addTabContextMenuHandler(TabContextMenuHandler handler)
Notification fired when the user right-clicks on a tab. Event may be cancelled by returning false
addTabContextMenuHandler
in interface HasTabContextMenuHandlers
handler
- the tabContextMenu handlerHandlerRegistration
used to remove this handlerpublic com.google.gwt.event.shared.HandlerRegistration addTabDeselectedHandler(TabDeselectedHandler handler)
Optional handler to fire when a tab is deselected. Calling TabDeselectedEvent.cancel
will cancel the new selection, leaving tab
ID
selected. As with com.smartgwt.client.widgets.tab.events.TabSelectedEventl
this method only
fires when the tabset is drawn.
addTabDeselectedHandler
in interface HasTabDeselectedHandlers
handler
- the tabDeselected handlerHandlerRegistration
used to remove this handlerpublic Tab tabForPane(Canvas pane)
pane
- pane to showpublic com.google.gwt.event.shared.HandlerRegistration addTabIconClickHandler(TabIconClickHandler handler)
Method fired when the user clicks the icon for a tab, as specified via Tab.icon
.
Default behavior will fire icon.click()
if
specified, with two parameters tab
(a pointer to the tab object and tabSet
a pointer to the
tabSet instance.
addTabIconClickHandler
in interface HasTabIconClickHandlers
handler
- the tabIconClick handlerHandlerRegistration
used to remove this handlerpublic boolean tabIsVisible(int tab)
hidden or visible
?tab
- Tab to testpublic boolean tabIsVisible(java.lang.String tab)
hidden or visible
?tab
- Tab to testpublic boolean tabIsVisible(Tab tab)
hidden or visible
?tab
- Tab to testpublic com.google.gwt.event.shared.HandlerRegistration addTabSelectedHandler(TabSelectedHandler handler)
Notification fired when a tab is selected. Note that this will only fire if this tabSet is drawn. If a tab is selected
before draw()
is called, com.smartgwt.client.widgets.tab.events.TabSelectedEventl
will fire on draw()
.
addTabSelectedHandler
in interface HasTabSelectedHandlers
handler
- the tabSelected handlerHandlerRegistration
used to remove this handlerpublic com.google.gwt.event.shared.HandlerRegistration addTabsReorderedHandler(TabsReorderedHandler handler)
Notification method executed when one or more tabs in the TabSet are reordered.
addTabsReorderedHandler
in interface HasTabsReorderedHandlers
handler
- the tabsReordered handlerHandlerRegistration
used to remove this handlerpublic com.google.gwt.event.shared.HandlerRegistration addTabTitleChangedHandler(TabTitleChangedHandler handler)
This notification method fired when the user changes the title of a tab in this TabSet. This can happen either through
user interaction with the UI if canEditTabTitles
is
set, or programmatically if application code calls editTabTitle
.
Call TabTitleChangedEvent.cancel()
from within TabTitleChangedHandler.onTabTitleChanged(com.smartgwt.client.widgets.tab.events.TabTitleChangedEvent)
from this method to cancel the change.
addTabTitleChangedHandler
in interface HasTabTitleChangedHandlers
handler
- the tabTitleChanged handlerHandlerRegistration
used to remove this handlerpublic static void setDefaultProperties(TabSet tabSetProperties)
Note: This method is intended for setting default attributes only and will affect all instances of the underlying class (including those automatically generated in JavaScript). This method should not be used to apply standard EventHandlers or override methods for a class - use a custom subclass instead. Calling this method after instances have been created can result in undefined behavior, since it bypasses any setters and a class instance may have already examined a particular property and not be expecting any changes through this route.
tabSetProperties
- properties that should be used as new defaults when instances of this class are createdSGWTProperties
public void setSelectedTab(int selectedTab)
selectedTab
- selectedTab Default value is 0public void setTabs(Tab... tabs)
Tab
objects, specifying the title
and pane contents of each tab in the TabSet.
Tab instances are not widgets, they just provide configuration such as title and icon.
After providing Tab
instances to
setTabs()
, the TabSet creates actual UI widgets to serve as interactive
tabs. Any further modifications to tabs should be performed via TabSet APIs such as
setTabTitle
,
setTabIcon
and
setTabPane
.
You can add and remove tabs after creating the TabSet by calling
addTab
and
removeTab
.
tabs
- new tabs for the TabSetpublic void setPaneContainerProperties(Canvas paneContainerProperties)
paneContainerProperties
- the pane container propertiesjava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic void setTabBarControls(java.lang.Object... tabBarControls) throws java.lang.IllegalStateException
"tabScroller"
and
"tabPicker"
. These correspond to the scroller
and tabPicker
AutoChildren, respectively. The "tabScroller"
standard control shows two
buttons for scrolling through the tabs in order and the "tabPicker"
standard
control allows tabs to be picked directly from a menu. The standard controls show up only if
showTabScroller
or showTabPicker
is true and there is not
enough space available to show all of the tabs in the tabBar.
tabBarControls
- tabBarControls Default value is ["tabScroller", "tabPicker"]java.lang.IllegalStateException
- this property cannot be changed after the component has been createdAdditional controls can be included by adding any widget to this array. Controls will show up in the order in which they are specified. For example, the following code would add a button in the tabBar area, while preserving the normal behavior of the tabScroller and tabPicker:
ImgButton addButton = new ImgButton(); addButton.setSrc("[SKINIMG]/actions/add.png"); addButton.setTitle("Add"); addButton.setWidth(16); addButton.setHeight(16); addButton.setAlign(Alignment.CENTER); TabSet ts = new TabSet(); ts.setWidth(300); ts.setHeight(32); ts.setTabs(new Tab("Tab one")); ts.setTabBarControls(addButton, TabBarControls.TAB_SCROLLER, TabBarControls.TAB_PICKER); contentLayout.addMember(ts);You can also refer to the default tabPicker/tabScroll controls from Component XML:
<TabSet width="300"> <tabBarControls> <Button title="Custom Button"/> <value xsi:type="string">tabPicker</value> <value xsi:type="string">tabScroller</value> </tabBarControls> <tabs> <tab title="Foo"/> <tab title="Bar"/> </tabs> </TabSet>
Note : This is an advanced setting
public void selectTab(int tabIndex)
tabIndex
- the tab indexpublic void selectTab(java.lang.String ID)
ID
- the tab IDpublic void selectTab(Tab tab)
tab
- the tabpublic void setTabTitle(int tabIndex, java.lang.String title)
tabIndex
- the tab indextitle
- new titlepublic void setTabTitle(java.lang.String ID, java.lang.String title)
ID
- the tab IDtitle
- new titlepublic void setTabTitle(Tab tab, java.lang.String title)
tab
- the tabtitle
- new titlepublic void setTabIcon(int tabIndex, java.lang.String iconURL)
tabIndex
- the tab indexiconURL
- new iconpublic void setTabIcon(java.lang.String ID, java.lang.String iconURL)
ID
- the tab IDiconURL
- new iconpublic void setTabIcon(Tab tab, java.lang.String iconURL)
tab
- the tabiconURL
- new iconpublic void enableTab(int tabIndex)
tabIndex
- the tab indexpublic void enableTab(java.lang.String ID)
ID
- the tab idpublic void enableTab(Tab tab)
tab
- the tabpublic void updateTab(int tabIndex, Canvas pane)
tabIndex
- the tab indexpane
- the new pane for the tabpublic void updateTab(Tab tab, Canvas pane)
tab
- the tabpane
- the new pane for the tabpublic void disableTab(int tabIndex)
tabIndex
- the tab indexpublic void disableTab(java.lang.String ID)
ID
- the tab idpublic void disableTab(Tab tab)
tab
- the tabpublic void removeTab(int tabIndex)
The pane associated with the removed tab is automatically destroyed when you call this method.
To avoid this, call updateTab(int, com.smartgwt.client.widgets.Canvas)
with null
as the new
pane immediately before removing the tab.
tabIndex
- the tab indexpublic void removeTab(java.lang.String ID)
The pane associated with the removed tab is automatically destroyed when you call this method.
To avoid this, call updateTab(int, com.smartgwt.client.widgets.Canvas)
with null
as the new
pane immediately before removing the tab.
ID
- the tabIDpublic void removeTab(Tab tab)
The pane associated with the removed tab is automatically destroyed when you call this method.
To avoid this, call updateTab(int, com.smartgwt.client.widgets.Canvas)
with null
as the new
pane immediately before removing the tab.
tab
- the tabpublic void removeTabs(int[] tabIndexes)
tabIndexes
- the tab indexespublic void removeTabs(java.lang.String[] ids)
ids
- the tabIDspublic Tab getSelectedTab()
public StatefulCanvas getTabCanvas(int tabIndex)
getUseSimpleTabs()
.
If this property is false, the returned canvas will be a ImgTab
instance. If true the canvas will be a com.smartgwt.client.widgets.tab.Button
instance.
Note that you can make use of ImgTab APIs by using the getJsObj()
and create()
APIs to "cast" to the appropriate type - for example:ImgTab liveTab = ImgTab.create(myTabSet.getTabCanvas(2).getJsObj());
Note that live Tab instances are not available until BaseWidget.draw()
.
Note that this is an advanced method. The returned Tab is considered an internal component of
the TabSet. In order to maximize forward compatibility, wherever possible manipulate tabs
through TabSet APIs such as a setTabTitle(int, java.lang.String)
instead of
modifying them directly.
tab
- public StatefulCanvas getTabCanvas(java.lang.String ID)
getUseSimpleTabs()
.
If this property is false, the returned canvas will be a ImgTab
instance. If true the canvas will be a com.smartgwt.client.widgets.tab.Button
instance.
Note that you can make use of ImgTab APIs by using the getJsObj()
and create()
APIs to "cast" to the appropriate type - for example:ImgTab liveTab = ImgTab.create(myTabSet.getTabCanvas(2).getJsObj());
Note that live Tab instances are not available until BaseWidget.draw()
.
Note that this is an advanced method. The returned Tab is considered an internal component of
the TabSet. In order to maximize forward compatibility, wherever possible manipulate tabs
through TabSet APIs such as a setTabTitle(int, java.lang.String)
instead of
modifying them directly.
tab
- public Tab getTab(int tabIndex)
index
- of tab to retrievepublic Tab getTab(java.lang.String ID)
ID
- of tab to retrievepublic int getTabNumber(java.lang.String ID)
ID
- the tab IDpublic void addTab(Tab tab)
tab
- new tabpublic void addTab(Tab tab, int position)
tab
- new tabposition
- the position where tab should be addedpublic int getNumTabs()
public void setTitleEditEvent(TabTitleEditEvent titleEditEvent)
titleEditEvent
- titleEditEvent Default value is "doubleClick"setCanEditTabTitles(java.lang.Boolean)
,
Tab.setCanEditTitle(java.lang.Boolean)
public TabTitleEditEvent getTitleEditEvent()
getCanEditTabTitles()
,
Tab.getCanEditTitle()
public void editTabTitle(java.lang.String tab)
canEditTabTitles
or canEditTitle
.tab
- The tab whose title should be edited (may be specified by ID or index)public void editTabTitle(int tab)
canEditTabTitles
or canEditTitle
.tab
- The tab whose title should be edited (may be specified by ID or index)public Tab[] getTabs()
public void setTabBarProperties(TabBar tabBarProperties) throws java.lang.IllegalStateException
tabBar
tabBarProperties
- tabBarProperties Default value is nulljava.lang.IllegalStateException
- this property cannot be changed after the component has been createdpublic void setTabPane(int tabIndex, Canvas pane)
pane
to an existing tab in this tabSettabIndex
- Tab to updatepane
- new Pane for the tab. pass null to drop existing panepublic void setTabPane(java.lang.String tabID, Canvas pane)
pane
to an existing tab in this tabSettabID
- Tab to updatepane
- new Pane for the tab. pass null to drop existing panepublic static void preloadImages()
public void revealChild(java.lang.String childID)
NOTE: This is an override point.
revealChild
in class Canvas
childID
- the global ID of the child Canvas to revealpublic void revealChild(Canvas child)
NOTE: This is an override point.
revealChild
in class Canvas
child
- the child Canvas to revealpublic com.smartgwt.logicalstructure.core.LogicalStructureObject setLogicalStructure(com.smartgwt.logicalstructure.widgets.tab.TabSetLogicalStructure s)
LogicalStructure
interface,
which supports Eclipse's logical structure debugging facility.public com.smartgwt.logicalstructure.core.LogicalStructureObject getLogicalStructure()
LogicalStructure
interface,
which supports Eclipse's logical structure debugging facility.getLogicalStructure
in interface LogicalStructure
getLogicalStructure
in class Canvas