FileDocCategorySizeDatePackage
Spacer.javaAPI DocphoneME MR2 API (J2ME)5923Wed May 02 18:00:22 BST 2007javax.microedition.lcdui

Spacer

public class Spacer extends Item
A blank, non-interactive item that has a settable minimum size. The minimum width is useful for allocating flexible amounts of space between Items within the same row of a Form. The minimum height is useful for enforcing a particular minimum height of a row. The application can set the minimum width or height to any non-negative value. The implementation may enforce implementation-defined maximum values for the minimum width and height.

The unlocked preferred width of a Spacer is the same as its current minimum width. Its unlocked preferred height is the same as its current minimum height.

Since a Spacer's primary purpose is to position other items, it is restricted to be non-interactive, and the application is not allowed to add Commands to a Spacer. Since the presence of a label on an Item may affect layout in device-specific ways, the label of a Spacer is restricted to always be null, and the application is not allowed to change it.

Fields Summary
SpacerLF
spacerLF
Spacer Look & Feel associated with this Spacer
int
width
The preferred (and minimum) width of this Spacer
int
height
The preferred (and minimum) height of this Spacer
Constructors Summary
public Spacer(int minWidth, int minHeight)
Creates a new Spacer with the given minimum size. The Spacer's label is null. The minimum size must be zero or greater. If minWidth is greater than the implementation-defined maximum width, the maximum width will be used instead. If minHeight is greater than the implementation-defined maximum height, the maximum height will be used instead.

param
minWidth the minimum width in pixels
param
minHeight the minimum height in pixels
throws
IllegalArgumentException if either minWidth or minHeight is less than zero

        super(null);

        if (minWidth < 0 || minHeight < 0) {
             throw new IllegalArgumentException();
        }

        synchronized (Display.LCDUILock) {
            width  = minWidth;
            height = minHeight;

	    itemLF = spacerLF = LFFactory.getFactory().getSpacerLF(this);
        }
Methods Summary
public voidaddCommand(Command cmd)
Spacers are restricted from having Commands, so this method will always throw IllegalStateException whenever it is called.

param
cmd the Command
throws
IllegalStateException always

        throw new IllegalStateException();
public voidsetDefaultCommand(Command cmd)
Spacers are restricted from having Commands, so this method will always throw IllegalStateException whenever it is called.

param
cmd the Command
throws
IllegalStateException always

        throw new IllegalStateException();
public voidsetLabel(java.lang.String label)
Spacers are restricted to having null labels, so this method will always throw IllegalStateException whenever it is called.

param
label the label string
throws
IllegalStateException always

 
        throw new IllegalStateException();
public voidsetMinimumSize(int minWidth, int minHeight)
Sets the minimum size for this spacer. The Form will not be allowed to make the item smaller than this size. The minimum size must be zero or greater. If minWidth is greater than the implementation-defined maximum width, the maximum width will be used instead. If minHeight is greater than the implementation-defined maximum height, the maximum height will be used instead.

param
minWidth the minimum width in pixels
param
minHeight the minimum height in pixels
throws
IllegalArgumentException if either minWidth or minHeight is less than zero

        if (minWidth < 0 || minHeight < 0) {
             throw new IllegalArgumentException();
        }

        synchronized (Display.LCDUILock) {
            width  = minWidth;
            height = minHeight;

	    spacerLF.lSetMinimumSize(minWidth, minHeight);
        }