レベル・インデックスは、レベル範囲制約
(レベル範囲制約
(HL) を参照)
の特殊なケースです。
これは、ノードがある特定のレベルになるように強制します。都合に合わせて、以下のメソッドによって直接、ノードのレベル・インデックスを指定できます。
layout.setSpecNodeLevelIndex(node, 2);
単一のノード (ノード・グループではない)
を最初の引数として渡します。
デフォルトのインデックス値は
-1
です。 デフォルト値を使用した場合、またはノードが負のレベル・インデックスに設定された場合は、レベル・インデックスは指定されていないものと見なされます。
この場合、レイアウト・アルゴリズムは、アルゴリズムのレベル付けフェーズ時に、適切なレベル・インデックスを自動的に計算します。ノードの指定レベル・インデックスを取得するには、以下のメソッドを使用します。
var index = getSpecNodeLevelIndex(node);
ただし、このメソッドは、
setSpecNodeLevelIndex
によって設定された値を返します。
同じ意味を持つ、対応するレベル範囲制約を割り振ることでレベル・インデックスが指定されている場合でも、 getSpecNodeLevelIndex
は -1
を返します。警告
任意に大きいレベル・インデックスを使用することは推奨されません。
例えば、ノードのレベル・インデックスを
100000
に設定した場合、
レイアウト・アルゴリズムは、グラフのノード数がはるかに少ない場合でも
100,000 個のレベルを作成します。
これにより、レイアウト・アルゴリズムが遅くなってしまいます。