Eclipse GEF
2.1

org.eclipse.gef.palette
Class PaletteEntry

java.lang.Object
  |
  +--org.eclipse.gef.palette.PaletteEntry
Direct Known Subclasses:
PaletteContainer, PaletteSeparator, PaletteTemplateEntry, ToolEntry

public class PaletteEntry
extends Object

Root class (statically) for the palette model.


Field Summary
protected  PropertyChangeSupport listeners
          PropertyChangeSupport
static String PALETTE_TYPE_UNKNOWN
          Type unknown
static int PERMISSION_FULL_MODIFICATION
          All modifications allowed.
static int PERMISSION_HIDE_ONLY
          Entries with this permission level can only be hidden/shown.
static int PERMISSION_LIMITED_MODIFICATION
          Any property of entries with this level of permission can be changed; however, they cannot be deleted from the palette.
static int PERMISSION_NO_MODIFICATION
          No changes can be made to a PaletteEntry with this permission level.
static String PROPERTY_DEFAULT
          Property name for the entry's default staus
static String PROPERTY_DESCRIPTION
          Property name for the entry's description
static String PROPERTY_LABEL
          Property name for the entry's label (name)
static String PROPERTY_LARGE_ICON
          Property name for the entry's large icon
static String PROPERTY_PARENT
          Property name for the entry's parent
static String PROPERTY_SMALL_ICON
          Property name for the entry's small icon
static String PROPERTY_TYPE
          Property name for the entry's type
static String PROPERTY_VISIBLE
          Property name for the entry's hidden status
 
Constructor Summary
PaletteEntry(String label, String shortDescription)
          Constructor Any parameter can be null
PaletteEntry(String label, String shortDescription, ImageDescriptor iconSmall, ImageDescriptor iconLarge)
          Constructor Any parameter can be null
PaletteEntry(String label, String shortDescription, ImageDescriptor iconSmall, ImageDescriptor iconLarge, Object type)
          Constructor Any parameter can be null
PaletteEntry(String label, String shortDescription, Object type)
          Constructor Any parameter can be null
 
Method Summary
 void addPropertyChangeListener(PropertyChangeListener listener)
          A listener can only be added once.
 String getDescription()
           
 String getLabel()
           
 ImageDescriptor getLargeIcon()
           
 PaletteContainer getParent()
           
 ImageDescriptor getSmallIcon()
           
 Object getType()
           
 int getUserModificationPermission()
          Returned values are from amongst the following: PERMISSION_NO_MODIFICATION PERMISSION_HIDE_ONLY PERMISSION_LIMITED_MODIFICATION PERMISSION_FULL_MODIFICATION
 boolean isVisible()
           
 void removePropertyChangeListener(PropertyChangeListener listener)
           
 void setDescription(String s)
          Mutator method for description
 void setLabel(String s)
          Mutator method for label
 void setLargeIcon(ImageDescriptor icon)
          Mutator method for large icon
 void setParent(PaletteContainer newParent)
          Sets the parent of this entry
 void setSmallIcon(ImageDescriptor icon)
          Mutator method for small icon
 void setType(Object newType)
          Mutator method for type
 void setUserModificationPermission(int permission)
          Permissions are not checked before making modifications.
 void setVisible(boolean newVal)
          Makes this entry visible or invisible.
 String toString()
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

PROPERTY_SMALL_ICON

public static final String PROPERTY_SMALL_ICON
Property name for the entry's small icon

See Also:
Constant Field Values

PROPERTY_TYPE

public static final String PROPERTY_TYPE
Property name for the entry's type

See Also:
Constant Field Values

PROPERTY_LARGE_ICON

public static final String PROPERTY_LARGE_ICON
Property name for the entry's large icon

See Also:
Constant Field Values

PROPERTY_LABEL

public static final String PROPERTY_LABEL
Property name for the entry's label (name)

See Also:
Constant Field Values

PROPERTY_DESCRIPTION

public static final String PROPERTY_DESCRIPTION
Property name for the entry's description

See Also:
Constant Field Values

PROPERTY_VISIBLE

public static final String PROPERTY_VISIBLE
Property name for the entry's hidden status

See Also:
Constant Field Values

PROPERTY_DEFAULT

public static final String PROPERTY_DEFAULT
Property name for the entry's default staus

See Also:
Constant Field Values

PROPERTY_PARENT

public static final String PROPERTY_PARENT
Property name for the entry's parent

See Also:
Constant Field Values

PALETTE_TYPE_UNKNOWN

public static final String PALETTE_TYPE_UNKNOWN
Type unknown

See Also:
Constant Field Values

PERMISSION_NO_MODIFICATION

public static final int PERMISSION_NO_MODIFICATION
No changes can be made to a PaletteEntry with this permission level.

See Also:
Constant Field Values

PERMISSION_HIDE_ONLY

public static final int PERMISSION_HIDE_ONLY
Entries with this permission level can only be hidden/shown.

See Also:
Constant Field Values

PERMISSION_LIMITED_MODIFICATION

public static final int PERMISSION_LIMITED_MODIFICATION
Any property of entries with this level of permission can be changed; however, they cannot be deleted from the palette. The children PaletteContainers with this permission level can be reordered within that container (however, cross-container moving is not allowed).

See Also:
Constant Field Values

PERMISSION_FULL_MODIFICATION

public static final int PERMISSION_FULL_MODIFICATION
All modifications allowed.

See Also:
Constant Field Values

listeners

protected PropertyChangeSupport listeners
PropertyChangeSupport

Constructor Detail

PaletteEntry

public PaletteEntry(String label,
                    String shortDescription)
Constructor

Any parameter can be null

Parameters:
label - The entry's name
shortDescription - The entry's description

PaletteEntry

public PaletteEntry(String label,
                    String shortDescription,
                    Object type)
Constructor

Any parameter can be null

Parameters:
label - The entry's name
shortDescription - The entry's description
type - The entry's type

PaletteEntry

public PaletteEntry(String label,
                    String shortDescription,
                    ImageDescriptor iconSmall,
                    ImageDescriptor iconLarge)
Constructor

Any parameter can be null

Parameters:
label - The entry's name
shortDescription - The entry's description
iconSmall - The small icon to represent this entry
iconLarge - The large icon to represent this entry

PaletteEntry

public PaletteEntry(String label,
                    String shortDescription,
                    ImageDescriptor iconSmall,
                    ImageDescriptor iconLarge,
                    Object type)
Constructor

Any parameter can be null

Parameters:
label - The entry's name
shortDescription - The entry's description
iconSmall - The small icon to represent this entry
iconLarge - The large icon to represent this entry
type - The entry's type
Method Detail

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener listener)
A listener can only be added once. Adding it more than once will do nothing.

See Also:
PropertyChangeSupport.addPropertyChangeListener( java.beans.PropertyChangeListener)

getDescription

public String getDescription()
Returns:
a short desecription describing this entry.

getLabel

public String getLabel()
Returns:
the label for this entry.

getLargeIcon

public ImageDescriptor getLargeIcon()
Returns:
a large icon representing this entry.

getParent

public PaletteContainer getParent()
Returns:
the parent container of this entry

getSmallIcon

public ImageDescriptor getSmallIcon()
Returns:
a small icon representing the entry.

getType

public Object getType()
Returns:
the type of this entry. Useful for different interpretations of the palette model.

getUserModificationPermission

public int getUserModificationPermission()
Returned values are from amongst the following:

Returns:
the permission level for this entry.
See Also:
setUserModificationPermission(int)

isVisible

public boolean isVisible()
Returns:
whether or not this entry is visible. An entry that is not visible is not shown on the palette.

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener listener)
See Also:
PropertyChangeSupport.removePropertyChangeListener( java.beans.PropertyChangeListener)

setDescription

public void setDescription(String s)
Mutator method for description

Parameters:
s - The new description

setLabel

public void setLabel(String s)
Mutator method for label

Parameters:
s - The new name

setLargeIcon

public void setLargeIcon(ImageDescriptor icon)
Mutator method for large icon

Parameters:
icon - The large icon to represent this entry

setParent

public void setParent(PaletteContainer newParent)
Sets the parent of this entry

Parameters:
newParent - The parent PaletteContainer

setUserModificationPermission

public void setUserModificationPermission(int permission)
Permissions are not checked before making modifications. Clients should check the permission before invoking a modification. Sub-classes may extend the set of permissions. Current set has: Default is PERMISSION_FULL_MODIFICATION

Parameters:
permission - One of the above-specified permission levels

setSmallIcon

public void setSmallIcon(ImageDescriptor icon)
Mutator method for small icon

Parameters:
icon - The new small icon to represent this entry

setType

public void setType(Object newType)
Mutator method for type

Parameters:
newType - The new type

setVisible

public void setVisible(boolean newVal)
Makes this entry visible or invisible. An invisible entry does not show up on the palette.

Parameters:
newVal - The new boolean indicating whether the entry is visible or not

toString

public String toString()
Overrides:
toString in class Object
See Also:
Object.toString()

Eclipse GEF
2.1

Copyright (c) IBM Corp. and others 2000, 2003. All Rights Reserved.