Paramètre d'index de niveau (HL)

L'index de niveau est un cas spécial de contrainte de plage de niveaux (voir Contraintes de plage de niveaux (HL)). Il force le noeud à un niveau particulier. Pour plus de commodité, vous vous pouvez indiquer le l'index de niveau d'un noeud directement à l'aide de la méthode suivante :
layout.setSpecNodeLevelIndex(node, 2);
Vous transmettez un un noeud unique en tant que premier argument (et non un groupe de noeuds). La valeur d'index par défaut est -1. Si la valeur par défaut est utilisée, ou si un noeud est défini par un index de niveau négatif, l'index de niveau est considéré comme non spécifié. Dans ce cas, l'algorithme d'agencement calcule automatiquement un index de niveau approprié au cours de la phase de nivellement de l'algorithme.
Pour obtenir l'index de niveau spécifié pour un noeud, utilisez la méthode suivante :
var index = getSpecNodeLevelIndex(node);
Toutefois, cette méthode retourne la valeur qui avait été définie par setSpecNodeLevelIndex. Si l'index de niveau avait été spécifié en affectant une contrainte de plage de niveau correspondante ayant la même signification, getSpecNodeLevelIndex retourne toujours -1.
Avertissement
Il est déconseillé d'utiliser de manière arbitraire d'importants index de niveau. Par exemple, si vous définissez l'index de niveau d'un noeud sur 100000, l'algorithme d'agencement crée 100 000 niveaux même si le graphe a beaucoup moins de noeuds. Cela entraîne un ralentissement de l'algorithme d'agencement.