BenQ Mobile

javax.microedition.lcdui
Class Spacer

java.lang.Object
  extended byjavax.microedition.lcdui.Item
      extended byjavax.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.

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.

Since:
MIDP 2.0

Field Summary
 
Fields inherited from class javax.microedition.lcdui.Item
BUTTON, HYPERLINK, LAYOUT_2, LAYOUT_BOTTOM, LAYOUT_CENTER, LAYOUT_DEFAULT, LAYOUT_EXPAND, LAYOUT_LEFT, LAYOUT_NEWLINE_AFTER, LAYOUT_NEWLINE_BEFORE, LAYOUT_RIGHT, LAYOUT_SHRINK, LAYOUT_TOP, LAYOUT_VCENTER, LAYOUT_VEXPAND, LAYOUT_VSHRINK, PLAIN
 
Constructor Summary
Spacer(int minWidth, int minHeight)
          Creates a new Spacer with the given minimum size.
 
Method Summary
 void addCommand(Command cmd)
          Spacers are restricted from having Commands, so this method will always throw IllegalStateException whenever it is called.
 void setDefaultCommand(Command cmd)
          Spacers are restricted from having Commands, so this method will always throw IllegalStateException whenever it is called.
 void setLabel(java.lang.String label)
          Spacers are restricted to having null labels, so this method will always throw IllegalStateException whenever it is called.
 void setMinimumSize(int width, int height)
          Sets the minimum size for this spacer.
 
Methods inherited from class javax.microedition.lcdui.Item
getLabel, getLayout, getMinimumHeight, getMinimumWidth, getPreferredHeight, getPreferredWidth, notifyStateChanged, removeCommand, setItemCommandListener, setLayout, setPreferredSize
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

Spacer

public Spacer(int minWidth,
              int minHeight)
Creates a new Spacer with the given minimum size. The Spacer's label is null.

Parameters:
minWidth - the minimum width in pixels
minHeight - the minimum height in pixels
Method Detail

setMinimumSize

public void setMinimumSize(int width,
                           int height)
Sets the minimum size for this spacer. The Form will not be allowed to make the item smaller than this size.

Parameters:
width - The minimum width
height - The minimum height
Since:
MIDP 2.0

addCommand

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

Overrides:
addCommand in class Item
Parameters:
cmd - the Command
Throws:
java.lang.IllegalStateException - always

setDefaultCommand

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

Overrides:
setDefaultCommand in class Item
Parameters:
cmd - the Command
Throws:
java.lang.IllegalStateException - always

setLabel

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

Overrides:
setLabel in class Item
Parameters:
label - the label string
Throws:
java.lang.IllegalStateException - always
See Also:
Item.getLabel()

BenQ Mobile

Copyright © 2006 BenQ Mobile GmbH & Co. OHG or respective copyright owner.
All Rights Reserved.
BenQ Corp. is a trademark licensee of Siemens AG.


For further information about Mobility Toolkit (MTK) visit our Developer Portal.