skip to main content
TGO > Programmers documentation > Styling > Customizing network elements > Customizing network element families
 
Customizing network element families
Creating a new network element family entails:
*Extending the IltNetworkElement.Family enumeration.
*Mapping the new family with a label.
How to create a network element family (using the API)
 
IltNetworkElement.Family OC999 =
  new IltNetworkElement.Family("OC999");
IltSettings.SetValue("NetworkElement.Family.OC999.Label","999");
How to create a network element family (using CSS)
You can also create new network element families by using global CSS settings (see Using global settings in Using Cascading Style Sheets for more information):
 
setting."ilog.tgo.model.IltNetworkElement"{
  families[0]: @+neFamily0;
}
Subobject#neFamily0 {
  class: 'ilog.tgo.model.IltNetworkElement.Family';
  name: "OC999";
}
The following properties are used to customize the display of network element families.
CSS properties for network element families
Property Name
Type
Default Value
Description
familyVisible
boolean
true
Determines whether the family label is displayed or not
familyFont
Font
Helvetica 10
Defines the font used to draw the family label
familyForeground
Color
35% gray
Defines the color of the family label text
familyBackground
Color
transparent ( null )
Defines the color of the family label background, with a null value meaning a transparent background
familyAntialiasing
boolean
false
Determines whether the family label is displayed using anti-aliasing or not
You can map network element families to labels by using the method IltSettings.SetValue. You can also associate a network element family with a resource that is retrieved from the JViews TGO resource bundle (see About globalization ).
Example:
 
IltSettings.SetValue("NetworkElement.Family.OC999.Label","My_NetworkElement_Fam
ily_999");
You can obtain the same customization using global CSS settings. To do so, you need to specify the full path to the object to be customized, as well as the value of its name attribute in order to match the right object in the system. The CSS property to customize here is label.
 
setting."ilog.tgo.model.IltNetworkElement.Family"[name="OC192-UsrDf"] {
   label: "My_NetworkElement_Family_999";
}
By default, network element families and resources are associated automatically. A label and a tooltip are displayed for the new network element family provided that the following resources have been declared in the JViews TGO resource bundle:
*ilog.tgo.NetworkElement_Family_<FAMILY NAME> : network element family label
*ilog.tgo.NetworkElement_Family_<FAMILY NAME>_ToolTip : network element family tooltip
For the predefined network element families, you can edit the values directly in the JViews TGO resource bundle file.
For newly created network element families, the label and tooltip information will also be retrieved from this resource bundle. As you declare new network element families, register the corresponding entries into the resource bundle file.
Considering that you have created the network element family "OC999", you should declare the corresponding entries in the resource bundle file as follows:
*ilog.tgo.NetworkElement_Family_OC999=999
*ilog.tgo.NetworkElement_Family_OC999_ToolTip=OC 999

Copyright © 2018, Rogue Wave Software, Inc. All Rights Reserved.