Describes the following card items: LEDs and ports.

Card items are placed inside a card item container ( IltCard). Their positioning is relative to the top left corner of the container. Regardless of the orientation of the container, the top left corner constitutes the origin for positioning the card items; the X coordinate of card items increases from left to right and the Y coordinate increases from top to bottom, with regard to this origin.

The positioning point of a card item is its center point and is relative to the origin of the card item container (top left corner).

When planning the size of shelves and slots, remember to take into account the child objects, particularly the card and its card items.

Rogue Wave® JViews TGO defines two types of card items: LEDs and ports.

The abstract class IltCardItem defines all the common characteristics of a business object that can be associated with a card or any implementation of IltCard.

The IltCardItem class defines the following attributes:

Describes the facilities available for LEDs.

Overview of LEDs

An LED (Light Emitting Diode) is an object used to represent a state through a color. Most types of equipment use LEDs as interfaces that give the user information on hardware and software conditions. Rogue Wave® JViews TGO provides an LED business object to help you create real world items of equipment.

Although a state object can be associated with LEDs, it does not affect their graphic representation. LEDs are not managed objects themselves; they help represent the state of managed objects such as ports or cards.

Depending on the nature of the application, LEDs can be represented by a bitmap image or by a vector graphic. Like a network element, the LED representation is set through the TypeAttribute attribute assigned to the object represented by the LED.

To find all necessary information on the styling properties of LEDs, refer to Customizing shelves and cards.

LED class

LEDs are predefined business objects of the class IltLed, which defines a card item by extending the IltCardItem abstract class.

The parent class IltCardItem defines the TypeAttribute, which is used to create several different graphic representations for different instances of the same IltLed class.

The IltLed class defines the following attributes:

Loading an LED defined in XML

For detailed information about data sources, see Data sources.

How to add an LED to a card defined in XML

The following example extends the example in Loading a shelf defined in XML and adds an LED to a card. For details about the XML elements used in this example, see Elements in an XML data file .

The result looks like this:

Creating an LED with the API

When you create an LED with the API, you must provide its type, which can be set through the constructor or through the setAttributeValue method.

How to create an LED with the API

The following sample shows how to create an LED of type Circular.

The result looks like this:

Predefined LED types

There are several predefined LED types, using both bitmap and vector representations. You can extend the predefined types and define new representations using either images or drawers capable of creating vector images. For information on how to create new LED types, see Customizing LED types.

Among the LEDs listed in this table, IltLed.Type.Circular, IltLed.Type.CircularShape, IltLed.Type.CircularFlat, IltLed.Type.Rectangular, and IltLed.Type.RectangularShape are vector graphic representations; all the others are bitmap images.

Describes the facilities available for ports.

Overview of ports

Most real world cards have a physical interface to connect them to other sets of equipment or to a network. The connections are usually achieved through connectors or ports. Rogue Wave® JViews TGO provides port objects to represent connections between a card ( IltCard) and the external world.

Ports allow you to represent alarms and states graphically in the same way as network elements do, with alarm balloons and colors depending on the alarm severity.

Depending on the nature of the application, ports can be represented by a bitmap image or by a vector graphic. Like a network element, the port representation is set through the TypeAttribute attribute assigned to the object represented by the port.

To find all necessary information on the styling properties of ports, refer to Customizing shelves and cards.

Port class

Ports are predefined business objects of the class IltPort, which defines a card item by extending the IltCardItem abstract class to fit inside card objects.

The parent class IltCardItem defines the TypeAttribute, which is used to create different graphic representations for different instances of the same IltLed class.

The IltPort class does not define any specific attribute:

Loading a port defined in XML

For detailed information about data sources, see Data sources.

How to add a port to a card defined in XML

The following example extends the example in Loading a shelf defined in XML and adds a port to a card. For details about the XML elements used in this example, see Elements in an XML data file .

The result looks like this:

Creating a port with the API

When you create a port with the API, you must provide its type, which can be set through the constructor or through the setAttributeValue method.

How to create a port with the API

The following sample shows how to create a port of type Centronics_36f.

The result looks like this:

Predefined port types

There are several predefined port types using both vector and bitmap representations. You can also define new types using either images or drawers capable of creating vector images.

For information on how to create new port types, see Customizing port types.

All port types in the following table are image ports.