Class CoreRibbonResizePolicies

The core resize policies. Provides a number of built in resize policies that respect the application element priorities passed to JRibbonBand.addCommandButton(org.pushingpixels.flamingo.api.common.AbstractCommandButton, org.pushingpixels.flamingo.api.ribbon.RibbonElementPriority) and JRibbonBand.addRibbonGallery(String, java.util.List, java.util.Map, int, int, org.pushingpixels.flamingo.api.ribbon.RibbonElementPriority) APIs. There are three types of built in resize policies:

• Resize policies for the JFlowRibbonBands. The CoreRibbonResizePolicies.FlowTwoRows and CoreRibbonResizePolicies.FlowThreeRows allow placing the flow ribbon band content in two and three rows respectively.
• Resize policies for the JRibbonBands. The CoreRibbonResizePolicies.BaseCoreRibbonBandResizePolicy is the base class for these policies. These policies respect the RibbonElementPriority associated on command buttons and ribbon galleries in RibbonBandResizePolicy.getPreferredWidth(int, int) and RibbonBandResizePolicy.install(int, int). While RibbonBandResizePolicy.install(int, int) call on a JFlowRibbonBand only changes the bounds of the flow components, this call on a JRibbonBand can also change the display state of the command buttons (with AbstractCommandButton.setDisplayState(org.pushingpixels.flamingo.api.common.CommandButtonDisplayState) ) and the number of visible buttons in the ribbon galleries.
• The collapsed policy that replaces the entire content of the ribbon band with a single popup button. This is done when there is not enough horizontal space to show the content of the ribbon band under the most restrictive resize policy. Activating the popup button will show the original content under the most permissive resize policy in a popup. This policy is implemented in the IconRibbonBandResizePolicy.

In addition to the specific resize policies, this class provides three core resize policies lists for JRibbonBands:

• getCorePoliciesPermissive(JRibbonBand) returns a list that starts with a resize policy that shows all command buttons in the CommandButtonDisplayState.BIG and ribbon galleries with the largest number of visible buttons, fully utilizing the available screen space.
• getCorePoliciesRestrictive(JRibbonBand) returns a list that starts with a resize policy that respects the associated ribbon element priority set on the specific components.
• getCorePoliciesNone(JRibbonBand) returns a list that only has a mirror resize policy that respects the associated ribbon element priority set on the specific components.

Note that as mentioned above, all the three lists above have the collapsed policy as their last element.

In addition, the getCoreFlowPoliciesRestrictive(JFlowRibbonBand, int) returns a restrictive resize policy for JFlowRibbonBands. The list starts with the two-row policy, goes to the three-row policy and then finally to the collapsed policy.