过程 - 创建简单的自定义图形表示

预置“红绿灯”图形组件 (在参考中进行讨论) 为多状态图标组件的示例。您可以很容易创建遵循此模型的其他自定义图形组件。例如，客户可以创建具有更多状态的红绿灯类型组件，也可以创建新的“雨天或晴天”图形组件。接下来的部分将说明如何创建新的“雨天或晴天”组件。

public class RainOrShineComponent extends MultiStateIconComponent {
public enum RainOrShineEnum {
// Maps an integer to a specific .gif graphical representation
// All possible states supported are listed here
RAIN(0, "com/mycompany/images/rain.gif", "Rain"),
SHINE(1, "com/mycompany/images/sunshine.gif", "Shine");
private final int key;
private final String image;
private final String tooltip;
private RainOrShineEnum(int key, String image, String tooltip) {
this.key = key;
this.image = image;
this.tooltip = tooltip;
}
@Override
public IconComponent getIconComponent() {
// create the icon component using the correct image path
final IconComponent component = new IconComponent(image);
// set the tooltip
component.setTooltip(tooltip);
return component;
}
@Override
public static RainOrShineEnum getElement(int key) throws WTException {
for (RainOrShineEnum tls : values()) {
if (key == tls.key) {
return tls;
}
}
LOGGER.error("Undefined RainOrShineState: " + key);
LOGGER.error("Change the formula to return one of the
following states: 0, 1");
throw new WTException("Undefined RainOrShineState: " + key);
}
}
@Override
public IconComponent getIconComponent(int key) throws WTException {
return RainOrShineEnum.getElement(key).getIconComponent();
}
}

使用“类型和属性管理”实用程序将条目添加到图形表示的枚举中。枚举名为“图形属性表示”，位于名为“PTC 枚举”的系统级组织器中。记住条目的内部名称。该名称将在下一步中使用。在本示例中，假定将 "rainOrShine" 作为新条目的内部名称。

添加 xconf 条目，用于将图形表示枚举条目的内部名称映射到前面创建的自定义 "RainOrShineComponent" 类。对于雨天或晴天组件，新条目可能如下所示。请注意，选择器必须与上一节中枚举条目的内部名称匹配，并且 serviceClass 必须与自定义组件类的完全限定名称匹配。