FAQ JavaFXConsultez toutes les FAQ

Une région est un nœud graphique de type javafx.scene.layout.Region. Il s'agit là de la classe de base servant à définir les contrôles, les gestionnaires de mise en page ou même les graphiques de données statistiques. Une région peut être vue comme l’équivalent d'un <DIV> en HTML : une région rectangulaire qui contient d'autres régions ou entités.

Par défaut, une région définit une zone rectangulaire (layoutBounds) aux coordonnées (0, 0, width, height). Cependant il est possible que le contenu de la région soit positionné en dehors de ces bornes.

Une région dispose d'un fond (background) et d'une bordure (border) qui peuvent eux aussi être positionnés sur les bornes de la zone rectangulaire ou en dehors. Le background est constitué d'un empilement de remplissages de couleur et/ou d'images superposés les uns les autres. Il en est de même pour le border. Lors de l'affichage, le background est dessiné (rendu) en premier, puis les images de fond, puis le border, puis les images de bordure, puis le contenu de la région.

Region hérite de la classe javafx.scene.Parent et dispose donc d'une liste observable nommée children qui permet de modifier son contenu. Cette liste est en accès protected dans Region mais est souvent exposée en accès public dans ses classes filles, principalement dans les gestionnaires de mise en page. La classe Region dispose de la méthode protégée layoutChildren() qui permet d'effectuer la mise en page des nœuds qu'elle contient. La zone de mise en page du contenu (contentArea) est équivalente aux layoutBounds de la région auxquels on a retiré des marges définies dans la propriété insets.

1
2
3
4
5
6
7
8
9
10
11
12
13
@Override  
protected void layoutChildre() { 
  final double width = getWidth(); 
  final double height = getHeight(); 
  final Insets insets = getInsets(); 
  // Calcul de la zone dans laquelle peuvent être positionnés les composants enfants de la région. 
  final double contentAreaX = insets.getLeft(); 
  final double contentAreaY = insets.getTop(); 
  final double contentAreaWidth = width - (insets.getLeft() + insets.getRight()); 
  final double contentAreaHeight = height- (insets.getTop() + insets.getBottom()); 
  // Mise en page des composants enfants de la région. 
  [...] 
}