Class LayoutStyle

java.lang.Object

javax.swing.LayoutStyle

public abstract class LayoutStyle
extends Object

LayoutStyle provides information about how to position components. This class is primarily useful for visual tools and layout managers. Most developers will not need to use this class.

You typically don't set or create a LayoutStyle. Instead use the static method getInstance to obtain the current instance.

Since:

1.6

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	LayoutStyle.ComponentPlacement	ComponentPlacement is an enumeration of the possible ways two components can be placed relative to each other.

Constructor Summary

Constructors

Constructor	Description
LayoutStyle()	Creates a new LayoutStyle.

Method Summary

Modifier and Type	Method	Description
abstract int	getContainerGap(JComponent component, int position, Container parent)	Returns the amount of space to place between the component and specified edge of its parent.
static LayoutStyle	getInstance()	Returns the shared instance of LayoutStyle.
abstract int	getPreferredGap(JComponent component1, JComponent component2, LayoutStyle.ComponentPlacement type, int position, Container parent)	Returns the amount of space to use between two components.
static void	setInstance(LayoutStyle style)	Sets the shared instance of LayoutStyle.

Methods declared in class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Modifier and Type	Method	Description
protected Object	clone()	Answers a new instance of the same class as the receiver, whose slots have been filled in with the values in the slots of the receiver.
boolean	equals(Object o)	Compares the argument to the receiver, and answers true if they represent the same object using a class specific comparison.
protected void	finalize()	Deprecated, for removal: This API element is subject to removal in a future version. May cause performance issues, deadlocks and hangs.
final Class<? extends Object>	getClass()	Answers the unique instance of java.lang.Class which represents the class of the receiver.
int	hashCode()	Answers an integer hash code for the receiver.
final void	notify()	Causes one thread which is waiting on the receiver to be made ready to run.
final void	notifyAll()	Causes all threads which are waiting on the receiver to be made ready to run.
String	toString()	Answers a string containing a concise, human-readable description of the receiver.
final void	wait()	Causes the thread which sent this message to be made not ready to run pending some change in the receiver (as indicated by notify or notifyAll).
final void	wait(long time)	Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.
final void	wait(long time, int frac)	Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.

Constructor Details

LayoutStyle

public LayoutStyle()

Creates a new LayoutStyle. You generally don't create a LayoutStyle. Instead use the method getInstance to obtain the current LayoutStyle.

Method Details

setInstance

public static void setInstance(LayoutStyle style)

Sets the shared instance of LayoutStyle. Specifying null results in using the LayoutStyle from the current LookAndFeel.

Parameters:

style - the LayoutStyle, or null

See Also:

• getInstance()

getInstance

public static LayoutStyle getInstance()

Returns the shared instance of LayoutStyle. If an instance has not been specified in setInstance, this will return the LayoutStyle from the current LookAndFeel.

Returns:

the shared instance of LayoutStyle

See Also:

• LookAndFeel.getLayoutStyle()

getPreferredGap

public abstract int getPreferredGap(JComponent component1,
 JComponent component2,
 LayoutStyle.ComponentPlacement type,
 int position,
 Container parent)

Returns the amount of space to use between two components. The return value indicates the distance to place component2 relative to component1. For example, the following returns the amount of space to place between component2 and component1 when component2 is placed vertically above component1:

  int gap = getPreferredGap(component1, component2,
                            ComponentPlacement.RELATED,
                            SwingConstants.NORTH, parent);

The type parameter indicates the relation between the two components. If the two components will be contained in the same parent and are showing similar logically related items, use RELATED. If the two components will be contained in the same parent but show logically unrelated items use UNRELATED. Some look and feels may not distinguish between the RELATED and UNRELATED types.

The return value is not intended to take into account the current size and position of component2 or component1. The return value may take into consideration various properties of the components. For example, the space may vary based on font size, or the preferred size of the component.

Parameters:

component1 - the JComponent component2 is being placed relative to

component2 - the JComponent being placed

type - how the two components are being placed

position - the position component2 is being placed relative to component1; one of SwingConstants.NORTH, SwingConstants.SOUTH, SwingConstants.EAST or SwingConstants.WEST

parent - the parent of component2; this may differ from the actual parent and it may be null

Returns:

the amount of space to place between the two components

Throws:

NullPointerException - if component1, component2 or type is null

IllegalArgumentException - if position is not one of SwingConstants.NORTH, SwingConstants.SOUTH, SwingConstants.EAST or SwingConstants.WEST

Since:

1.6

See Also:

• LookAndFeel.getLayoutStyle()

getContainerGap

public abstract int getContainerGap(JComponent component,
 int position,
 Container parent)

Returns the amount of space to place between the component and specified edge of its parent.

Parameters:

component - the JComponent being positioned

position - the position component is being placed relative to its parent; one of SwingConstants.NORTH, SwingConstants.SOUTH, SwingConstants.EAST or SwingConstants.WEST

parent - the parent of component; this may differ from the actual parent and may be null

Returns:

the amount of space to place between the component and specified edge

Throws:

IllegalArgumentException - if position is not one of SwingConstants.NORTH, SwingConstants.SOUTH, SwingConstants.EAST or SwingConstants.WEST