javax.swing.plaf.metal

Class MetalTabbedPaneUI

Implemented Interfaces:
SwingConstants

public class MetalTabbedPaneUI
extends BasicTabbedPaneUI

A UI delegate for the JTabbedPane component.

Nested Class Summary

class
MetalTabbedPaneUI.TabbedPaneLayout
A LayoutManager responsible for placing all the tabs and the visible component inside the JTabbedPane.

Nested classes/interfaces inherited from class javax.swing.plaf.basic.BasicTabbedPaneUI

BasicTabbedPaneUI.FocusHandler, BasicTabbedPaneUI.MouseHandler, BasicTabbedPaneUI.PropertyChangeHandler, BasicTabbedPaneUI.TabbedPaneLayout, BasicTabbedPaneUI.TabSelectionHandler

Field Summary

protected int
minTabWidth
The minimum tab width.
protected Color
selectColor
The color for the selected tab.
protected Color
selectHighlight
The color for a highlighted selected tab.
protected Color
tabAreaBackground
The background color used for the tab area.

Fields inherited from class javax.swing.plaf.basic.BasicTabbedPaneUI

calcRect, contentBorderInsets, darkShadow, downKey, focus, focusListener, highlight, leftKey, lightHighlight, maxTabHeight, maxTabWidth, mouseListener, propertyChangeListener, rects, rightKey, runCount, selectedRun, selectedTabPadInsets, shadow, tabAreaInsets, tabChangeListener, tabInsets, tabPane, tabRunOverlay, tabRuns, textIconGap, upKey

Fields inherited from interface javax.swing.SwingConstants

BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST

Constructor Summary

MetalTabbedPaneUI()
Constructs a new instance of MetalTabbedPaneUI.

Method Summary

protected int
calculateMaxTabHeight(int tabPlacement)
This method returns the max tab height.
protected LayoutManager
createLayoutManager()
Creates and returns an instance of MetalTabbedPaneUI.TabbedPaneLayout.
static ComponentUI
createUI(JComponent component)
Returns an instance of MetalTabbedPaneUI.
protected Color
getColorForGap(int currentRun, int x, int y)
Returns the color for the gap.
protected int
getTabLabelShiftX(int tabPlacement, int index, boolean isSelected)
This method returns how much the label for the tab should shift in the X direction.
protected int
getTabLabelShiftY(int tabPlacement, int index, boolean isSelected)
This method returns how much the label for the tab should shift in the Y direction.
protected int
getTabRunOverlay(int tabPlacement)
Returns the amount of overlay among the tabs.
protected void
installDefaults()
Installs the defaults for this UI.
protected void
paintBottomTabBorder(int tabIndex, Graphics g, int x, int y, int w, int h, int btm, int rght, boolean isSelected)
Paints the border for a tab assuming that the tab position is at the bottom (SwingConstants.BOTTOM).
protected void
paintContentBorderBottomEdge(Graphics g, int tabPlacement, int selectedIndex, int x, int y, int w, int h)
Paints the lower edge of the content border.
protected void
paintContentBorderLeftEdge(Graphics g, int tabPlacement, int selectedIndex, int x, int y, int w, int h)
Paints the left edge of the content border.
protected void
paintContentBorderRightEdge(Graphics g, int tabPlacement, int selectedIndex, int x, int y, int w, int h)
Paints the right edge of the content border.
protected void
paintContentBorderTopEdge(Graphics g, int tabPlacement, int selectedIndex, int x, int y, int w, int h)
Paints the upper edge of the content border.
protected void
paintFocusIndicator(Graphics g, int tabPlacement, Rectangle[] rects, int tabIndex, Rectangle iconRect, Rectangle textRect, boolean isSelected)
This method paints the focus rectangle around the selected tab.
protected void
paintHighlightBelowTab()
Paints the highlight below the tab, if there is one.
protected void
paintLeftTabBorder(int tabIndex, Graphics g, int x, int y, int w, int h, int btm, int rght, boolean isSelected)
Paints the border for a tab assuming that the tab position is at the left (SwingConstants.LEFT).
protected void
paintRightTabBorder(int tabIndex, Graphics g, int x, int y, int w, int h, int btm, int rght, boolean isSelected)
Paints the border for a tab assuming that the tab position is at the right (SwingConstants.RIGHT).
protected void
paintTabBackground(Graphics g, int tabPlacement, int tabIndex, int x, int y, int w, int h, boolean isSelected)
Paints the background for a tab.
protected void
paintTabBorder(Graphics g, int tabPlacement, int tabIndex, int x, int y, int w, int h, boolean isSelected)
Paints the border for a single tab.
protected void
paintTopTabBorder(int tabIndex, Graphics g, int x, int y, int w, int h, int btm, int rght, boolean isSelected)
Paints the border for a tab assuming that the tab position is at the top (SwingConstants.TOP).
protected boolean
shouldFillGap(int currentRun, int tabIndex, int x, int y)
Returns true if the gap should be filled in.
protected boolean
shouldPadTabRun(int tabPlacement, int run)
Returns true if the tabs in the specified run should be padded to make the run fill the width/height of the JTabbedPane.
protected boolean
shouldRotateTabRuns(int tabPlacement, int selectedRun)
Returns true if we should rotate the tab runs.

Methods inherited from class javax.swing.plaf.basic.BasicTabbedPaneUI

assureRectsCreated, calculateMaxTabHeight, calculateMaxTabWidth, calculateTabAreaHeight, calculateTabAreaWidth, calculateTabHeight, calculateTabWidth, createChangeListener, createFocusListener, createLayoutManager, createMouseListener, createPropertyChangeListener, createUI, expandTabRunsArray, getContentBorderInsets, getFontMetrics, getIconForTab, getMaximumSize, getMinimumSize, getNextTabIndex, getNextTabIndexInRun, getNextTabRun, getPreviousTabIndex, getPreviousTabIndexInRun, getPreviousTabRun, getRolloverTab, getRunForTab, getSelectedTabPadInsets, getTabAreaInsets, getTabBounds, getTabBounds, getTabInsets, getTabLabelShiftX, getTabLabelShiftY, getTabRunCount, getTabRunIndent, getTabRunOffset, getTabRunOverlay, getTextViewForTab, getVisibleComponent, installComponents, installDefaults, installKeyboardActions, installListeners, installUI, lastTabInRun, layoutLabel, navigateSelectedTab, paint, paintContentBorder, paintContentBorderBottomEdge, paintContentBorderLeftEdge, paintContentBorderRightEdge, paintContentBorderTopEdge, paintFocusIndicator, paintIcon, paintTab, paintTabArea, paintTabBackground, paintTabBorder, paintText, rotateInsets, selectAdjacentRunTab, selectNextTab, selectNextTabInRun, selectPreviousTab, selectPreviousTabInRun, setRolloverTab, setVisibleComponent, shouldPadTabRun, shouldRotateTabRuns, tabForCoordinate, uninstallComponents, uninstallDefaults, uninstallKeyboardActions, uninstallListeners, uninstallUI

Methods inherited from class javax.swing.plaf.TabbedPaneUI

getTabBounds, getTabRunCount, tabForCoordinate

Methods inherited from class javax.swing.plaf.ComponentUI

contains, createUI, getAccessibleChild, getAccessibleChildrenCount, getMaximumSize, getMinimumSize, getPreferredSize, installUI, paint, uninstallUI, update

Methods inherited from class java.lang.Object

clone, equals, extends Object> getClass, finalize, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

minTabWidth

protected int minTabWidth
The minimum tab width.

selectColor

protected Color selectColor
The color for the selected tab.

selectHighlight

protected Color selectHighlight
The color for a highlighted selected tab.

tabAreaBackground

protected Color tabAreaBackground
The background color used for the tab area.

Constructor Details

MetalTabbedPaneUI

public MetalTabbedPaneUI()
Constructs a new instance of MetalTabbedPaneUI.

Method Details

calculateMaxTabHeight

protected int calculateMaxTabHeight(int tabPlacement)
This method returns the max tab height.
Overrides:
calculateMaxTabHeight in interface BasicTabbedPaneUI
Parameters:
tabPlacement - The JTabbedPane's tab placement.
Returns:
The maximum tab height.

createLayoutManager

protected LayoutManager createLayoutManager()
Creates and returns an instance of MetalTabbedPaneUI.TabbedPaneLayout.
Overrides:
createLayoutManager in interface BasicTabbedPaneUI
Returns:
A layout manager used by this UI delegate.

createUI

public static ComponentUI createUI(JComponent component)
Returns an instance of MetalTabbedPaneUI.
Overrides:
createUI in interface BasicTabbedPaneUI
Parameters:
component - the component for which we return an UI instance
Returns:
an instance of MetalTabbedPaneUI

getColorForGap

protected Color getColorForGap(int currentRun,
                               int x,
                               int y)
Returns the color for the gap.
Parameters:
currentRun - - The current run to return the color for
x - - The x position of the current run
y - - The y position of the current run
Returns:
the color for the gap in the current run.

getTabLabelShiftX

protected int getTabLabelShiftX(int tabPlacement,
                                int index,
                                boolean isSelected)
This method returns how much the label for the tab should shift in the X direction.
Overrides:
getTabLabelShiftX in interface BasicTabbedPaneUI
Parameters:
tabPlacement - The JTabbedPane's tab placement.
isSelected - Whether this tab is selected.
Returns:
The amount the label should shift by in the X direction.

getTabLabelShiftY

protected int getTabLabelShiftY(int tabPlacement,
                                int index,
                                boolean isSelected)
This method returns how much the label for the tab should shift in the Y direction.
Overrides:
getTabLabelShiftY in interface BasicTabbedPaneUI
Parameters:
tabPlacement - The JTabbedPane's tab placement.
isSelected - Whether this tab is selected.
Returns:
The amount the label should shift by in the Y direction.

getTabRunOverlay

protected int getTabRunOverlay(int tabPlacement)
Returns the amount of overlay among the tabs. In the Metal L&F the overlay for LEFT and RIGHT placement is half of the maxTabHeight. For TOP and BOTTOM placement the tabs do not overlay.
Overrides:
getTabRunOverlay in interface BasicTabbedPaneUI
Parameters:
tabPlacement - the placement
Returns:
the amount of overlay among the tabs

installDefaults

protected void installDefaults()
Installs the defaults for this UI. This method calls super.installDefaults and then loads the Metal specific defaults for TabbedPane.
Overrides:
installDefaults in interface BasicTabbedPaneUI

paintBottomTabBorder

protected void paintBottomTabBorder(int tabIndex,
                                    Graphics g,
                                    int x,
                                    int y,
                                    int w,
                                    int h,
                                    int btm,
                                    int rght,
                                    boolean isSelected)
Paints the border for a tab assuming that the tab position is at the bottom (SwingConstants.BOTTOM).
Parameters:
tabIndex - the tab index.
g - the graphics device.
x - the x-coordinate for the tab's bounding rectangle.
y - the y-coordinate for the tab's bounding rectangle.
w - the width for the tab's bounding rectangle.
h - the height for the tab's bounding rectangle.
btm - ???
rght - ???
isSelected - indicates whether the tab is selected.

paintContentBorderBottomEdge

protected void paintContentBorderBottomEdge(Graphics g,
                                            int tabPlacement,
                                            int selectedIndex,
                                            int x,
                                            int y,
                                            int w,
                                            int h)
Paints the lower edge of the content border.
Overrides:
paintContentBorderBottomEdge in interface BasicTabbedPaneUI
Parameters:
g - the graphics to use for painting
tabPlacement - the tab placement
selectedIndex - the index of the selected tab
x - the upper left coordinate of the content area
y - the upper left coordinate of the content area
w - the width of the content area
h - the height of the content area

paintContentBorderLeftEdge

protected void paintContentBorderLeftEdge(Graphics g,
                                          int tabPlacement,
                                          int selectedIndex,
                                          int x,
                                          int y,
                                          int w,
                                          int h)
Paints the left edge of the content border.
Overrides:
paintContentBorderLeftEdge in interface BasicTabbedPaneUI
Parameters:
g - the graphics to use for painting
tabPlacement - the tab placement
selectedIndex - the index of the selected tab
x - the upper left coordinate of the content area
y - the upper left coordinate of the content area
w - the width of the content area
h - the height of the content area

paintContentBorderRightEdge

protected void paintContentBorderRightEdge(Graphics g,
                                           int tabPlacement,
                                           int selectedIndex,
                                           int x,
                                           int y,
                                           int w,
                                           int h)
Paints the right edge of the content border.
Overrides:
paintContentBorderRightEdge in interface BasicTabbedPaneUI
Parameters:
g - the graphics to use for painting
tabPlacement - the tab placement
selectedIndex - the index of the selected tab
x - the upper left coordinate of the content area
y - the upper left coordinate of the content area
w - the width of the content area
h - the height of the content area

paintContentBorderTopEdge

protected void paintContentBorderTopEdge(Graphics g,
                                         int tabPlacement,
                                         int selectedIndex,
                                         int x,
                                         int y,
                                         int w,
                                         int h)
Paints the upper edge of the content border.
Overrides:
paintContentBorderTopEdge in interface BasicTabbedPaneUI
Parameters:
g - the graphics to use for painting
tabPlacement - the tab placement
selectedIndex - the index of the selected tab
x - the upper left coordinate of the content area
y - the upper left coordinate of the content area
w - the width of the content area
h - the height of the content area

paintFocusIndicator

protected void paintFocusIndicator(Graphics g,
                                   int tabPlacement,
                                   Rectangle[] rects,
                                   int tabIndex,
                                   Rectangle iconRect,
                                   Rectangle textRect,
                                   boolean isSelected)
This method paints the focus rectangle around the selected tab.
Overrides:
paintFocusIndicator in interface BasicTabbedPaneUI
Parameters:
g - The Graphics object to paint with.
tabPlacement - The JTabbedPane's tab placement.
rects - The array of rectangles keeping track of size and position.
tabIndex - The tab index.
iconRect - The icon bounds.
textRect - The text bounds.
isSelected - Whether this tab is selected.

paintHighlightBelowTab

protected void paintHighlightBelowTab()
Paints the highlight below the tab, if there is one.

paintLeftTabBorder

protected void paintLeftTabBorder(int tabIndex,
                                  Graphics g,
                                  int x,
                                  int y,
                                  int w,
                                  int h,
                                  int btm,
                                  int rght,
                                  boolean isSelected)
Paints the border for a tab assuming that the tab position is at the left (SwingConstants.LEFT).
Parameters:
tabIndex - the tab index.
g - the graphics device.
x - the x-coordinate for the tab's bounding rectangle.
y - the y-coordinate for the tab's bounding rectangle.
w - the width for the tab's bounding rectangle.
h - the height for the tab's bounding rectangle.
btm - ???
rght - ???
isSelected - indicates whether the tab is selected.

paintRightTabBorder

protected void paintRightTabBorder(int tabIndex,
                                   Graphics g,
                                   int x,
                                   int y,
                                   int w,
                                   int h,
                                   int btm,
                                   int rght,
                                   boolean isSelected)
Paints the border for a tab assuming that the tab position is at the right (SwingConstants.RIGHT).
Parameters:
tabIndex - the tab index.
g - the graphics device.
x - the x-coordinate for the tab's bounding rectangle.
y - the y-coordinate for the tab's bounding rectangle.
w - the width for the tab's bounding rectangle.
h - the height for the tab's bounding rectangle.
btm - ???
rght - ???
isSelected - indicates whether the tab is selected.

paintTabBackground

protected void paintTabBackground(Graphics g,
                                  int tabPlacement,
                                  int tabIndex,
                                  int x,
                                  int y,
                                  int w,
                                  int h,
                                  boolean isSelected)
Paints the background for a tab.
Overrides:
paintTabBackground in interface BasicTabbedPaneUI
Parameters:
g - the graphics device.
tabPlacement - the tab placement (SwingConstants.TOP, SwingConstants.LEFT, SwingConstants.BOTTOM or SwingConstants.RIGHT).
tabIndex - the index of the tab to draw the border for.
x - the x-coordinate for the tab's bounding rectangle.
y - the y-coordinate for the tab's bounding rectangle.
w - the width for the tab's bounding rectangle.
h - the height for the tab's bounding rectangle.
isSelected - indicates whether or not the tab is selected.

paintTabBorder

protected void paintTabBorder(Graphics g,
                              int tabPlacement,
                              int tabIndex,
                              int x,
                              int y,
                              int w,
                              int h,
                              boolean isSelected)
Paints the border for a single tab.
Overrides:
paintTabBorder in interface BasicTabbedPaneUI
Parameters:
g - the graphics device.
tabPlacement - the tab placement (SwingConstants.TOP, SwingConstants.LEFT, SwingConstants.BOTTOM or SwingConstants.RIGHT).
tabIndex - the index of the tab to draw the border for.
x - the x-coordinate for the tab's bounding rectangle.
y - the y-coordinate for the tab's bounding rectangle.
w - the width for the tab's bounding rectangle.
h - the height for the tab's bounding rectangle.
isSelected - indicates whether or not the tab is selected.

paintTopTabBorder

protected void paintTopTabBorder(int tabIndex,
                                 Graphics g,
                                 int x,
                                 int y,
                                 int w,
                                 int h,
                                 int btm,
                                 int rght,
                                 boolean isSelected)
Paints the border for a tab assuming that the tab position is at the top (SwingConstants.TOP).
Parameters:
tabIndex - the tab index.
g - the graphics device.
x - the x-coordinate for the tab's bounding rectangle.
y - the y-coordinate for the tab's bounding rectangle.
w - the width for the tab's bounding rectangle.
h - the height for the tab's bounding rectangle.
btm - the y coordinate of the bottom border
rght - the x coordinate of the right border
isSelected - indicates whether the tab is selected.

shouldFillGap

protected boolean shouldFillGap(int currentRun,
                                int tabIndex,
                                int x,
                                int y)
Returns true if the gap should be filled in.
Parameters:
currentRun - - The current run
tabIndex - - The current tab
x - - The x position of the tab
y - - The y position of the tab
Returns:
true if the gap at the current run should be filled

shouldPadTabRun

protected boolean shouldPadTabRun(int tabPlacement,
                                  int run)
Returns true if the tabs in the specified run should be padded to make the run fill the width/height of the JTabbedPane.
Overrides:
shouldPadTabRun in interface BasicTabbedPaneUI
Parameters:
tabPlacement - the tab placement for the JTabbedPane (one of SwingConstants.TOP, SwingConstants.BOTTOM, SwingConstants.LEFT and SwingConstants.RIGHT).
run - the run index.
Returns:
A boolean.

shouldRotateTabRuns

protected boolean shouldRotateTabRuns(int tabPlacement,
                                      int selectedRun)
Returns true if we should rotate the tab runs.
Parameters:
tabPlacement - - The current tab placement.
selectedRun - - The selected run.
Returns:
true if the tab runs should be rotated.

MetalTabbedPaneUI.java Copyright (C) 2005, 2006 Free Software Foundation, Inc. This file is part of GNU Classpath. GNU Classpath is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version. GNU Classpath is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with GNU Classpath; see the file COPYING. If not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. Linking this library statically or dynamically with other modules is making a combined work based on this library. Thus, the terms and conditions of the GNU General Public License cover the whole combination. As a special exception, the copyright holders of this library give you permission to link this library with independent modules to produce an executable, regardless of the license terms of these independent modules, and to copy and distribute the resulting executable under terms of your choice, provided that you also meet, for each linked independent module, the terms and conditions of the license of that module. An independent module is a module which is not derived from or based on this library. If you modify this library, you may extend this exception to your version of the library, but you are not obligated to do so. If you do not wish to do so, delete this exception statement from your version.