All Known Implementing Classes:: AbstractPanelBuilder, GbPanelBuilder

public interface PanelBuilder

The "Main interface" for this library. Builds panels based on the calls fro the client code. Instances implementing this interface are normally created by PanelBuilderFactorys and managed by the static methods of PanelMatic class.

Author:: michaelbar-sinai
See Also:: PanelBuilderFactory.build(), PanelMatic.begin(io.codeworth.panelmatic.PanelMaticComponentCustomizer[])

Nested Class Summary

Nested Classes

Modifier and Type Interface Description

static class PanelBuilder.HeaderLevel
Describes the title level.

Method Summary

Modifier and Type	Method	Description
`PanelBuilder`	`add(String title, JComponent comp, BehaviorModifier... modifiers)`
`PanelBuilder`	`add(Icon icn, String title, JComponent comp, BehaviorModifier... modifiers)`
`PanelBuilder`	`add(JComponent comp, BehaviorModifier... modifiers)`
`PanelBuilder`	`add(JComponent titleComp, JComponent comp, BehaviorModifier... modifiers)`
`PanelBuilder`	`addFlexibleSpace()`	Adds an empty space that stretches to take any extra space available.
`PanelBuilder`	`addHeader(PanelBuilder.HeaderLevel hx, String title, JComponent... comps)`
`PanelBuilder`	`addHeader(PanelBuilder.HeaderLevel hx, Icon icn, String title, JComponent... comps)`
`PanelBuilder`	`begin(PanelMaticComponentCustomizer... custsForCurrentBuild)`	Prepares the builder to get a panel using internally-created container.
`PanelBuilder`	`begin(JComponent basePanel, PanelMaticComponentCustomizer... custsForCurrentBuild)`	Prepares the builder to get a panel using the supplied `JComponent` as the top-level container.
`JComponent`	`get(PanelPostProcessor... pp)`	Finalizes the build, and returns the built panel.
`List<PanelMaticComponentCustomizer>`	`getCustomizerChain()`	Allows access to the chain of `PanelMaticComponentCustomizer`s that customize components before adding them to the built panel.
`void`	`setBuilderPool(BuilderPool aPool)`	Sets the pool into which the builder will return when done.

Method Details
- begin
  
  PanelBuilder begin(PanelMaticComponentCustomizer... custsForCurrentBuild)
  
  Prepares the builder to get a panel using internally-created container. When possible, you should use this method, rather than begin(javax.swing.JComponent, org.panelmatic.PanelMaticComponentCustomizer[]), as it is guaranteed to work.
  
  Parameters:
  
  custsForCurrentBuild - Component customizers that are prepended to the normal component customizers, for this get only (until get(org.panelmatic.PanelPostProcessor[]) is called).
  
  Returns:
  
  this builder.
- begin
  
  PanelBuilder begin(JComponent basePanel, PanelMaticComponentCustomizer... custsForCurrentBuild)
  
  Prepares the builder to get a panel using the supplied JComponent as the top-level container. Use when laying-out existing panels. The builder would probably try to set properties on the component, make sure that panel can handle those changes (e.g setting of a LayoutManager.
  
  Parameters:
  
  basePanel - The component to be used as container.
  
  custsForCurrentBuild - Component customizers that are prepended to the normal component customizers, for this get only (until get(org.panelmatic.PanelPostProcessor[]) is called).
  
  Returns:
  
  this builder.
- add
  
  PanelBuilder add(Icon icn, String title, JComponent comp, BehaviorModifier... modifiers)
- add
  
  PanelBuilder add(String title, JComponent comp, BehaviorModifier... modifiers)
- add
  
  PanelBuilder add(JComponent titleComp, JComponent comp, BehaviorModifier... modifiers)
- add
  
  PanelBuilder add(JComponent comp, BehaviorModifier... modifiers)
- addHeader
  
  PanelBuilder addHeader(PanelBuilder.HeaderLevel hx, String title, JComponent... comps)
- addHeader
  
  PanelBuilder addHeader(PanelBuilder.HeaderLevel hx, Icon icn, String title, JComponent... comps)
- addFlexibleSpace
  
  PanelBuilder addFlexibleSpace()
  
  Adds an empty space that stretches to take any extra space available.
  
  Returns:
  
  this builder.
- get
  
  JComponent get(PanelPostProcessor... pp)
  
  Finalizes the build, and returns the built panel. The builder returns to its pool. After calling this method, the client code can no longer use the builder! To obtain a new builder, call on of PanelMatic]'s begin() methods
  
  Parameters:
  
  pp - optional post processors for the built panel.
  
  Returns:
  
  the built component.
- getCustomizerChain
  
  List<PanelMaticComponentCustomizer> getCustomizerChain()
  
  Allows access to the chain of PanelMaticComponentCustomizers that customize components before adding them to the built panel.
  To add a customizer, use builder.getCustomizerChain().add( cust ); Note that since the builders are pooled, changes made to a builder obtained by PanelMatic.begin(...) might not effect other builders obtained the same way. To ensure all builders are changed, consider implementing a PanelBuilderFactory and calling this method on the PanelBuilderFactory.build() method.
  
  Returns:
  
  The chain of customizers.
- setBuilderPool
  
  void setBuilderPool(BuilderPool aPool)
  
  Sets the pool into which the builder will return when done. Normally client code should not call this method.
  
  Parameters:
  
  aPool - the pool this builder should return to when done building.

Interface PanelBuilder

Nested Class Summary

Method Summary

Method Details