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.ReferencableStructureRepresents 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
Fields Modifier and Type Field Description protected java.lang.StringcolorThe color value of the color, it is preserved as the user typed in.static java.lang.StringCOLOR_MEMBERName of the color value member.static java.lang.StringCUSTOM_COLOR_STRUCTName of this structure.static java.lang.StringDISPLAY_NAME_ID_MEMBERName of the display name ID member.static java.lang.StringDISPLAY_NAME_MEMBERName of the display name member.protected java.lang.StringdisplayNameThe display name for the color.protected java.lang.StringdisplayNameIDThe message ID for the display name.protected java.lang.StringnameThe internal color name such as "periwinkle".static java.lang.StringNAME_MEMBERName of the color name member.
-
Constructor Summary
Constructors Constructor Description 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
All Methods Instance Methods Concrete Methods Modifier and Type Method Description java.lang.StringgetColor()Returns the color value as what the user has input.java.lang.StringgetDisplayName()Returns the color display name.java.lang.StringgetDisplayName(org.eclipse.birt.report.model.core.Module module)Return the display name of the color that can be showed to user.java.lang.StringgetDisplayNameID()Returns the color display name message ID.protected java.lang.ObjectgetIntrinsicProperty(java.lang.String valueName)Returns the value of a structure property represented as a member variable.java.lang.StringgetName()Returns the internal color name.java.lang.StringgetReferencableProperty()Gets the value of the referencable member.intgetRGB()Returns the color value as an integer RGB value.java.lang.StringgetStructName()Returns the name of the structure definition.protected StructureHandlehandle(SimpleValueHandle valueHandle, int index)Creates the specific handle of this structure.booleanisReferencableProperty(java.lang.String memberName)Checks whether the member of the input name is the referencable member or not.voidsetColor(java.lang.String colorValue)Sets the color value.voidsetDisplayName(java.lang.String displayName)Sets the color display name.voidsetDisplayNameID(java.lang.String displayNameID)Sets the color display name ID.protected voidsetIntrinsicProperty(java.lang.String valueName, java.lang.Object value)Sets the value of of a structure property represented as a member variable.voidsetName(java.lang.String name)Sets the internal color name.java.util.Listvalidate(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
checkStringMember, copy, equals, getCompatibleValue, getContext, getDefn, getElement, getExpressionProperty, getHandle, getHandle, getLocalProperty, getMemberDefn, getObjectDefn, getProperty, getStringProperty, isDesignTime, setContext, setExpressionProperty, setProperty, setProperty, setupContext, updateReference
-
-
-
-
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.
-
-
Method Detail
-
getStructName
public java.lang.String getStructName()
Description copied from interface:IStructureReturns 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)
Description copied from class:org.eclipse.birt.report.model.core.StructureReturns the value of a structure property represented as a member variable.- Overrides:
getIntrinsicPropertyin classorg.eclipse.birt.report.model.core.ReferencableStructure- Parameters:
valueName- name of the property- Returns:
- the value of the property, or null if the property is not set
-
setIntrinsicProperty
protected void setIntrinsicProperty(java.lang.String valueName, java.lang.Object value)Description copied from class:org.eclipse.birt.report.model.core.StructureSets the value of of a structure property represented as a member variable.- Overrides:
setIntrinsicPropertyin classorg.eclipse.birt.report.model.core.ReferencableStructure- Parameters:
valueName- the name of the property to setvalue- the property value
-
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-1indicates 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
-1if the color value is not valid or the color value isnull. - 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 fordisplayNameID, then the localized text for the current locale is returned; Otherwise return thedisplayNameproperty 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)
Description copied from class:org.eclipse.birt.report.model.core.StructureCreates the specific handle of this structure. This handle is always created.- Specified by:
handlein classorg.eclipse.birt.report.model.core.Structure- Parameters:
valueHandle- the value handle of this structure list property this structure is inindex- the position of this structure in structure list- Returns:
- the handle of this 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:
validatein classorg.eclipse.birt.report.model.core.ReferencableStructure- Parameters:
module- the moduleelement- the element contains this structure- Returns:
- the semantic error list
- See Also:
Structure.validate(Module, org.eclipse.birt.report.model.core.DesignElement)
-
isReferencableProperty
public boolean isReferencableProperty(java.lang.String memberName)
Description copied from class:org.eclipse.birt.report.model.core.ReferencableStructureChecks whether the member of the input name is the referencable member or not.- Specified by:
isReferencablePropertyin classorg.eclipse.birt.report.model.core.ReferencableStructure- Parameters:
memberName- the member name to check- Returns:
- true if the member with the given name is referencable, otherwise false
-
getReferencableProperty
public java.lang.String getReferencableProperty()
Description copied from class:org.eclipse.birt.report.model.core.StructureGets the value of the referencable member.- Overrides:
getReferencablePropertyin classorg.eclipse.birt.report.model.core.Structure- Returns:
- the value of the referencable member
-
-