org.eclipse.birt.report.model.api.elements.structures
Class CustomColor

java.lang.Object
  extended by org.eclipse.birt.report.model.core.Structure
      extended by org.eclipse.birt.report.model.core.ReferencableStructure
          extended by org.eclipse.birt.report.model.api.elements.structures.CustomColor
All Implemented Interfaces:
java.lang.Cloneable, IStructure, org.eclipse.birt.report.model.core.IPropertySet, org.eclipse.birt.report.model.core.IReferencable

public class CustomColor
extends org.eclipse.birt.report.model.core.ReferencableStructure

Represents an custom color in the report's color palette.The use-defined color has a unique name and a valid RGB value for render.

This is a managed object, meaning that all changes should be made though the command layer so that they can be undone and redone. Each custom color has the following properties:

Name
a custom color has a unique and required name, so the user can use the color name to identify a custom color.
color
The color value of the color, it is preserved as the user typed in.
Resource Key
a custom color has an optional display name ID to localize the display name.


Field Summary
protected  java.lang.String color
          The color value of the color, it is preserved as the user typed in.
static java.lang.String COLOR_MEMBER
          Name of the color value member.
static java.lang.String CUSTOM_COLOR_STRUCT
          Name of this structure.
static java.lang.String DISPLAY_NAME_ID_MEMBER
          Name of the display name ID member.
static java.lang.String DISPLAY_NAME_MEMBER
          Name of the display name member.
protected  java.lang.String displayName
          The display name for the color.
protected  java.lang.String displayNameID
          The message ID for the display name.
protected  java.lang.String name
          The internal color name such as "periwinkle".
static java.lang.String NAME_MEMBER
          Name of the color name member.
 
Fields inherited from class org.eclipse.birt.report.model.core.ReferencableStructure
clients, clientStructures, LIB_REFERENCE_MEMBER, libReference
 
Constructor Summary
CustomColor()
          Default constructor.
CustomColor(java.lang.String theName, java.lang.String value)
          Constructs the custom color with a required name and RGB value.
 
Method Summary
 java.lang.String getColor()
          Returns the color value as what the user has input.
 java.lang.String getDisplayName()
          Returns the color display name.
 java.lang.String getDisplayName(org.eclipse.birt.report.model.core.Module module)
          Return the display name of the color that can be showed to user.
 java.lang.String getDisplayNameID()
          Returns the color display name message ID.
protected  java.lang.Object getIntrinsicProperty(java.lang.String valueName)
           
 java.lang.String getName()
          Returns the internal color name.
 java.lang.String getReferencableProperty()
           
 int getRGB()
          Returns the color value as an integer RGB value.
 java.lang.String getStructName()
          Returns the name of the structure definition.
protected  StructureHandle handle(SimpleValueHandle valueHandle, int index)
           
 boolean isReferencableProperty(java.lang.String memberName)
           
 void setColor(java.lang.String colorValue)
          Sets the color value.
 void setDisplayName(java.lang.String displayName)
          Sets the color display name.
 void setDisplayNameID(java.lang.String displayNameID)
          Sets the color display name ID.
protected  void setIntrinsicProperty(java.lang.String valueName, java.lang.Object value)
           
 void setName(java.lang.String name)
          Sets the internal color name.
 java.util.List validate(org.eclipse.birt.report.model.core.Module module, org.eclipse.birt.report.model.core.DesignElement element)
          Validates this structure.
 
Methods inherited from class org.eclipse.birt.report.model.core.ReferencableStructure
addClient, addClientStructure, broadcast, clone, dropClient, dropClientStructure, getClientList, getClientStructures, getLocalProperty, getProperty, hasReferences, isReferencable, updateReference
 
Methods inherited from class org.eclipse.birt.report.model.core.Structure
copy, equals, getContext, getDefn, getElement, getHandle, getHandle, getListMemberRef, getLocalProperty, getObjectDefn, getProperty, isDesignTime, setContext, setProperty, setProperty, updateReference
 
Methods inherited from class java.lang.Object
finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

CUSTOM_COLOR_STRUCT

public static final java.lang.String CUSTOM_COLOR_STRUCT
Name of this structure. Matches the definition in the meta-data dictionary.

See Also:
Constant Field Values

NAME_MEMBER

public static final java.lang.String NAME_MEMBER
Name of the color name member.

See Also:
Constant Field Values

COLOR_MEMBER

public static final java.lang.String COLOR_MEMBER
Name of the color value member.

See Also:
Constant Field Values

DISPLAY_NAME_MEMBER

public static final java.lang.String DISPLAY_NAME_MEMBER
Name of the display name member.

See Also:
Constant Field Values

DISPLAY_NAME_ID_MEMBER

public static final java.lang.String DISPLAY_NAME_ID_MEMBER
Name of the display name ID member.

See Also:
Constant Field Values

name

protected java.lang.String name
The internal color name such as "periwinkle".


color

protected java.lang.String color
The color value of the color, it is preserved as the user typed in.


displayName

protected java.lang.String displayName
The display name for the color.


displayNameID

protected java.lang.String displayNameID
The message ID for the display name. Allows the display name to be localized.

Constructor Detail

CustomColor

public CustomColor()
Default constructor.


CustomColor

public CustomColor(java.lang.String theName,
                   java.lang.String value)
Constructs the custom color with a required name and RGB value.

Parameters:
theName - the internal color name
value - the color value
Method Detail

getStructName

public java.lang.String getStructName()
Description copied from interface: IStructure
Returns the name of the structure definition. The name is the one used to define the structure in the meta-data dictionary.

Returns:
the internal name of the structure a defined in the meta-data dictionary.

getIntrinsicProperty

protected java.lang.Object getIntrinsicProperty(java.lang.String valueName)
Overrides:
getIntrinsicProperty in class org.eclipse.birt.report.model.core.ReferencableStructure

setIntrinsicProperty

protected void setIntrinsicProperty(java.lang.String valueName,
                                    java.lang.Object value)
Overrides:
setIntrinsicProperty in class org.eclipse.birt.report.model.core.ReferencableStructure

getRGB

public int getRGB()
Returns the color value as an integer RGB value. If the color value is of a valid color representation, then return its numeric RGB value as integer. Otherwise, return -1 indicates that the value is not valid.

The color value can contain any of the valid color representations:

Returns:
the color value as an integer RGB value. Return -1 if the color value is not valid or the color value is null.
See Also:
ColorUtil.parseColor(String)

getName

public java.lang.String getName()
Returns the internal color name.

Returns:
the internal color name

getColor

public java.lang.String getColor()
Returns the color value as what the user has input.

Returns:
the color value as what the user has input.

getDisplayNameID

public java.lang.String getDisplayNameID()
Returns the color display name message ID.

Returns:
the display name message ID

getDisplayName

public java.lang.String getDisplayName()
Returns the color display name.

Returns:
the display name

getDisplayName

public java.lang.String getDisplayName(org.eclipse.birt.report.model.core.Module module)
Return the display name of the color that can be showed to user. If the custom translations has defined a translation for displayNameID, then the localized text for the current locale is returned; Otherwise return the displayName property if is not null or blank; Else, return the internal name of the color.

Parameters:
module - the module
Returns:
the display name of the color

handle

protected StructureHandle handle(SimpleValueHandle valueHandle,
                                 int index)
Specified by:
handle in class org.eclipse.birt.report.model.core.Structure

setName

public void setName(java.lang.String name)
Sets the internal color name.

Parameters:
name - the internal color name

setDisplayName

public void setDisplayName(java.lang.String displayName)
Sets the color display name.

Parameters:
displayName - the display name

setColor

public void setColor(java.lang.String colorValue)
Sets the color value.

Parameters:
colorValue - the color value to be set.

setDisplayNameID

public void setDisplayNameID(java.lang.String displayNameID)
Sets the color display name ID.

Parameters:
displayNameID - the display name ID to set

validate

public java.util.List validate(org.eclipse.birt.report.model.core.Module module,
                               org.eclipse.birt.report.model.core.DesignElement element)
Validates this structure. The following are the rules:

Overrides:
validate in class org.eclipse.birt.report.model.core.ReferencableStructure
See Also:
Structure.validate(Module, org.eclipse.birt.report.model.core.DesignElement)

isReferencableProperty

public boolean isReferencableProperty(java.lang.String memberName)
Specified by:
isReferencableProperty in class org.eclipse.birt.report.model.core.ReferencableStructure

getReferencableProperty

public java.lang.String getReferencableProperty()
Overrides:
getReferencableProperty in class org.eclipse.birt.report.model.core.Structure


Copyright © 2008 Actuate Corp. All rights reserved.