Release Notes > JTGO 4.5 Release Notes > New Features > Styling

Styling

 PREVIOUS NEXT

The new styling features concern the following:

Predefined Business Objects
New Decoration Names

When adding new decorations to predefined business objects, you can now specify a name for each new decoration. The decoration name will be used by the network and equipment components to manage how the new decoration will be handled by the layer policy and by the zoom policy currently set in the component.

To define a decoration name, use property ILPDECORATIONNAME in your CSS configuration, as illustrated below: 

#commentIcon {
  class: 'ilog.views.graphic.IlvIcon';
  image: '@|image("commentIcon.png")';
  ILPATTRIBUTE: "comments";
  ILPDECORATIONNAME: "Comments";
}

For details on how to customize the decoration name and use it to configure the layer policy and zoom policy, please refer to the sample JTGO Network Component Decoration Features (samples.network.decoration).

Impact Alarm Representation

The graphic representation of impact alarms in the predefined business objects has been improved. The impact alarm severity is now represented by a color, a description or abbreviation, and an icon. The following image illustrates the new impact alarm representation.

images/NewImpactAlarms4.png

For details on how to use and customize impact alarms, see States, Alarm States in the Business Objects and Data Sources section of the User's Documentation.

New Properties

Table 2.1 New Styling Properties 
Property Name 
Type 
Default Value 
Usage 
functionIcon  
Image  
The image mapped for each network element function  
Applies to all network elements  
familyLabel  
String  
The label mapped for each network element family  
Applies to all network elements  
mediaIcon  
Image  
The image mapped for each link media  
Applies to links  
alarmColor  
Color  
null  
Defines a color for alarms in the object. This property is only considered if the property alarmColorVisible is set to true. When this property is applied, it may override the definition of properties foreground or background. 
alarmBrightColor  
Color  
null  
Defines a bright color for alarms in the object. This property is only considered if the property alarmColorVisible is set to true. When this property is applied, it may override the definition of properties background, borderColor or borderColor2. 
alarmDarkColor  
Color  
null  
Defines a dark color for alarms in the object. This property is only considered if property alarmColorVisible is set to true. When this property is applied, it may override the definition of properties borderColor or borderColor2. 
listAlarmStateAbbreviated  
Boolean  
false  
Indicates whether the alarm summary displayed in the object information window uses the alarm severity description or the alarm severity abbreviation to represent each alarm severity  
alarmBalloonCountLabel  
String  
The label based on the highest new alarm severity  
Defines the label to be used as the alarm count in the alarm balloon. The alarm count icon is only represented if the label follows the default alarm count format: alarm count number, alarm severity text description, and an optional indicator to represent other alarms of lower severity 
alarmCountLabel  
String  
The label based on the highest outstanding alarm severity  
Defines the label to be used as the alarm count in the object base. The alarm count icon is only represented if the label follows the default alarm count format: alarm count number, alarm severity text description, and an optional indicator to represent other alarms of lower severity 
alarmBalloonCountIcon  
Image  
The image that represents the highest new alarm severity 
Defines the image to be used as part of the alarm count in the alarm balloon 
alarmCountIcon  
Image  
The image that represents the highest outstanding alarm severity  
Defines the image to be used as part of the alarm count in the object base  
alarmCountIconVisible  
Boolean  
true  
Indicates whether the alarm count icon will be displayed or not. This property modifies the alarm count representation in the object base and alarm balloon  
alarmCountIconPosition  
IlvConstants  
IlvConstants.TRAILING  
Indicates the position of the alarm count icon relative to the alarm severity text representation. The alarm count icon is only displayed if the alarm count label is formatted as: the alarm count number, the alarm severity text description, and an optional indicator to represent other alarms of lower severity. This property modifies the alarm count representation in the object base and in the alarm balloon. Possible values are: IlvConstants.LEADING or IlvConstants.TRAILING  
plinthHorizontalMargin  
int  
4  
Defines the margin that separates the plinth from its inner decorations  
plinthVerticalMargin  
int  
1  
Defines the vertical margin that separates the plinth from its inner decorations  

New Functions

Table 2.2 New Styling Functions 
Function Name 
Arguments 
Description 
Java Class 
primaryStateSummary 
none 
Returns a textual description of the primary states currently set in the object  
ilog.tgo.css.function.IltPrimaryStateSummaryFunction  
secondaryStateSummary 
none 
Returns a textual description of the secondary states currently set in the object  
ilog.tgo.css.function.IltSecondaryStateSummaryFunction  
severityBrightColor 
IltAlarmSeverity 
Returns the bright color customized for the given alarm severity  
ilog.tgo.css.function.IltSeverityBrightColorFunction  
severityDarkColor 
IltAlarmSeverity 
Returns the dark color customized for the given alarm severity  
ilog.tgo.css.function.IltSeverityDarkColorFunction  
severityIcon 
IltAlarmSeverity 
Returns the icon that represents the given alarm severity  
ilog.tgo.css.function.IltSeverityIconFunction  
settings 
String 
Returns the value of the given setting as stored in ilog.tgo.resource.IltSettings  
ilog.tgo.css.function.IltSettingsFunction  

New Settings

Table 2.3 New Styling Settings 
Setting Name 
Type 
Description 
OSI.State.Usage.Busy.Icon 
Image  
Defines the image that is displayed when the object has the state OSI.State.Usage set to Busy  
OSI.State.Administrative.Locked.Icon 
Image 
Defines the image that is displayed when the object has the state OSI.State.Administrative set to Locked  
OSI.State.Administrative.ShuttingDown.Icon 
Image 
Defines the image that is displayed when the object has the state OSI.State.Administrative set to Shutting Down  
Information Window.Icon 
Image 
Defines the image used to create the information icon  
Information Window.Acknowledged.Icon 
Image 
Defines the image used to create the information icon when the information window has already been acknowledged by the user  
System Window.Icon 
Image 
Defines the image used to create the system icon  
System Window.Acknowledged.Icon 
Image 
Defines the image used to create the system icon when the system window has already been acknowledged by the user  
Subnetwork.Collapse.Icon 
Image 
Defines the image used to create the collapse icon for subnetworks  
Subnetwork.Expand.Icon 
Image 
Defines the image used to create the expansion icon for subnetworks  
Subnetwork.Empty.Icon 
Image 
Defines the image used to create the icon indicating that the subnetwork cannot be expanded as it has no child objects 

Copyright © Rogue Wave Software, Inc. 1997, 2015. All rights reserved. Legal terms. PREVIOUS NEXT