com.vlsolutions.swing.docking
Class DockKey

java.lang.Object
  extended by com.vlsolutions.swing.docking.DockKey

public class DockKey
extends Object

Provides a unique identification for a Dockable and runtime properties, like icon, name, tooltip, preferred audohide-zone...

As it is the object which identifies uniquely a user Dockable component, it should be associated with one and only one Dockable.

The unique key used for equals() comparison is the dockKey property, other properties can be shared by a set of DockKey (for example, you can share an icon, or even a display name between dockable Components).

Another usage is the decoration of a dockable container, providing informations such as its name, tooltip or icon.

Properties of a DockKey are listened to by the docking framework, so a change of name or icon is reflected on the GUI without further programming.


Field Summary
static String PROPERTY_AUTOHIDEABLE
          Key identifying a change in the autohideEnabled property
static String PROPERTY_CLOSEABLE
          Key identifying a change in the closeEnabled property
static String PROPERTY_DOCKABLE_STATE
          Key identifying a change in the dockable dockableState
static String PROPERTY_DOCKKEY
          Key identifying a change in the dockKey property
static String PROPERTY_FLOATABLE
          Key identifying a change in the floatableEnabled property
static String PROPERTY_ICON
          Key identifying a change in the icon property
static String PROPERTY_MAXIMIZABLE
          Key identifying a change in the maximizedEnabled property
static String PROPERTY_NAME
          Key identifying a change in the name property
static String PROPERTY_NOTIFICATION
          Key identifying a change in the notification property
static String PROPERTY_TOOLTIP
          Key identifying a change in the tooltip property
 
Constructor Summary
DockKey()
          JavaBeans constructor : If used, also think to set the dockKey property.
DockKey(String dockKey)
          Constructs a DockKey with dockKey (unique key) and name set to the same value
DockKey(String dockKey, String name)
          Constructs a DockKey with dockKey (unique key) and a displayed name
DockKey(String dockKey, String name, String tooltip)
          Constructs a DockKey with dockKey (unique key), a displayed name and a tooltip
DockKey(String dockKey, String name, String tooltip, Icon icon)
          Constructs a DockKey with dockKey (unique key), a displayed name, a tooltip and an icon.
DockKey(String dockKey, String name, String tooltip, Icon icon, DockingConstants.Hide hideBorder)
          Constructs a DockKey with dockKey (unique key), a displayed name, a tooltip, an icon and a default autohide border.
 
Method Summary
 void addPropertyChangeListener(PropertyChangeListener listener)
          Hook for property change notification
 boolean equals(Object o)
          Overriden for Map storage needs
 DockableActionCustomizer getActionCustomizer()
          Returns the action customizer associated to this dockkey (may return null)
 DockingConstants.Hide getAutoHideBorder()
          Returns the autohide border of this dockable, or null if not set
 int getDockableState()
          returns the current visible dockableState of the dockable (see DockableState.STATE_ for enumaration values)
 DockGroup getDockGroup()
          returns the dockGroup of this dockable
 String getDockName()
          Deprecated. use getKey instead
 Icon getIcon()
          Returns the icon displayed in title bars
 String getKey()
          Returns the unique id designating the user component.
 String getName()
          Returns the name (or title) displayed in title bars
 float getResizeWeight()
           
 String getTooltip()
          Returns the tooltip associated to the title bar
 int hashCode()
          Overriden for Map storage needs
 boolean isAutoHideEnabled()
          Returns try if autohiding is enabled
 boolean isCloseEnabled()
          Returns true if this dockable can be closed
 boolean isFloatEnabled()
          Returns true if this dockable can be detached from its desktop
 boolean isMaximizeEnabled()
          Returns true if this dockable can be maximized
 boolean isNotification()
          Returns true is a notification has been set.
 void removePropertyChangeListener(PropertyChangeListener listener)
          Remove a property change notification
 void setActionCustomizer(DockableActionCustomizer actionCustomizer)
          Updates the action customizer of this dockable
 void setAutoHideBorder(DockingConstants.Hide border)
          Updates the autohide border property
 void setAutoHideEnabled(boolean enabled)
          Updates the autohideEnabled propety.
 void setCloseEnabled(boolean enabled)
          Updates the closeEnabled propety.
 void setDockableState(int dockableState)
          updates the dockableState property.
 void setDockGroup(DockGroup group)
          Updates the dockGroup of this dockable.
 void setDockName(String name)
          Deprecated. use setKey instead
 void setFloatEnabled(boolean enabled)
          Updates the floatEnabled propety.
 void setIcon(Icon icon)
          Updates the icon propety.
 void setKey(String dockKey)
          Updates the dockKey property.
 void setMaximizeEnabled(boolean enabled)
          Updates the maximizeEnabled propety.
 void setName(String name)
          Updates the name propety.
 void setNotification(boolean notification)
          Updates the notification propety.
 void setResizeWeight(float weight)
          updates the resize weight of this dockable.
 void setTooltip(String tooltip)
          Updates the tooltip propety.
 String toString()
           
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

Field Detail

PROPERTY_TOOLTIP

public static final String PROPERTY_TOOLTIP
Key identifying a change in the tooltip property

See Also:
Constant Field Values

PROPERTY_NAME

public static final String PROPERTY_NAME
Key identifying a change in the name property

See Also:
Constant Field Values

PROPERTY_DOCKKEY

public static final String PROPERTY_DOCKKEY
Key identifying a change in the dockKey property

See Also:
Constant Field Values

PROPERTY_ICON

public static final String PROPERTY_ICON
Key identifying a change in the icon property

See Also:
Constant Field Values

PROPERTY_AUTOHIDEABLE

public static final String PROPERTY_AUTOHIDEABLE
Key identifying a change in the autohideEnabled property

See Also:
Constant Field Values

PROPERTY_CLOSEABLE

public static final String PROPERTY_CLOSEABLE
Key identifying a change in the closeEnabled property

See Also:
Constant Field Values

PROPERTY_MAXIMIZABLE

public static final String PROPERTY_MAXIMIZABLE
Key identifying a change in the maximizedEnabled property

See Also:
Constant Field Values

PROPERTY_NOTIFICATION

public static final String PROPERTY_NOTIFICATION
Key identifying a change in the notification property

See Also:
Constant Field Values

PROPERTY_FLOATABLE

public static final String PROPERTY_FLOATABLE
Key identifying a change in the floatableEnabled property

See Also:
Constant Field Values

PROPERTY_DOCKABLE_STATE

public static final String PROPERTY_DOCKABLE_STATE
Key identifying a change in the dockable dockableState

See Also:
Constant Field Values
Constructor Detail

DockKey

public DockKey()
JavaBeans constructor : If used, also think to set the dockKey property.


DockKey

public DockKey(String dockKey)
Constructs a DockKey with dockKey (unique key) and name set to the same value


DockKey

public DockKey(String dockKey,
               String name)
Constructs a DockKey with dockKey (unique key) and a displayed name


DockKey

public DockKey(String dockKey,
               String name,
               String tooltip)
Constructs a DockKey with dockKey (unique key), a displayed name and a tooltip


DockKey

public DockKey(String dockKey,
               String name,
               String tooltip,
               Icon icon)
Constructs a DockKey with dockKey (unique key), a displayed name, a tooltip and an icon.


DockKey

public DockKey(String dockKey,
               String name,
               String tooltip,
               Icon icon,
               DockingConstants.Hide hideBorder)
Constructs a DockKey with dockKey (unique key), a displayed name, a tooltip, an icon and a default autohide border.

Method Detail

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener listener)
Hook for property change notification


removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener listener)
Remove a property change notification


getIcon

public Icon getIcon()
Returns the icon displayed in title bars


getName

public String getName()
Returns the name (or title) displayed in title bars


getTooltip

public String getTooltip()
Returns the tooltip associated to the title bar


getKey

public String getKey()
Returns the unique id designating the user component.

Note : This used to be the getDockName prior version 2.0. It has been renamed to clarify the concept (there was a naming problem between getName() and getDockName()


setTooltip

public void setTooltip(String tooltip)
Updates the tooltip propety.

PropertyListeners are notified of that change


setName

public void setName(String name)
Updates the name propety.

PropertyListeners are notified of that change


setIcon

public void setIcon(Icon icon)
Updates the icon propety.

PropertyListeners are notified of that change


setKey

public void setKey(String dockKey)
Updates the dockKey property.

Although PropertyListeners are notified of that change, it is not recommended to change dynamicaly the dockKey property, as it is heavily used in the docking framework to identify dockable components.

Note : This used to be the getDockName prior version 2.0. It has been renamed to clarify the concept (there was a naming problem between getName() and getDockName()


getDockName

public String getDockName()
Deprecated. use getKey instead

See Also:
getKey()

setDockName

public void setDockName(String name)
Deprecated. use setKey instead

See Also:
setKey(String)

getAutoHideBorder

public DockingConstants.Hide getAutoHideBorder()
Returns the autohide border of this dockable, or null if not set


setAutoHideBorder

public void setAutoHideBorder(DockingConstants.Hide border)
Updates the autohide border property


isAutoHideEnabled

public boolean isAutoHideEnabled()
Returns try if autohiding is enabled


setAutoHideEnabled

public void setAutoHideEnabled(boolean enabled)
Updates the autohideEnabled propety.

PropertyListeners are notified of that change


isCloseEnabled

public boolean isCloseEnabled()
Returns true if this dockable can be closed


setCloseEnabled

public void setCloseEnabled(boolean enabled)
Updates the closeEnabled propety.

PropertyListeners are notified of that change


isMaximizeEnabled

public boolean isMaximizeEnabled()
Returns true if this dockable can be maximized


setMaximizeEnabled

public void setMaximizeEnabled(boolean enabled)
Updates the maximizeEnabled propety.

PropertyListeners are notified of that change


isFloatEnabled

public boolean isFloatEnabled()
Returns true if this dockable can be detached from its desktop


setFloatEnabled

public void setFloatEnabled(boolean enabled)
Updates the floatEnabled propety.

PropertyListeners are notified of that change


isNotification

public boolean isNotification()
Returns true is a notification has been set.

default notification is making title bars blink.


setNotification

public void setNotification(boolean notification)
Updates the notification propety. Notification results in a visual change of the dockable in order to attract attention from the user to this dockable.

PropertyListeners are notified of that change.


hashCode

public int hashCode()
Overriden for Map storage needs

Overrides:
hashCode in class Object

equals

public boolean equals(Object o)
Overriden for Map storage needs

Overrides:
equals in class Object

toString

public String toString()
Overrides:
toString in class Object

getActionCustomizer

public DockableActionCustomizer getActionCustomizer()
Returns the action customizer associated to this dockkey (may return null)


setActionCustomizer

public void setActionCustomizer(DockableActionCustomizer actionCustomizer)
Updates the action customizer of this dockable


setDockGroup

public void setDockGroup(DockGroup group)
Updates the dockGroup of this dockable.


getDockGroup

public DockGroup getDockGroup()
returns the dockGroup of this dockable


getDockableState

public int getDockableState()
returns the current visible dockableState of the dockable (see DockableState.STATE_ for enumaration values)

See Also:
DockableState

setDockableState

public void setDockableState(int dockableState)
updates the dockableState property.

Warning : do not call this method, it is for the sole use of the DockingDesktop API.

See Also:
DockableState

getResizeWeight

public float getResizeWeight()

setResizeWeight

public void setResizeWeight(float weight)
updates the resize weight of this dockable. Valid values range between 0.0f and 1.0f



© Copyright 2004-2005 VLSolutions. All Rights Reserved.
www.vlsolutions.com : Java Components - Smart Client Applications