bibliothek.gui.dock.themes.basic
Class BasicButtonDockTitle

java.lang.Object
  java.awt.Component
      java.awt.Container
          javax.swing.JComponent
              javax.swing.JPanel
                  bibliothek.gui.dock.util.BackgroundPanel
                      bibliothek.gui.dock.title.AbstractDockTitle
                          bibliothek.gui.dock.themes.basic.BasicButtonDockTitle

All Implemented Interfaces:

DockElementRepresentative, DockTitle, PaintableComponent, java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable, javax.accessibility.Accessible

Direct Known Subclasses:

EclipseButtonTitle, FlatButtonTitle, SmoothDefaultButtonTitle

@ColorCodes(value={"title.flap.active","title.flap.active.text","title.flap.inactive","title.flap.inactive.text","title.flap.selected","title.flap.selected.text","title.flap.active.knob.highlight","title.flap.active.knob.shadow","title.flap.inactive.knob.highlight","title.flap.inactive.knob.shadow","title.flap.selected.knob.highlight","title.flap.selected.knob.shadow"})
public class BasicButtonDockTitle
extends AbstractDockTitle

This title changes its border whenever the active-state changes.

Author:

Benjamin Sigg

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class javax.swing.JPanel

javax.swing.JPanel.AccessibleJPanel

Nested classes/interfaces inherited from class javax.swing.JComponent

javax.swing.JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class java.awt.Container

java.awt.Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component

java.awt.Component.AccessibleAWTComponent, java.awt.Component.BltBufferStrategy, java.awt.Component.FlipBufferStrategy

Nested classes/interfaces inherited from interface bibliothek.gui.dock.title.DockTitle

DockTitle.Orientation

Field Summary

Fields inherited from class javax.swing.JComponent

accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface bibliothek.gui.dock.title.DockTitle

ORIENTATION_STRATEGY

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

BasicButtonDockTitle(Dockable dockable, DockTitleVersion origin)
Constructs a new title

Method Summary

protected void	changeBorder() Exchanges the current border.
void	changed(DockTitleEvent event) Called if a property changed that might be important for painting this title.
protected DockActionSource	createFilter(DockActionSource actions) Creates a filter around actions, only the actions going through the filter will be shown.
protected DockActionSource	getActionSourceFor(Dockable dockable) Gets a list of all actions which will be shown on this title.
java.awt.Color	getActiveColor() Gets the color that is used as background if the title is focused.
java.awt.Color	getActiveTextColor() Gets the color that is used as foreground if the title is focused.
protected DockActionSource	getChildrenActionSourceFor(Dockable dockable) Gets the "special" children actions for dockable
protected DockActionSource	getDefaultActionSourceFor(Dockable dockable) Gets the "normal" actions for dockable.
java.awt.Color	getInactiveColor() Gets the color that is used as background
java.awt.Color	getInactiveTextColor() Gets the color that is used as foreground
protected java.awt.Insets	getInnerInsets() Gets the insets that have to be applied between the border and the content (icon, text, actions) of this title.
java.awt.Point	getPopupLocation(java.awt.Point click, boolean popupTrigger) Tells whether a popup menu should be opened when the user clicks at click with the mouse.
java.awt.Color	getSelectedColor() Gets the color that is used as background if the title is selected.
java.awt.Color	getSelectedTextColor() Gets the color that is used as foreground if the title is selected.
protected boolean	isMousePressed() Tells whether the mouse is currently pressed or not.
boolean	isSelected() Whether this button is selected or not.
protected void	paintForeground(java.awt.Graphics g, javax.swing.JComponent component) Paints the whole foreground of this title.
void	setActive(boolean active) Sets whether this title should be painted as focused or not.
void	setActiveColor(java.awt.Color color) Sets the color that is used as background if the title is focused.
void	setActiveTextColor(java.awt.Color color) Sets the color that is used as foreground if the title is focused.
void	setInactiveColor(java.awt.Color color) Sets the color that is used as background
void	setInactiveTextColor(java.awt.Color color) Sets the color that is used as foreground
void	setSelectedColor(java.awt.Color color) Sets the color that is used as background if the title is selected.
void	setSelectedTextColor(java.awt.Color color) Sets the color that is used as foreground if the title is selected.
protected void	updateColors() Updates the colors of this title.
protected void	updateIcon() Called when the icon of this title should be updated.
protected void	updateLayout() Updates various elements of this title such that the current state is met.
protected void	updateText() Called when the text of this title should be updated.

Methods inherited from class bibliothek.gui.dock.title.AbstractDockTitle

addColor, addConditionalFont, addFont, addMouseInputListener, bind, createItemFor, doLayout, getComponent, getDockable, getElement, getIcon, getIconBounds, getIconTextGap, getMinimumSize, getOrientation, getOrigin, getPreferredSize, getText, init, isActive, isBound, isShowMiniButtons, isUsedAsTitle, paintBackground, paintBackground, paintForeground, removeAllConditionalFonts, removeColor, removeFont, removeMouseInputListener, setBackground, setBorder, setFont, setFontModifier, setForeground, setIcon, setIconTextGap, setOrientation, setShowMiniButtons, setText, setTooltip, shouldFocus, shouldTransfersFocus, unbind, updateFonts, updateTooltip

Methods inherited from class bibliothek.gui.dock.util.BackgroundPanel

getBackgroundAlgorithm, isSolid, isTransparent, paint, paintBorder, paintChildren, paintComponent, paintOverlay, setBackground, setSolid, setTransparent

Methods inherited from class javax.swing.JPanel

getAccessibleContext, getUI, getUIClassID, paramString, setUI, updateUI

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getNextFocusableComponent, getPopupLocation, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusBackward, transferFocusDownCycle, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusUpCycle

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

BasicButtonDockTitle

public BasicButtonDockTitle(Dockable dockable,
                            DockTitleVersion origin)

Constructs a new title

Parameters:

dockable - the Dockable for which this title is created

origin - the version which was used to create this title

Method Detail

getInnerInsets

protected java.awt.Insets getInnerInsets()

Description copied from class: AbstractDockTitle

Gets the insets that have to be applied between the border and the content (icon, text, actions) of this title. Subclasses may use this method to create free space in which they can paint additional items.

Overrides:

getInnerInsets in class AbstractDockTitle

Returns:

the insets, not null

getActionSourceFor

protected DockActionSource getActionSourceFor(Dockable dockable)

Description copied from class: AbstractDockTitle

Gets a list of all actions which will be shown on this title.

Overrides:

getActionSourceFor in class AbstractDockTitle

Parameters:

dockable - the owner of the actions

Returns:

the list of actions

createFilter

protected DockActionSource createFilter(DockActionSource actions)

Creates a filter around actions, only the actions going through the filter will be shown.

Parameters:

actions - the actions to filter

Returns:

the filter

getDefaultActionSourceFor

protected DockActionSource getDefaultActionSourceFor(Dockable dockable)

Gets the "normal" actions for dockable.

Parameters:

dockable - some item for which actions are required

Returns:

the normal actions, may be a new DockActionSource, not null

getChildrenActionSourceFor

protected DockActionSource getChildrenActionSourceFor(Dockable dockable)

Gets the "special" children actions for dockable

Parameters:

dockable - some item for which actions are required

Returns:

the children actions, may be a new DockActionSource, not null

updateIcon

protected void updateIcon()

Description copied from class: AbstractDockTitle

Called when the icon of this title should be updated. This title never calls AbstractDockTitle.setIcon(Icon) directly, it always calls this method which then calls AbstractDockTitle.setIcon(Icon) (the only exception: on unbinding the icon is set to null)

Overrides:

updateIcon in class AbstractDockTitle

updateText

protected void updateText()

Description copied from class: AbstractDockTitle

Called when the text of this title should be updated. This title never calls AbstractDockTitle.setText(String) directly, it always calls this method which then calls AbstractDockTitle.setText(String) (the only exception: on unbinding the text is set to null)

Overrides:

updateText in class AbstractDockTitle

paintForeground

protected void paintForeground(java.awt.Graphics g,
                               javax.swing.JComponent component)

Description copied from class: AbstractDockTitle

Paints the whole foreground of this title. The default implementation only paints an icon.

Overrides:

paintForeground in class AbstractDockTitle

Parameters:

g - the graphics context to use

component - the Component which represents this title

setActive

public void setActive(boolean active)

Description copied from class: AbstractDockTitle

Sets whether this title should be painted as focused or not.

Overrides:

setActive in class AbstractDockTitle

Parameters:

active - true if the Dockable of this title has the focus.

changed

public void changed(DockTitleEvent event)

Description copied from interface: DockTitle

Called if a property changed that might be important for painting this title. The property can be anything, it does not necessarily have to be a property of this title nor of its owner. Modules using this title might send subclasses of DockTitleEvent to transmit more information to this title than DockTitleEvent would allow.

Specified by:

changed in interface DockTitle

Overrides:

changed in class AbstractDockTitle

Parameters:

event - information about the current state

getPopupLocation

public java.awt.Point getPopupLocation(java.awt.Point click,
                                       boolean popupTrigger)

Description copied from interface: DockElementRepresentative

Tells whether a popup menu should be opened when the user clicks at click with the mouse. If yes, then the top left edge of the popup should be returned, otherwise null should be returned.

Specified by:

getPopupLocation in interface DockElementRepresentative

Overrides:

getPopupLocation in class AbstractDockTitle

Parameters:

click - the location where the user clicked with the mouse

popupTrigger - whether the invocation is the systems popup trigger or not. Many implementations of this method will return click in case of true, and null in case of false

Returns:

the preferred location of a popup or null if no popup-menu should be opened

isMousePressed

protected boolean isMousePressed()

Tells whether the mouse is currently pressed or not.

Returns:

true if the mouse is pressed

isSelected

public boolean isSelected()

Whether this button is selected or not.

Returns:

true if selected, false otherwise

updateLayout

protected void updateLayout()

Updates various elements of this title such that the current state is met.

changeBorder

protected void changeBorder()

Exchanges the current border.

updateColors

protected void updateColors()

Updates the colors of this title.

getActiveTextColor

public java.awt.Color getActiveTextColor()

Gets the color that is used as foreground if the title is focused.

Returns:

the color, might be null

setActiveTextColor

public void setActiveTextColor(java.awt.Color color)

Sets the color that is used as foreground if the title is focused.

Parameters:

color - the new color, null to reset the property

getActiveColor

public java.awt.Color getActiveColor()

Gets the color that is used as background if the title is focused.

Returns:

the color, might be null

setActiveColor

public void setActiveColor(java.awt.Color color)

Sets the color that is used as background if the title is focused.

Parameters:

color - the new color, null to reset the property

getSelectedTextColor

public java.awt.Color getSelectedTextColor()

Gets the color that is used as foreground if the title is selected.

Returns:

the color, might be null

setSelectedTextColor

public void setSelectedTextColor(java.awt.Color color)

Sets the color that is used as foreground if the title is selected.

Parameters:

color - the new color, null to reset the property

getSelectedColor

public java.awt.Color getSelectedColor()

Gets the color that is used as background if the title is selected.

Returns:

the color, might be null

setSelectedColor

public void setSelectedColor(java.awt.Color color)

Sets the color that is used as background if the title is selected.

Parameters:

color - the new color, null to reset the property

getInactiveTextColor

public java.awt.Color getInactiveTextColor()

Gets the color that is used as foreground

Returns:

the color, might be null

setInactiveTextColor

public void setInactiveTextColor(java.awt.Color color)

Sets the color that is used as foreground

Parameters:

color - the new color, null to reset the property

getInactiveColor

public java.awt.Color getInactiveColor()

Gets the color that is used as background

Returns:

the color, might be null

setInactiveColor

public void setInactiveColor(java.awt.Color color)

Sets the color that is used as background

Parameters:

color - the new color, null to reset the property