Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-8102425

Add additional convenience methods to layout builders

XMLWordPrintable

    • Icon: Enhancement Enhancement
    • Resolution: Withdrawn
    • Icon: P4 P4
    • 8
    • 7u6
    • javafx

      Layout builders should be enhanced by additional convenience methods,they are hard to use in current state (see RT-16569).
      Similar convenience methods are present in their respective layout classes:

      *GridPaneBuilder*
      addColumn(int columnIndex, Node... children)
      addRow(int rowIndex, Node... children)
      add(Node child, int columnIndex, int rowIndex)
      add(Node child, int columnIndex, int rowIndex, int colspan, int rowspan)

      *RegionBuilder*
      maxSize(double width, double height)
      minSize(double width, double height)
      prefSize(double width, double height)
      These will be inherited by all layout builders.

      A also propose to add following convenience methods which don't have direct counterpart in layout classes (the constraints can be specified only by static methods there)
      Adding these would enable us to add child with constraint to layout without having to hold a reference to it. e.g
      Hbox h = HBoxBuilder.create().add(CircleBuilder.create...build(), margin).build();
      instead of
      Circle circle = CircleBuilder.create...build();
      Hbox h = HBoxBuilder.create().children(circle).build();
      Hbox.setMargin (circle, margin);

      The proposed methods are:
      *AnchorPaneBuilder*
      add(Node child, Double topAnchor, Double rightAnchor, Double bottomAnchor, Double leftAnchor)

      *BorderPaneBuilder*
      add(Node child, Pos alignment)
      add(Node child, Insets margin)
      add(Node child, Pos alignment, Insets margin)

      *FlowPaneBuilder*
      add(Node child, Insets margin)

      *GridPaneBuilder*
      add(Node child, int columnIndex, int rowIndex, int columnspan, int rowspan, HPos halignment, VPos valignment)
      add(Node child, int columnIndex, int rowIndex, int columnspan, int rowspan, HPos halignment, VPos valignment, Priority hgrow, Priority vgrow)
      add(Node child, int columnIndex, int rowIndex, int columnspan, int rowspan, HPos halignment, VPos valignment, Priority hgrow, Priority vgrow, Insets margin)

      *HBoxBuilder*
      add(Node child, Priority hgrow)
      add(Node child, Insets margin)
      add(Node child, Priority hgrow, Insets margin)

      *StackPaneBuilder*
      add(Node child, Pos alignment)
      add(Node child, Insets margin)
      add(Node child, Pos alignment, Insets margin)

      *TilePaneBuilder*
      add(Node child, Pos alignment)
      add(Node child, Insets margin)
      add(Node child, Pos alignment, Insets margin)

      *VBoxBuilder*
      add(Node child, Priority vgrow)
      add(Node child, Insets margin)
      add(Node child, Priority vgrow, Insets margin)

            ekrejcir Eva Krejčířová (Inactive)
            ekrejcir Eva Krejčířová (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

              Created:
              Updated:
              Resolved:
              Imported: