Tabs (Codename One API)

java.lang.Object
- com.codename1.ui.Component
- - com.codename1.ui.Container
  - - com.codename1.ui.Tabs

All Implemented Interfaces:

Animation, Editable, StyleListener, Iterable<Component>
```
public class Tabs
extends Container
```
A component that lets the user switch between a group of components by clicking on a tab with a given title and/or icon.

Tabs/components are added to a Tabs object by using the addTab and insertTab methods. A tab is represented by an index corresponding to the position it was added in, where the first tab has an index equal to 0 and the last tab has an index equal to the tab count minus 1.

The Tabs uses a SingleSelectionModel to represent the set of tab indices and the currently selected index. If the tab count is greater than 0, then there will always be a selected index, which by default will be initialized to the first tab. If the tab count is 0, then the selected index will be -1.

A simple Tabs sample looks a bit like this:
The Tabs allows swiping on the X-axis (by default) but also on the Y-axis (demo video):
A common use case for Tabs is the iOS carousel UI where dots are drawn at the bottom of the form and swiping is used to move between pages:

Constructor Summary

Constructors
Constructor and Description
`Tabs()` Creates an empty `TabbedPane` with a default tab placement of `Component.TOP`.
`Tabs(int tabP)` Creates an empty `TabbedPane` with the specified tab placement of either: `Component.TOP`, `Component.BOTTOM`, `Component.LEFT`, or `Component.RIGHT`.

Method Summary

All Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`void`	`addSelectionListener(SelectionListener listener)` Adds a selection listener to the tabs.
`void`	`addTab(Button tab, Component component)` Deprecated. should use radio button as an argument
`Tabs`	`addTab(String title, char materialIcon, float iconSize, Component component)` Adds a `component` represented by a `title` and/or `icon`, either of which can be `null`.
`Tabs`	`addTab(String title, char icon, Font font, float iconSize, Component component)` Adds a `component` represented by a `title` and/or `icon`, either of which can be `null`.
`void`	`addTab(String title, Component component)` Adds a `component` represented by a `title` and no `icon`.
`void`	`addTab(String title, Image icon, Component component)` Adds a `component` represented by a `title` and/or `icon`, either of which can be `null`.
`Tabs`	`addTab(String title, Image icon, Image pressedIcon, Component component)` Adds a `component` represented by a `title` and/or `icon`, either of which can be `null`.
`void`	`addTabsFocusListener(FocusListener listener)` Deprecated. use addSelectionListener instead
`boolean`	`animate()` Allows the animation to reduce "repaint" calls when it returns false.
`protected void`	`bindTabActionListener(Component tab, ActionListener l)` Binds an action listener to the tab component.
`protected Component`	`createTab(String title, Font font, char icon, float size)` Creates a tab component by default this is a RadioButton but subclasses can use this to return anything
`protected Component`	`createTab(String title, Image icon)` Creates a tab component by default this is a RadioButton but subclasses can use this to return anything
`protected Motion`	`createTabSlideMotion(int start, int end)` Allows developers to customize the motion object for the slide effect to provide a linear slide effect.
`protected void`	`deinitialize()` Invoked to indicate that the component initialization is being reversed since the component was detached from the container hierarchy.
`Container`	`getContentPane()` This method retrieves the Tabs content pane
`String[]`	`getPropertyNames()` A component may expose mutable property names for a UI designer to manipulate, this API is designed for usage internally by the GUI builder code
`String[]`	`getPropertyTypeNames()` This method is here to workaround an XMLVM array type bug where property types aren't identified properly, it returns the names of the types using the following type names: String,int,double,long,byte,short,char,String[],String[][],byte[],Image,Image[],Object[],ListModel,ListCellRenderer
`Class[]`	`getPropertyTypes()` Matches the property names method (see that method for further details).
`Object`	`getPropertyValue(String name)` Returns the current value of the property name, this method is used by the GUI builder
`Component`	`getSelectedComponent()` Returns the component associated with the tab at the given index
`int`	`getSelectedIndex()` Returns the currently selected index for this tabbedpane.
`Component`	`getTabComponentAt(int index)` Returns the tab at `index`.
`int`	`getTabCount()` Returns the number of tabs in this `tabbedpane`.
`protected Image`	`getTabIcon(Component tab)` Returns the icon of the tab component.
`Image`	`getTabIcon(int index)` Returns the icon of the tab at the given index
`int`	`getTabPlacement()` Returns the placement of the tabs for this tabbedpane.
`Container`	`getTabsContainer()` This method retrieves the Tabs buttons Container
`protected Image`	`getTabSelectedIcon(Component tab)` Returns the selected icon of the tab component.
`Image`	`getTabSelectedIcon(int index)` Returns the icon of the tab at the given index
`int`	`getTabTextPosition()` Returns The position of the text relative to the icon
`protected String`	`getTabTitle(Component tab)` Returns the title of the tab component.
`String`	`getTabTitle(int index)` Returns the title of the tab at the given index
`String`	`getTabUIID()` The UIID for a tab component which defaults to Tab
`void`	`hideTabs()` Hide the tabs bar
`int`	`indexOfComponent(Component component)` Returns the index of the tab for the specified component.
`protected void`	`initComponent()` Allows subclasses to bind functionality that relies on fully initialized and "ready for action" component state
`protected void`	`initLaf(UIManager manager)` This method initializes the Component defaults constants
`void`	`insertTab(Component tab, Component component, int index)` Deprecated. should use radio button as an argument
`void`	`insertTab(String title, char icon, Font font, float iconSize, Component component, int index)` Inserts a `component`, at `index`, represented by a `title` and/or `icon`, either of which may be `null`.
`void`	`insertTab(String title, Image icon, Component component, int index)` Inserts a `component`, at `index`, represented by a `title` and/or `icon`, either of which may be `null`.
`boolean`	`isAnimateTabSelection()` Indicates whether clicking on a tab button should result in an animation to the selected tab or an immediate switch
`boolean`	`isChangeTabContainerStyleOnFocus()` Indicates that the tabs container should have its style changed to the selected style when one of the tabs has focus this allows incorporating it into the theme of the application
`boolean`	`isChangeTabOnFocus()` Indicates that a tab should change when the focus changes without the user physically pressing a button
`boolean`	`isEagerSwipeMode()` Allows marking tabs as swipe "eager" which instantly triggers swipe on movement rather than threshold the swipe.
`boolean`	`isSwipeActivated()` Returns true if the swipe between tabs is activated, this is relevant for touch devices only
`boolean`	`isSwipeOnXAxis()` Returns `true` if the swipe is on the X-Axis, `false` if the swipe is on the Y-Axis.
`void`	`refreshTheme(boolean merge)` Makes sure the component is up to date with the current theme, ONLY INVOKE THIS METHOD IF YOU CHANGED THE THEME!
`void`	`removeSelectionListener(SelectionListener listener)` Removes a selection Listener from the tabs
`void`	`removeTabAt(int index)` Removes the tab at `index`.
`void`	`removeTabsFocusListener(FocusListener listener)` Deprecated. use addSelectionListener instead
`protected void`	`selectTab(Component tab)` Invoked to select a specific tab, this method should be overriden for subclasses overriding createTab
`void`	`setAnimateTabSelection(boolean animateTabSelection)` Indicates whether clicking on a tab button should result in an animation to the selected tab or an immediate switch
`void`	`setChangeTabContainerStyleOnFocus(boolean changeTabContainerStyleOnFocus)` Indicates that the tabs container should have its style changed to the selected style when one of the tabs has focus this allows incorporating it into the theme of the application
`void`	`setChangeTabOnFocus(boolean changeTabOnFocus)` Indicates that a tab should change when the focus changes without the user physically pressing a button
`void`	`setEagerSwipeMode(boolean eagerSwipeMode)` Allows marking tabs as swipe "eager" which instantly triggers swipe on movement rather than threshold the swipe.
`String`	`setPropertyValue(String name, Object value)` Sets a new value to the given property, returns an error message if failed and null if successful.
`void`	`setSelectedIndex(int index)` Sets the selected index for this tabbedpane.
`void`	`setSelectedIndex(int index, boolean slideToSelected)` Sets the currently selected index in the tabs component
`void`	`setSwipeActivated(boolean swipeActivated)` Setter method for swipe mode
`void`	`setSwipeOnXAxis(boolean b)` It defaults to `true`; you can set it to `false` for use cases like the one discussed here: Realize a set of Containers that are browsable with a finger, like a deck of cards
`void`	`setTabPlacement(int tabPlacement)` Sets the tab placement for this tabbedpane.
`void`	`setTabsContentGap(int tabsGap)` This method allows setting the Tabs content pane spacing (right and left), This can be used to create an effect where the selected tab is smaller and the right and left tabs are visible on the sides
`protected void`	`setTabSelectedIcon(Component tab, Image icon)` Sets the selected icon of the tab.
`void`	`setTabSelectedIcon(int index, Image icon)` Sets the selected icon of the tab at the given index
`void`	`setTabTextPosition(int textPosition)` Sets the position of the text relative to the icon if exists
`protected void`	`setTabTitle(Component tab, String title, Image icon)` Updates the tabs title .
`void`	`setTabTitle(String title, Image icon, int index)` Updates the information about the tab details
`void`	`setTabUIID(String tabUIID)` The UIID for a tab button which defaults to Tab.
`protected void`	`setTextPosition(Component tabComponent, int textPosition)` Invokes set text position on the given tab, the tab should be a toggle button radio by default but can be anything
`protected boolean`	`shouldBlockSideSwipe()` A component that might need side swipe such as the slider could block it from being used for some other purpose when on top of said component.
`void`	`showTabs()` Show the tabs bar if it was hidden
`String`	`toString()` Overriden to return a useful value for debugging purposes

Methods inherited from class com.codename1.ui.Container
add, add, add, add, add, add, addAll, addComponent, addComponent, addComponent, addComponent, animateHierarchy, animateHierarchyAndWait, animateHierarchyFade, animateHierarchyFadeAndWait, animateLayout, animateLayoutAndWait, animateLayoutFade, animateLayoutFadeAndWait, animateUnlayout, animateUnlayoutAndWait, applyRTL, calcPreferredSize, cancelRepaints, clearClientProperties, constrainHeightWhenScrollable, constrainWidthWhenScrollable, contains, createAnimateHierarchy, createAnimateHierarchyFade, createAnimateLayout, createAnimateLayoutFade, createAnimateLayoutFadeAndWait, createAnimateMotion, createAnimateUnlayout, createReplaceTransition, dragInitiated, drop, encloseIn, encloseIn, findDropTargetAt, findFirstFocusable, fireClicked, flushReplace, forceRevalidate, getBottomGap, getChildrenAsList, getClosestComponentTo, getComponentAt, getComponentAt, getComponentCount, getComponentIndex, getGridPosX, getGridPosY, getLayout, getLayoutHeight, getLayoutWidth, getLeadComponent, getLeadParent, getResponderAt, getSafeAreaRoot, getScrollIncrement, getSideGap, getUIManager, invalidate, isEnabled, isSafeArea, isSafeAreaRoot, isScrollableX, isScrollableY, isSelectableInteraction, isSurface, iterator, iterator, keyPressed, keyReleased, layoutContainer, morph, morphAndWait, paint, paintBackground, paintBorderBackground, paintComponentBackground, paintGlass, paramString, pointerPressed, removeAll, removeComponent, replace, replace, replaceAndWait, replaceAndWait, replaceAndWait, revalidate, revalidateLater, revalidateWithAnimationSafety, scrollComponentToVisible, setCellRenderer, setEnabled, setLayout, setLeadComponent, setSafeArea, setSafeAreaRoot, setScrollable, setScrollableX, setScrollableY, setScrollIncrement, setShouldCalcPreferredSize, setShouldLayout, setUIManager, updateTabIndices

Methods inherited from class com.codename1.ui.Component
addDragFinishedListener, addDragOverListener, addDropListener, addFocusListener, addLongPressListener, addPointerDraggedListener, addPointerPressedListener, addPointerReleasedListener, addPullToRefresh, addScrollListener, addStateChangeListener, bindProperty, blocksSideSwipe, calcScrollSize, contains, containsOrOwns, createStyleAnimation, deinitializeCustomStyle, dragEnter, dragExit, dragFinished, draggingOver, drawDraggedImage, focusGained, focusLost, getAbsoluteX, getAbsoluteY, getAllStyles, getAnimationManager, getBaseline, getBaselineResizeBehavior, getBindablePropertyNames, getBindablePropertyTypes, getBorder, getBoundPropertyValue, getBounds, getBounds, getClientProperty, getCloudBoundProperty, getCloudDestinationProperty, getComponentForm, getComponentState, getCursor, getDefaultDragTransparency, getDirtyRegion, getDisabledStyle, getDraggedx, getDraggedy, getDragImage, getDragRegionStatus, getDragSpeed, getDragTransparency, getEditingDelegate, getHeight, getInlineAllStyles, getInlineDisabledStyles, getInlinePressedStyles, getInlineSelectedStyles, getInlineStylesTheme, getInlineUnselectedStyles, getInnerHeight, getInnerPreferredH, getInnerPreferredW, getInnerWidth, getInnerX, getInnerY, getLabelForComponent, getName, getNativeOverlay, getNextFocusDown, getNextFocusLeft, getNextFocusRight, getNextFocusUp, getOuterHeight, getOuterPreferredH, getOuterPreferredW, getOuterWidth, getOuterX, getOuterY, getOwner, getParent, getPreferredH, getPreferredSize, getPreferredSizeStr, getPreferredTabIndex, getPreferredW, getPressedStyle, getSameHeight, getSameWidth, getScrollable, getScrollAnimationSpeed, getScrollDimension, getScrollOpacity, getScrollOpacityChangeSpeed, getScrollX, getScrollY, getSelectCommandText, getSelectedRect, getSelectedStyle, getStyle, getTabIndex, getTensileLength, getTextSelectionSupport, getTooltip, getUIID, getUnselectedStyle, getVisibleBounds, getVisibleBounds, getWidth, getX, getY, growShrink, handlesInput, hasFixedPreferredSize, hasFocus, hideNativeOverlay, initCustomStyle, initDisabledStyle, initPressedStyle, initSelectedStyle, initUnselectedStyle, installDefaultPainter, isAlwaysTensile, isBlockLead, isCellRenderer, isChildOf, isDragActivated, isDragAndDropOperation, isDraggable, isDragRegion, isDropTarget, isEditable, isEditing, isFlatten, isFocusable, isGrabsPointerEvents, isHidden, isHidden, isHideInLandscape, isHideInPortrait, isIgnorePointerEvents, isInClippingRegion, isInitialized, isOpaque, isOwnedBy, isPinchBlocksDragAndDrop, isRippleEffect, isRTL, isScrollable, isScrollVisible, isSetCursorSupported, isSmoothScrolling, isSnapToGrid, isStickyDrag, isTactileTouch, isTactileTouch, isTensileDragEnabled, isTraversable, isVisible, keyRepeated, laidOut, longKeyPress, longPointerPress, onScrollX, onScrollY, paintBackgrounds, paintBorder, paintComponent, paintComponent, paintIntersectingComponentsAbove, paintLock, paintLockRelease, paintRippleOverlay, paintScrollbars, paintScrollbarX, paintScrollbarY, paintShadows, parsePreferredSize, pinch, pinch, pinchReleased, pointerDragged, pointerDragged, pointerHover, pointerHoverPressed, pointerHoverReleased, pointerPressed, pointerReleased, pointerReleased, putClientProperty, refreshTheme, refreshTheme, remove, removeDragFinishedListener, removeDragOverListener, removeDropListener, removeFocusListener, removeLongPressListener, removePointerDraggedListener, removePointerPressedListener, removePointerReleasedListener, removeScrollListener, removeStateChangeListener, repaint, repaint, requestFocus, resetFocusable, respondsToPointerEvents, scrollRectToVisible, scrollRectToVisible, setAlwaysTensile, setBlockLead, setBoundPropertyValue, setCloudBoundProperty, setCloudDestinationProperty, setComponentState, setCursor, setDefaultDragTransparency, setDirtyRegion, setDisabledStyle, setDraggable, setDragTransparency, setDropTarget, setEditingDelegate, setFlatten, setFocus, setFocusable, setGrabsPointerEvents, setHandlesInput, setHeight, setHidden, setHidden, setHideInLandscape, setHideInPortrait, setIgnorePointerEvents, setInitialized, setInlineAllStyles, setInlineDisabledStyles, setInlinePressedStyles, setInlineSelectedStyles, setInlineStylesTheme, setInlineUnselectedStyles, setIsScrollVisible, setLabelForComponent, setName, setNextFocusDown, setNextFocusLeft, setNextFocusRight, setNextFocusUp, setOpaque, setOwner, setPinchBlocksDragAndDrop, setPreferredH, setPreferredSize, setPreferredSizeStr, setPreferredTabIndex, setPreferredW, setPressedStyle, setRippleEffect, setRTL, setSameHeight, setSameSize, setSameWidth, setScrollAnimationSpeed, setScrollOpacityChangeSpeed, setScrollSize, setScrollVisible, setScrollX, setScrollY, setSelectCommandText, setSelectedStyle, setSize, setSmoothScrolling, setSnapToGrid, setTabIndex, setTactileTouch, setTensileDragEnabled, setTensileLength, setTooltip, setTraversable, setUIID, setUIID, setUnselectedStyle, setVisible, setWidth, setX, setY, shouldBlockSideSwipeLeft, shouldBlockSideSwipeRight, shouldRenderComponentSelection, showNativeOverlay, startEditingAsync, stopEditing, stripMarginAndPadding, styleChanged, toImage, unbindProperty, updateNativeOverlay, visibleBoundsContains

Methods inherited from class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - Tabs
```
public Tabs()
```
    Creates an empty TabbedPane with a default tab placement of Component.TOP.
  - Tabs
```
public Tabs(int tabP)
```
    Creates an empty TabbedPane with the specified tab placement of either: Component.TOP, Component.BOTTOM, Component.LEFT, or Component.RIGHT.
    
    Parameters:
    
    tabP - the placement for the tabs relative to the content
- Method Detail
  - shouldBlockSideSwipe
```
protected boolean shouldBlockSideSwipe()
```
    Description copied from class: Component
    
    A component that might need side swipe such as the slider could block it from being used for some other purpose when on top of said component.
    
    Overrides:
    
    shouldBlockSideSwipe in class Component
  - initLaf
```
protected void initLaf(UIManager manager)
```
    This method initializes the Component defaults constants
    
    Overrides:
    
    initLaf in class Container
  - refreshTheme
```
public void refreshTheme(boolean merge)
```
    Makes sure the component is up to date with the current theme, ONLY INVOKE THIS METHOD IF YOU CHANGED THE THEME!
    
    Overrides:
    
    refreshTheme in class Container
    
    Parameters:
    
    merge - indicates if the current styles should be merged with the new styles
  - deinitialize
```
protected void deinitialize()
```
    Invoked to indicate that the component initialization is being reversed since the component was detached from the container hierarchy. This allows the component to deregister animators and cleanup after itself. This method is the opposite of the initComponent() method.
    
    Overrides:
    
    deinitialize in class Component
  - initComponent
```
protected void initComponent()
```
    Allows subclasses to bind functionality that relies on fully initialized and "ready for action" component state
    
    Overrides:
    
    initComponent in class Component
  - animate
```
public boolean animate()
```
    Allows the animation to reduce "repaint" calls when it returns false. It is called once for every frame. Frames are defined by the Display class.
    
    Specified by:
    
    animate in interface Animation
    
    Overrides:
    
    animate in class Component
    
    Returns:
    
    true if a repaint is desired or false if no repaint is necessary
  - setTabTextPosition
```
public void setTabTextPosition(int textPosition)
```
    Sets the position of the text relative to the icon if exists
    
    Parameters:
    
    textPosition - alignment value (LEFT, RIGHT, BOTTOM or TOP)
    
    See Also:
    
    Component.LEFT, Component.RIGHT, Component.BOTTOM, Component.TOP
  - setTextPosition
```
protected void setTextPosition(Component tabComponent,
                               int textPosition)
```
    Invokes set text position on the given tab, the tab should be a toggle button radio by default but can be anything
    
    Parameters:
    
    tabComponent - the component representing the tab
    
    textPosition - the text position
  - getTabTextPosition
```
public int getTabTextPosition()
```
    Returns The position of the text relative to the icon
    
    Returns:
    
    The position of the text relative to the icon, one of: LEFT, RIGHT, BOTTOM, TOP
    
    See Also:
    
    Component.LEFT, Component.RIGHT, Component.BOTTOM, Component.TOP
  - setTabPlacement
```
public void setTabPlacement(int tabPlacement)
```
    Sets the tab placement for this tabbedpane. Possible values are:
    - Component.TOP
    - Component.BOTTOM
    - Component.LEFT
    - Component.RIGHT
    The default value, if not set, is Component.TOP.
    Parameters:
    
    tabPlacement - the placement for the tabs relative to the content
  - addTab
```
public void addTab(String title,
                   Image icon,
                   Component component)
```
    Adds a component represented by a title and/or icon, either of which can be null. Cover method for insertTab.
    
    Parameters:
    
    title - the title to be displayed in this tab
    
    icon - the icon to be displayed in this tab
    
    component - the component to be displayed when this tab is clicked
    
    See Also:
    
    insertTab(java.lang.String, com.codename1.ui.Image, com.codename1.ui.Component, int), removeTabAt(int)
  - addTab
```
public Tabs addTab(String title,
                   Image icon,
                   Image pressedIcon,
                   Component component)
```
    Adds a component represented by a title and/or icon, either of which can be null. Cover method for insertTab.
    
    Parameters:
    
    title - the title to be displayed in this tab
    
    icon - the icon to be displayed in this tab
    
    pressedIcon - the icon shown when the tab is selected
    
    component - the component to be displayed when this tab is clicked
    
    Returns:
    
    this so these calls can be chained
    
    See Also:
    
    insertTab(java.lang.String, com.codename1.ui.Image, com.codename1.ui.Component, int), removeTabAt(int)
  - addTab
```
public Tabs addTab(String title,
                   char materialIcon,
                   float iconSize,
                   Component component)
```
    Adds a component represented by a title and/or icon, either of which can be null. Cover method for insertTab.
    
    Parameters:
    
    title - the title to be displayed in this tab
    
    materialIcon - one of the material design icon constants from FontImage
    
    iconSize - icon size in millimeters
    
    component - the component to be displayed when this tab is clicked
    
    Returns:
    
    this so these calls can be chained
    
    See Also:
    
    insertTab(java.lang.String, com.codename1.ui.Image, com.codename1.ui.Component, int), removeTabAt(int)
  - addTab
```
public Tabs addTab(String title,
                   char icon,
                   Font font,
                   float iconSize,
                   Component component)
```
    Adds a component represented by a title and/or icon, either of which can be null. Cover method for insertTab.
    
    Parameters:
    
    title - the title to be displayed in this tab
    
    icon - an icon from the font
    
    font - the font for the icon
    
    iconSize - icon size in millimeters
    
    component - the component to be displayed when this tab is clicked
    
    Returns:
    
    this so these calls can be chained
    
    See Also:
    
    insertTab(java.lang.String, com.codename1.ui.Image, com.codename1.ui.Component, int), removeTabAt(int)
  - addTab
```
public void addTab(String title,
                   Component component)
```
    Adds a component represented by a title and no icon. Cover method for insertTab.
    
    Parameters:
    
    title - the title to be displayed in this tab
    
    component - the component to be displayed when this tab is clicked
    
    See Also:
    
    insertTab(java.lang.String, com.codename1.ui.Image, com.codename1.ui.Component, int), removeTabAt(int)
  - addTab
```
public void addTab(Button tab,
                   Component component)
```
    Deprecated. should use radio button as an argument
    
    Adds a component represented by a button. Cover method for insertTab. The Button styling will be associated with "Tab" UIID.
    
    Parameters:
    
    tab - represents the tab on top
    
    component - the component to be displayed when this tab is clicked
    
    See Also:
    
    insertTab(java.lang.String, com.codename1.ui.Image, com.codename1.ui.Component, int), removeTabAt(int)
  - createTab
```
protected Component createTab(String title,
                              Font font,
                              char icon,
                              float size)
```
    Creates a tab component by default this is a RadioButton but subclasses can use this to return anything
    
    Parameters:
    
    title - the title of the tab
    
    icon - an icon from the font
    
    font - the font for the icon
    
    Returns:
    
    component instance
  - createTab
```
protected Component createTab(String title,
                              Image icon)
```
    Creates a tab component by default this is a RadioButton but subclasses can use this to return anything
    
    Parameters:
    
    title - the title of the tab
    
    icon - the icon of the tab
    
    Returns:
    
    component instance
  - insertTab
```
public void insertTab(String title,
                      Image icon,
                      Component component,
                      int index)
```
    Inserts a component, at index, represented by a title and/or icon, either of which may be null. Uses java.util.Vector internally, see insertElementAt for details of insertion conventions.
    
    Parameters:
    
    title - the title to be displayed in this tab
    
    icon - the icon to be displayed in this tab
    
    component - The component to be displayed when this tab is clicked.
    
    index - the position to insert this new tab
    
    See Also:
    
    addTab(java.lang.String, com.codename1.ui.Image, com.codename1.ui.Component), removeTabAt(int)
  - insertTab
```
public void insertTab(String title,
                      char icon,
                      Font font,
                      float iconSize,
                      Component component,
                      int index)
```
    Inserts a component, at index, represented by a title and/or icon, either of which may be null. Uses java.util.Vector internally, see insertElementAt for details of insertion conventions.
    
    Parameters:
    
    title - the title to be displayed in this tab
    
    icon - an icon from the font
    
    font - the font for the icon
    
    component - The component to be displayed when this tab is clicked.
    
    index - the position to insert this new tab
    
    See Also:
    
    addTab(java.lang.String, com.codename1.ui.Image, com.codename1.ui.Component), removeTabAt(int)
  - insertTab
```
public void insertTab(Component tab,
                      Component component,
                      int index)
```
    Deprecated. should use radio button as an argument
    
    Inserts a component, at index, represented by a button Uses java.util.Vector internally, see insertElementAt for details of insertion conventions. The Button styling will be associated with "Tab" UIID.
    
    Parameters:
    
    tab - represents the tab on top
    
    component - The component to be displayed when this tab is clicked.
    
    index - the position to insert this new tab
    
    See Also:
    
    addTab(java.lang.String, com.codename1.ui.Image, com.codename1.ui.Component), removeTabAt(int)
  - bindTabActionListener
```
protected void bindTabActionListener(Component tab,
                                     ActionListener l)
```
    Binds an action listener to the tab component. this method should be used when overriding createTab
    
    Parameters:
    
    tab - the tab component
    
    l - the listener
  - setTabTitle
```
public void setTabTitle(String title,
                        Image icon,
                        int index)
```
    Updates the information about the tab details
    
    Parameters:
    
    title - the title to be displayed in this tab
    
    icon - the icon to be displayed in this tab
    
    index - the position to insert this new tab
  - setTabTitle
```
protected void setTabTitle(Component tab,
                           String title,
                           Image icon)
```
    Updates the tabs title . This method should be used when overriding createTab
    
    Parameters:
    
    tab - the tab component
    
    title - the title
    
    icon - the new icon
  - getTabTitle
```
public String getTabTitle(int index)
```
    Returns the title of the tab at the given index
    
    Parameters:
    
    index - index for the tab
    
    Returns:
    
    label of the tab at the given index
  - getTabTitle
```
protected String getTabTitle(Component tab)
```
    Returns the title of the tab component. This method should be used when overriding createTab
    
    Parameters:
    
    tab - the tab component
    
    Returns:
    
    label of the tab
  - getTabIcon
```
protected Image getTabIcon(Component tab)
```
    Returns the icon of the tab component. This method should be used when overriding createTab
    
    Parameters:
    
    tab - the tab component
    
    Returns:
    
    icon of the tab
  - getTabIcon
```
public Image getTabIcon(int index)
```
    Returns the icon of the tab at the given index
    
    Parameters:
    
    index - index for the tab
    
    Returns:
    
    icon of the tab at the given index
  - getTabSelectedIcon
```
protected Image getTabSelectedIcon(Component tab)
```
    Returns the selected icon of the tab component. This method should be used when overriding createTab
    
    Parameters:
    
    tab - the tab component
    
    Returns:
    
    icon of the tab
  - getTabSelectedIcon
```
public Image getTabSelectedIcon(int index)
```
    Returns the icon of the tab at the given index
    
    Parameters:
    
    index - index for the tab
    
    Returns:
    
    icon of the tab at the given index
  - setTabSelectedIcon
```
public void setTabSelectedIcon(int index,
                               Image icon)
```
    Sets the selected icon of the tab at the given index
    
    Parameters:
    
    index - index for the tab
    
    icon - of the tab at the given index
  - setTabSelectedIcon
```
protected void setTabSelectedIcon(Component tab,
                                  Image icon)
```
    Sets the selected icon of the tab. This method should be used when overriding createTab
    
    Parameters:
    
    tab - the tab component
    
    icon - of the tab
  - removeTabAt
```
public void removeTabAt(int index)
```
    Removes the tab at index. After the component associated with index is removed, its visibility is reset to true to ensure it will be visible if added to other containers.
    
    Parameters:
    
    index - the index of the tab to be removed
    
    Throws:
    
    IndexOutOfBoundsException - if index is out of range (index < 0 || index >= tab count)
    
    See Also:
    
    addTab(java.lang.String, com.codename1.ui.Image, com.codename1.ui.Component), insertTab(java.lang.String, com.codename1.ui.Image, com.codename1.ui.Component, int)
  - getTabComponentAt
```
public Component getTabComponentAt(int index)
```
    Returns the tab at index.
    
    Parameters:
    
    index - the index of the tab to be removed
    
    Returns:
    
    the component at the given tab location
    
    Throws:
    
    IndexOutOfBoundsException - if index is out of range (index < 0 || index >= tab count)
    
    See Also:
    
    addTab(java.lang.String, com.codename1.ui.Image, com.codename1.ui.Component), insertTab(java.lang.String, com.codename1.ui.Image, com.codename1.ui.Component, int)
  - indexOfComponent
```
public int indexOfComponent(Component component)
```
    Returns the index of the tab for the specified component. Returns -1 if there is no tab for this component.
    
    Parameters:
    
    component - the component for the tab
    
    Returns:
    
    the first tab which matches this component, or -1 if there is no tab for this component
  - getTabCount
```
public int getTabCount()
```
    Returns the number of tabs in this tabbedpane.
    
    Returns:
    
    an integer specifying the number of tabbed pages
  - getSelectedIndex
```
public int getSelectedIndex()
```
    Returns the currently selected index for this tabbedpane. Returns -1 if there is no currently selected tab.
    
    Returns:
    
    the index of the selected tab
  - getSelectedComponent
```
public Component getSelectedComponent()
```
    Returns the component associated with the tab at the given index
    
    Returns:
    
    the component is now showing in the tabbed pane
  - addTabsFocusListener
```
public void addTabsFocusListener(FocusListener listener)
```
    Deprecated. use addSelectionListener instead
    
    Adds a focus listener to the tabs buttons
    
    Parameters:
    
    listener - FocusListener
  - removeTabsFocusListener
```
public void removeTabsFocusListener(FocusListener listener)
```
    Deprecated. use addSelectionListener instead
    
    Removes a foucs Listener from the tabs buttons
    
    Parameters:
    
    listener - FocusListener
  - addSelectionListener
```
public void addSelectionListener(SelectionListener listener)
```
    Adds a selection listener to the tabs.
    
    Parameters:
    
    listener - SelectionListener
  - removeSelectionListener
```
public void removeSelectionListener(SelectionListener listener)
```
    Removes a selection Listener from the tabs
    
    Parameters:
    
    listener - SelectionListener
  - toString
```
public String toString()
```
    Overriden to return a useful value for debugging purposes
    
    Overrides:
    
    toString in class Component
    
    Returns:
    
    a string representation of this component
  - getTabPlacement
```
public int getTabPlacement()
```
    Returns the placement of the tabs for this tabbedpane.
    
    Returns:
    
    the tab placement value
    
    See Also:
    
    setTabPlacement(int)
  - getContentPane
```
public Container getContentPane()
```
    This method retrieves the Tabs content pane
    
    Returns:
    
    the content pane Container
  - getTabsContainer
```
public Container getTabsContainer()
```
    This method retrieves the Tabs buttons Container
    
    Returns:
    
    the Tabs Container
  - setSelectedIndex
```
public void setSelectedIndex(int index,
                             boolean slideToSelected)
```
    Sets the currently selected index in the tabs component
    
    Parameters:
    
    index - the index for the tab starting with tab 0.
    
    slideToSelected - true to animate the transition to the new selection false to just move immediately
  - selectTab
```
protected void selectTab(Component tab)
```
    Invoked to select a specific tab, this method should be overriden for subclasses overriding createTab
    
    Parameters:
    
    tab - the tab
  - setSelectedIndex
```
public void setSelectedIndex(int index)
```
    Sets the selected index for this tabbedpane. The index must be a valid tab index.
    
    Parameters:
    
    index - the index to be selected
    
    Throws:
    
    IndexOutOfBoundsException - if index is out of range (index < 0 || index >= tab count)
  - hideTabs
```
public void hideTabs()
```
    Hide the tabs bar
  - showTabs
```
public void showTabs()
```
    Show the tabs bar if it was hidden
  - isSwipeActivated
```
public boolean isSwipeActivated()
```
    Returns true if the swipe between tabs is activated, this is relevant for touch devices only
    
    Returns:
    
    swipe activated flag
  - setSwipeActivated
```
public void setSwipeActivated(boolean swipeActivated)
```
    Setter method for swipe mode
    
    Parameters:
    
    swipeActivated -
  - isChangeTabOnFocus
```
public boolean isChangeTabOnFocus()
```
    Indicates that a tab should change when the focus changes without the user physically pressing a button
    
    Returns:
    
    the changeTabOnFocus
  - setChangeTabOnFocus
```
public void setChangeTabOnFocus(boolean changeTabOnFocus)
```
    Indicates that a tab should change when the focus changes without the user physically pressing a button
    
    Parameters:
    
    changeTabOnFocus - the changeTabOnFocus to set
  - isChangeTabContainerStyleOnFocus
```
public boolean isChangeTabContainerStyleOnFocus()
```
    Indicates that the tabs container should have its style changed to the selected style when one of the tabs has focus this allows incorporating it into the theme of the application
    
    Returns:
    
    the changeTabContainerStyleOnFocus
  - setChangeTabContainerStyleOnFocus
```
public void setChangeTabContainerStyleOnFocus(boolean changeTabContainerStyleOnFocus)
```
    Indicates that the tabs container should have its style changed to the selected style when one of the tabs has focus this allows incorporating it into the theme of the application
    
    Parameters:
    
    changeTabContainerStyleOnFocus - the changeTabContainerStyleOnFocus to set
  - setTabsContentGap
```
public void setTabsContentGap(int tabsGap)
```
    This method allows setting the Tabs content pane spacing (right and left), This can be used to create an effect where the selected tab is smaller and the right and left tabs are visible on the sides
    
    Parameters:
    
    tabsGap - the gap on the sides of the content in pixels, the value must be positive.
  - getTabUIID
```
public String getTabUIID()
```
    The UIID for a tab component which defaults to Tab
    
    Returns:
    
    the tabUIID
  - setTabUIID
```
public void setTabUIID(String tabUIID)
```
    The UIID for a tab button which defaults to Tab. Tab buttons used to have two separate styles for selected and unselected. This was later consolidated so the tabs behave as a single toggle button (radio button) however one thing that remained is a call to setUIID that is implicitly made to restore the original "Tab" style.
    
    Effectively Tabs invokes the setUIID call on the Tab switch so if you want to manipulate the tab UIID manually (have one red and one green tab) this is a problem..
    To enable such code add all the tabs then just just invoke setTabUIID(null) to disable this behavior.
    
    Parameters:
    
    tabUIID - the tabUIID to set
  - isEagerSwipeMode
```
public boolean isEagerSwipeMode()
```
    Allows marking tabs as swipe "eager" which instantly triggers swipe on movement rather than threshold the swipe.
    
    Returns:
    
    the eagerSwipeMode
  - setEagerSwipeMode
```
public void setEagerSwipeMode(boolean eagerSwipeMode)
```
    Allows marking tabs as swipe "eager" which instantly triggers swipe on movement rather than threshold the swipe.
    
    Parameters:
    
    eagerSwipeMode - the eagerSwipeMode to set
  - isAnimateTabSelection
```
public boolean isAnimateTabSelection()
```
    Indicates whether clicking on a tab button should result in an animation to the selected tab or an immediate switch
    
    Returns:
    
    the animateTabSelection
  - setAnimateTabSelection
```
public void setAnimateTabSelection(boolean animateTabSelection)
```
    Indicates whether clicking on a tab button should result in an animation to the selected tab or an immediate switch
    
    Parameters:
    
    animateTabSelection - the animateTabSelection to set
  - createTabSlideMotion
```
protected Motion createTabSlideMotion(int start,
                                      int end)
```
    Allows developers to customize the motion object for the slide effect to provide a linear slide effect. You can use the tabsSlideSpeedInt theme constant to define the time in milliseconds between releasing the swiped tab and reaching the next tab. This currently defaults to 200.
    
    Parameters:
    
    start - start position
    
    end - end position for the motion
    
    Returns:
    
    the motion object
  - setSwipeOnXAxis
```
public void setSwipeOnXAxis(boolean b)
```
    It defaults to true; you can set it to false for use cases like the one discussed here: Realize a set of Containers that are browsable with a finger, like a deck of cards
    Example of usage (demo video):
    
    Parameters:
    
    b - true to set the swipe on the X-Axis, false to set the swipe on the Y-Axis
    
    Since:
    
    8.0
  - isSwipeOnXAxis
```
public boolean isSwipeOnXAxis()
```
    Returns true if the swipe is on the X-Axis, false if the swipe is on the Y-Axis.
    
    Returns:
    
    swipe direction flag
  - getPropertyNames
```
public String[] getPropertyNames()
```
    A component may expose mutable property names for a UI designer to manipulate, this API is designed for usage internally by the GUI builder code
    
    Overrides:
    
    getPropertyNames in class Component
    
    Returns:
    
    the property names allowing mutation
  - getPropertyTypes
```
public Class[] getPropertyTypes()
```
    Matches the property names method (see that method for further details).
    
    Overrides:
    
    getPropertyTypes in class Component
    
    Returns:
    
    the types of the properties
  - getPropertyTypeNames
```
public String[] getPropertyTypeNames()
```
    This method is here to workaround an XMLVM array type bug where property types aren't identified properly, it returns the names of the types using the following type names: String,int,double,long,byte,short,char,String[],String[][],byte[],Image,Image[],Object[],ListModel,ListCellRenderer
    
    Overrides:
    
    getPropertyTypeNames in class Component
    
    Returns:
    
    Array of type names
  - getPropertyValue
```
public Object getPropertyValue(String name)
```
    Returns the current value of the property name, this method is used by the GUI builder
    
    Overrides:
    
    getPropertyValue in class Component
    
    Parameters:
    
    name - the name of the property
    
    Returns:
    
    the value of said property
  - setPropertyValue
```
public String setPropertyValue(String name,
                               Object value)
```
    Sets a new value to the given property, returns an error message if failed and null if successful. Notice that some builtin properties such as "$designMode" might be sent to components to indicate application state.
    
    Overrides:
    
    setPropertyValue in class Component
    
    Parameters:
    
    name - the name of the property
    
    value - new value for the property
    
    Returns:
    
    error message or null

Class Tabs

Field Summary

Fields inherited from class com.codename1.ui.Component

Constructor Summary

Method Summary

Methods inherited from class com.codename1.ui.Container

Methods inherited from class com.codename1.ui.Component

Methods inherited from class java.lang.Object

Constructor Detail

Tabs

Tabs

Method Detail

shouldBlockSideSwipe

initLaf

refreshTheme

deinitialize

initComponent

animate

setTabTextPosition

setTextPosition

getTabTextPosition

setTabPlacement

addTab

addTab

addTab

addTab

addTab

addTab

createTab

createTab

insertTab

insertTab

insertTab

bindTabActionListener

setTabTitle

setTabTitle

getTabTitle

getTabTitle

getTabIcon

getTabIcon

getTabSelectedIcon

getTabSelectedIcon

setTabSelectedIcon

setTabSelectedIcon

removeTabAt

getTabComponentAt

indexOfComponent

getTabCount

getSelectedIndex

getSelectedComponent

addTabsFocusListener

removeTabsFocusListener

addSelectionListener

removeSelectionListener

toString

getTabPlacement

getContentPane

getTabsContainer

setSelectedIndex

selectTab

setSelectedIndex

hideTabs

showTabs

isSwipeActivated

setSwipeActivated

isChangeTabOnFocus

setChangeTabOnFocus

isChangeTabContainerStyleOnFocus

setChangeTabContainerStyleOnFocus

setTabsContentGap

getTabUIID

setTabUIID

isEagerSwipeMode

setEagerSwipeMode

isAnimateTabSelection

setAnimateTabSelection

createTabSlideMotion

setSwipeOnXAxis

isSwipeOnXAxis

getPropertyNames