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

java.lang.Object
  org.eclipse.birt.report.model.core.Structure
      org.eclipse.birt.report.model.core.ReferencableStructure
          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:

• A decimal number: An integer with a valid RGB color value.
• A hexadecimal number in Java or HTML style: "0xRRGGBB, #RRGGBB or #RGB
• CSS absolute: RGB(r,g,b)
• CSS relative: RGB(r%,g%,b%)
• One of the css color name: red, green, black.

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:

• The color name is required.
• The color value can not be the same as a CSS color name.

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