|
Side of Software Print Preview Library 1.8.1 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--sos.preview.FitAllLayout
A layout scheme that scales all components such that they fit in the bounds of their container's parent.
FitAllLayout
arranges the container's child components in a grid inside
the container. The number of rows and columns is chosen such that
it maximizes the children's sizes.
It scales each child component the same amount. If a child
component has a smaller preferred size, it will not fill the
grid cell allotted to it. In this case, FitAllLayout
uses
the horizontal and vertical alignments to position the component
within the cell.
FitAllLayout
prefers a size that equals the container's parent's size.
If the parent's size has not yet been set, the layout prefers a linear grid with each
child component its preferred size.
FitAllLayout
does not allow scrolling.
The layout honors suggested left, right, top, and bottom margins as well as the vertical and horizontal spacing between rows and columns.
The following diagram illustrates the placement of child components and the container's padding:
FitAllLayout
takes the container's component orientation into accout.
The above diagram assumes a locale where the orientation is left-to-right
and horizontal.
FitLayout
,
MatrixLayout
,
ZoomLayout
,
ScalingLayoutManager
,
ScrollableLayoutManager
Constructor Summary | |
FitAllLayout()
Creates a default FitAllLayout . |
|
FitAllLayout(int horizontalAlignment,
int verticalAlignment)
Creates a FitAllLayout with the specified horizontal and vertical
alignment for components. |
|
FitAllLayout(int horizontalSpacing,
int verticalSpacing,
int minLeftMargin,
int minRightMargin,
int minTopMargin,
int minBottomMargin)
Creates a FitAllLayout with the specified component spacing
and minimum margins. |
|
FitAllLayout(int horizontalAlignment,
int verticalAlignment,
int horizontalSpacing,
int verticalSpacing,
int minLeftMargin,
int minRightMargin,
int minTopMargin,
int minBottomMargin)
Creates a fully specified FitAllLayout . |
Method Summary | |
void |
addLayoutComponent(java.lang.String name,
java.awt.Component component)
If the layout manager uses a per-component string, adds the specified component to the layout, associating it with the specified name. |
boolean |
equals(java.lang.Object obj)
Indicates whether some other object is "equal to" this one. |
java.awt.Dimension |
getPreferredScrollableViewportSize(java.awt.Container container)
Returns the specified container's preferred scrollable viewport size. |
int |
getScrollableBlockIncrement(java.awt.Container container,
java.awt.Rectangle rectangle,
int orientation,
int direction)
Returns the specified container's scrollable block increment. |
boolean |
getScrollableTracksViewportHeight(java.awt.Container container)
Returns true if a viewport should always force the height of the
specified container to match the height of the viewport. |
boolean |
getScrollableTracksViewportWidth(java.awt.Container container)
Returns true if a viewport should always force the width of the
specified container to match the width of the viewport. |
int |
getScrollableUnitIncrement(java.awt.Container container,
java.awt.Rectangle rectangle,
int orientation,
int direction)
Returns the specified container's scrollable unit increment. |
int |
hashCode()
Returns a hash code value for the object. |
void |
layoutContainer(java.awt.Container container)
Lays out the specified container. |
java.awt.Dimension |
minimumLayoutSize(java.awt.Container container)
Calculates the minimum size dimensions for the specified container, given the components it contains. |
java.awt.Dimension |
preferredLayoutSize(java.awt.Container container)
Calculates the preferred size dimensions for the specified container, given the components it contains. |
double |
preferredScale(java.awt.Container container)
Returns the scale of the specified container's components if the container were to get its preferred size. |
void |
removeLayoutComponent(java.awt.Component component)
Removes the specified component from the layout. |
double |
scaleComponents(java.awt.Container container)
Lays out the container's components and returns the scale factor. |
Methods inherited from class java.lang.Object |
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
public FitAllLayout()
FitAllLayout
. It establishes a horizontal alignment of CENTER,
vertical alignment of CENTER, horizontal spacing of 10, vertical spacing of 10.
minimum left margin of 10, minimum right margin of 10, minimum top margin of 10,
and minimum bottom margin of 10.
FitAllLayout(int,int,int,int,int,int,int,int)
public FitAllLayout(int horizontalAlignment, int verticalAlignment) throws java.lang.IllegalArgumentException
FitAllLayout
with the specified horizontal and vertical
alignment for components. It establishes a horizontal spacing of 10,
vertical spacing of 10.
minimum left margin of 10, minimum right margin of 10, minimum top margin of 10,
and minimum bottom margin of 10.
horizontalAlignment
- Horizontal alignment of components that are
not as wide as the widest component in the container. Acceptable values
are SwingConstants.CENTER, SwingConstants.LEFT, SwingConstants.RIGHT,
SwingConstants.LEADING, and SwingConstants.TRAILING.verticalAlignment
- Vertical alignment of components that are
not as tall as the tallest component in the container. Acceptable values
are SwingConstants.CENTER, SwingConstants.TOP, and SwingConstants.BOTTOM.
java.lang.IllegalArgumentException
- if horizontalAlignment
or
verticalAlignment
are not an acceptable SwingConstant
.FitAllLayout(int,int,int,int,int,int,int,int)
public FitAllLayout(int horizontalSpacing, int verticalSpacing, int minLeftMargin, int minRightMargin, int minTopMargin, int minBottomMargin) throws java.lang.IllegalArgumentException
FitAllLayout
with the specified component spacing
and minimum margins. By default, it uses CENTER for the horizontal
alignment and CENTER for the vertical alignment of components.
horizontalSpacing
- Horizontal spacing between componentsverticalSpacing
- Vertical spacing between componentsminLeftMargin
- Minimum left marginminRightMargin
- Minimum right marginminTopMargin
- Minimum top marginminBottomMargin
- Minimum bottom margin
java.lang.IllegalArgumentException
- if any parameter is negativeFitAllLayout(int,int,int,int,int,int,int,int)
public FitAllLayout(int horizontalAlignment, int verticalAlignment, int horizontalSpacing, int verticalSpacing, int minLeftMargin, int minRightMargin, int minTopMargin, int minBottomMargin) throws java.lang.IllegalArgumentException
FitAllLayout
.
horizontalAlignment
- Horizontal alignment of components that are
not as wide as the widest component in the container. Acceptable values
are SwingConstants.CENTER, SwingConstants.LEFT, SwingConstants.RIGHT,
SwingConstants.LEADING, and SwingConstants.TRAILING.verticalAlignment
- Vertical alignment of components that are
not as tall as the tallest component in the container. Acceptable values
are SwingConstants.CENTER, SwingConstants.TOP, and SwingConstants.BOTTOM.horizontalSpacing
- Horizontal spacing between componentsverticalSpacing
- Vertical spacing between componentsminLeftMargin
- Minimum left marginminRightMargin
- Minimum right marginminTopMargin
- Minimum top marginminBottomMargin
- Minimum bottom margin
java.lang.IllegalArgumentException
- if an alignment argument is not an acceptable
SwingConstant
; if a spacing argument is negative;
or if a margin argument is negativeMethod Detail |
public void addLayoutComponent(java.lang.String name, java.awt.Component component)
addLayoutComponent
in interface java.awt.LayoutManager
name
- the string to be associated with the componentcomponent
- the component to be addedpublic boolean equals(java.lang.Object obj)
equals
in class java.lang.Object
obj
- the reference object with which to compare
true
if this object is the same as obj
public java.awt.Dimension getPreferredScrollableViewportSize(java.awt.Container container)
ScrollableLayoutManager
javax.swing.Scrollable#getPreferredScrollableViewportSize
,
except the container is a parameter instead of the receiver.
getPreferredScrollableViewportSize
in interface ScrollableLayoutManager
container
- Container for which the preferred size is requested
container
public int hashCode()
hashCode
in class java.lang.Object
public double preferredScale(java.awt.Container container)
ScalingLayoutManager
preferredScale
in interface ScalingLayoutManager
container
- container for which to calculate the scale
public int getScrollableBlockIncrement(java.awt.Container container, java.awt.Rectangle rectangle, int orientation, int direction)
ScrollableLayoutManager
javax.swing.Scrollable#getScrollableBlockIncrement
,
except the container is a parameter instead of the receiver.
getScrollableBlockIncrement
in interface ScrollableLayoutManager
container
- The container that is being scrolledrectangle
- The view area visible within the viewportorientation
- The axis of the scrolling--either
SwingConstants.VERTICAL
or SwingConstants.HORIZONTAL
direction
- A negative number to indicate scrolling left or up, or
a positive number to indicate scrolling right or down
public boolean getScrollableTracksViewportHeight(java.awt.Container container)
ScrollableLayoutManager
true
if a viewport should always force the height of the
specified container to match the height of the viewport.
The semantics are the same as
javax.swing.Scrollable#getScrollableTracksViewportHeight
,
except the container is a parameter instead of the receiver.
getScrollableTracksViewportHeight
in interface ScrollableLayoutManager
container
- The container in question
true
if a viewport should keep the
container
's height the same height of the viewportpublic boolean getScrollableTracksViewportWidth(java.awt.Container container)
ScrollableLayoutManager
true
if a viewport should always force the width of the
specified container to match the width of the viewport.
The semantics are the same as
javax.swing.Scrollable#getScrollableTracksViewportWidth
,
except the container is a parameter instead of the receiver.
getScrollableTracksViewportWidth
in interface ScrollableLayoutManager
container
- The container in question
true
if a viewport should keep the
container
's width the same width of the viewportpublic int getScrollableUnitIncrement(java.awt.Container container, java.awt.Rectangle rectangle, int orientation, int direction)
ScrollableLayoutManager
javax.swing.Scrollable#getScrollableUnitIncrement
,
except the container is a parameter instead of the receiver.
getScrollableUnitIncrement
in interface ScrollableLayoutManager
container
- The container that is being scrolledrectangle
- The view area visible within the viewportorientation
- The axis of the scrolling--either
SwingConstants.VERTICAL
or SwingConstants.HORIZONTAL
direction
- A negative number to indicate scrolling left or up, or
a positive number to indicate scrolling right or down
public void layoutContainer(java.awt.Container container)
layoutContainer
in interface java.awt.LayoutManager
container
- the container to be laid outpublic double scaleComponents(java.awt.Container container)
ScalingLayoutManager
scaleComponents
in interface ScalingLayoutManager
container
- container for which to lay out its children
public java.awt.Dimension minimumLayoutSize(java.awt.Container container)
minimumLayoutSize
in interface java.awt.LayoutManager
container
- the container to be laid out
container
public java.awt.Dimension preferredLayoutSize(java.awt.Container container)
preferredLayoutSize
in interface java.awt.LayoutManager
container
- the container to be laid out
container
public void removeLayoutComponent(java.awt.Component component)
removeLayoutComponent
in interface java.awt.LayoutManager
component
- the component to be removed
|
Side of Software Print Preview Library 1.8.1 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |