Method Detail

• add

  public void add(Widget child)

  Add a child Widget to this Container. This works for all the various Container types, of course, but most offer more specialized packing methods that allow you to control the positioning of the Widget being added with greater finesse.

  Since:

  4.0.0

• getChildren

  public Widget[] getChildren()

  Get the Widgets that are children of this Container, i.e. the Widgets previously added to the Container. An array of Widgets isn't always ideal, but you can cast the returned objects to the appropriate Widget subtype should you need to, for example:

   Button button, child;
   Widget[] children;
   
   box.add(button);
   children = box.getChildren();
   
   child = (Button) children[0];
   

  In other situations (wondering just what aggregation of Widgets makes up something that was handed to you by Glade, perhaps), instanceof is your friend. Indeed sometimes it's the only way; the box packing composition of GTK elements means that even things you might take for granted as elementary (Button) are in fact more complex (an HBox of an Image and a Label) - and often the only way to find this out is to walk the Widget hierarchy.

  Returns:

  an array with the Container's child Widgets. The array will be empty (zero length) if the Container hasn't got any children.

  Since:

  4.0.3

• remove

  public void remove(Widget child)

  Remove a Widget from this Container.

  In native GTK, this often results in the destruction of the Widget. In java-gnome, that will only occur once the last Java reference goes out of scope and a garbage collection run occurs. So you can, quite safely, do:

   box1.remove(button);
   box2.add(button);
   

  without worrying that that Button is going to evaporate out from under you.

  Parameters:

  child - A child Widget that is already in the Container, right? If you try to remove a Widget that isn't, don't complain when you get all sorts of errors!

  Since:

  4.0.2

• setBorderWidth

  public void setBorderWidth(int width)

  Set the amount of padding to put around the outside of this Container, in pixels. This is exterior padding around the outside of the contained Widgets. The default is 0.

  Parameters:

  width - Although anything under 65535 is a valid value, anyone who thinks they need a border width of sixty thousand pixels is invited to get their head examined.

  Since:

  4.0.5