Der Ebenenindex ist ein Sonderfall einer Vorgabe für den Ebenenbereich
(siehe Vorgaben für den Ebenenbereich (HL)). Er erzwingt die Platzierung des Knotens in einer bestimmten Ebene.
Zu Ihrem Komfort können Sie den Ebenenindex eines Knotens direkt mit der folgenden Methode angeben:
layout.setSpecNodeLevelIndex(node, 2);
Sie übergeben einen einzigen Knoten als erstes Argument (keine Knotengruppe).
Der Standardindexwert ist
-1
.
Wenn der Standardwert verwendet wird oder wenn ein Knoten auf einen negativen Ebenenindex gesetzt ist,
wird der Ebenenindex als nicht definiert betrachtet.
In diesem Fall berechnet der Layoutalgorithmus automatisch einen entsprechenden Ebenenindex
in der Algorithmusphase, in der die Ebenen angelegt werden.
Verwenden Sie die folgende Methode, um den angegebenen Ebenenindex für einen Knoten abzurufen:
var index = getSpecNodeLevelIndex(node);
Diese Methode gibt jedoch den Wert zurück, der von
setSpecNodeLevelIndex
festgelegt wurde. Wenn der
Ebenenindex durch Zuordnung einer Vorgabe für den Ebenenbereich angegeben wurde, der dieselbe Bedeutung hat,
gibt getSpecNodeLevelIndex
trotzdem
-1
zurück.Warnung
Die Verwendung beliebig großer Ebenenindizes wird nicht empfohlen.
Wenn Sie den Ebenenindex eines Knoten beispielsweise auf
100000
setzen, erstellt der Layoutalgorithmus 100.000 Ebenen, selbst wenn
der Graph sehr viel weniger Knoten hat.
Damit wird der Layoutalgorithmus sehr langsam.