パラメーターには、記号に関連付けられた値が含まれます。パラメーターは、グラフィック要素にバインドされており、これにより生じる変換は、データの変更を表す要素の点での変更です。
例えば、色を変更するとアラートを示すアイコンなどです。
パラメーターは、 IlvPaletteSymbolParameter のインスタンスを使用して記号に設定されます。このクラスには、 1 つのパラメーターの定義が含まれます。
記号にパラメーターを追加するには、以下を呼び出します。
//Create a new palette
IlvPalette palette = new IlvPalette();
palette.setName(name);
palette.setDescription(french, descr);
//Create a root category for the palette
String categoryID = "root";
IlvPaletteCategory rootCategory = new IlvPaletteCategory(categoryID);
palette.setRoot(rootCategory);
rootCategory.setName(categoryID);
//Create a new symbol
String symbolID = "symbol1";
IlvPaletteSymbol s = palette.addSymbol(rootCategory, symbolID);
s.setName(symbolID);
//Create a new parameter
IlvPaletteSymbolParameter p2 = new IlvPaletteSymbolParameter();
p.setID("progress");
p.setName("progress");
p.setValue(new Integer(0));
//Add the parameter to a symbol
s.addParameter(p);
パラメーターは、任意の値を受け入れるか、または許容値セット (例えば "wait"、"attention"、"go"、あるいは 1、2、3 など) のみを受け入れることができます。パラメーターに対する許容値の説明は、 IlvPaletteSymbolParameterValueSet クラスを使用して設定されます。クラスに許容値を設定するには、以下を呼び出します。
//Create a new value set
String vsetID = "vset1";
IlvPaletteSymbolParameterValueSet vset = new
IlvPaletteSymbolParameterValueSet(vsetID);
vset.setName(vsetID);
vset.setType("Integer");
vset.setValues(new int[] { 1, 2, 3 });
vset.setValueName(0, "one");
vset.setValueName(1, "two");
vset.setValueName(2, "three");
//Add the value set to a palette
palette.setValueSet(vset);
//Create a new parameter
IlvPaletteSymbolParameter p = new IlvPaletteSymbolParameter();
p.setID("progress");
p.setName("progress");
p.setValue(null);
//Add the value set to a parameter
p.setType("set");
p.setValueSet(vset);
記号の CSS は、記号のパラメーターと整合性が保たれている必要があることに注意してください。
例えば、ファイル Dial.css (
ilog/views/palettes/shared/symbols/Dial.css にある) を使用する場合、記号に対する
パラメーター name と value を定義して、Dial.css がこれらのパラメーターを参照するようにする必要があります。
s.addParameter(
new IlvPaletteSymbolParameter("value", new Double(0), "double", null));
s.addParameter(
new IlvPaletteSymbolParameter("name", "DefaultName", "string", null));
...
パラメーターが、記号の表示インターフェースを構成します。
これにより、CSS の内部が非表示になり、パラメーターを介してのみ記号を変更できるようになります。