Parameter für Ebenenindex (HL)

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.