com.sun.dtv.lwuit
Class List

java.lang.Object
  com.sun.dtv.lwuit.Component
      com.sun.dtv.lwuit.List

All Implemented Interfaces:

Animation, StyleListener, Animated, MatteEnabled, ViewOnlyComponent

Direct Known Subclasses:

ComboBox

public class List
extends Component
implements ViewOnlyComponent

A set of elements that is rendered using a ListCellRenderer and are extracted via the ListModel.

A list can represent many UI concepts ranging from a carousel to a "todo" checklist, this is made possible thanks to extensive use of Swing's style of MVC. Specifically a list component is relatively simple, it invokes the model in order to extract the displayed/selected information and shows it to the user by invoking the cell renderer.

The list class itself is completely decoupled from everything, thus it allows us to extract its content from any source (e.g. network, storage etc.) and display the information in any form (e.g. checkboxed elements, icons etc.).

See Also:

ListModel

Field Summary

static int	FIXED_CENTER Indicates the list selection is fixed into place at the center of the list.
static int	FIXED_LEAD Indicates the list selection is fixed into place at the top of the list or at the left of the list.
static int	FIXED_NONE Indicates the list isn't fixed and that selection is movable.
static int	FIXED_NONE_CYCLIC Indicates that the list is not fixed in place but cycles its elements.
static int	FIXED_NONE_ONE_ELEMENT_MARGIN_FROM_EDGE Indicates the list selection will only reach the edge when there are no more elements in the list.
static int	FIXED_TRAIL Indicates the list selection is fixed into place at the bottom of the list or at the right of the list.
static int	HORIZONTAL Indicates the list orientation is HORIZONTAL.
static int	VERTICAL Indicates the list orientation is VERTICAL.

Fields inherited from class com.sun.dtv.lwuit.Component

BOTTOM, BRB_CENTER_OFFSET, BRB_CONSTANT_ASCENT, BRB_CONSTANT_DESCENT, BRB_OTHER, CENTER, LEFT, RIGHT, TOP

Fields inherited from interface com.sun.dtv.ui.ViewOnlyComponent

HORIZONTAL_ALIGN_CENTER, HORIZONTAL_ALIGN_JUSTIFIED, HORIZONTAL_ALIGN_LEFT, HORIZONTAL_ALIGN_RIGHT, SCALE_ASPECT_PROOF, SCALE_NO, SCALE_NO_ASPECT_PROOF, STATE_DISABLED, STATE_ENABLED, VERTICAL_ALIGN_BOTTOM, VERTICAL_ALIGN_CENTER, VERTICAL_ALIGN_JUSTIFIED, VERTICAL_ALIGN_TOP

Fields inherited from interface com.sun.dtv.ui.Animated

ALTERNATING, LOOP, REPEATING

Constructor Summary

List()
Creates a new instance of List with an empty default model.

List(ListModel model)
Creates a new instance of List with the given model.

List(Object[] items)
Creates a new instance of List.

List(Vector items)
Creates a new instance of List.

Method Summary

void	addActionListener(ActionListener l) Allows binding a listener to user selection actions.
void	addItem(Object item) Allows adding an element to a list if the underlying model supports this, notice that it is an optional operation and if the model does not support it (default list model does) then this operation may failed.
void	addSelectionListener(SelectionListener l) Invoked to indicate interest in future selection events.
boolean	animate() Allows the animation to reduce "repaint" calls when it returns false.
Image[]	getAnimateContent(int state) Returns the animated content for this component, depending on the current state.
int	getBorderGap() Getting the surrounding border gap.
int	getFixedSelection() Indicates whether selection is fixable to place in which case all the elements in the list move and selection stays in place.
Image	getGraphicContent(int state) Returns the graphical content for this component, depending on the current state.
int	getHorizontalAlignment() Retrieve the horizontal alignment for any state-based content in this component.
int	getInteractionState() Return the current interaction state of the component.
int	getItemGap() Returns the gap between items.
Matte	getMatte() Return the Matte currently associated with the component implementing this interface.
ListModel	getModel() Returns the model underlying the list.
int	getOrientation() Returns the list orientation.
ListCellRenderer	getRenderer() Returns the renderer which is used to draw list elements.
Object	getRenderingPrototype() See set rendering prototype.
int	getScalingMode() Retrieve the scaling mode for this component.
int	getSelectedIndex() Returns the current selected offset in the list.
Object	getSelectedItem() Returns the current selected item in the list or null for no selection.
String	getTextContent(int state) Returns the text content for this component, depending on the current state.
TextLayoutManager	getTextLayoutManager() Gets the text layout manager that is currently in use for text layout in this component.
int	getVerticalAlignment() Retrieve the vertical alignment for any state-based content in this component.
boolean	isDoubleBuffered() Returns true if double buffering is available and activated.
boolean	isNumericKeyActions() Indicate whether pressing the number keys should trigger an action.
boolean	isOpaque() Returns true if the whole area of the Component (as returned by the com.sun.dtv.lwuit.Component#getBounds method, is opaque.
boolean	isScrollableX() Indicates whether the component should/could scroll on the X axis.
boolean	isScrollableY() Indicates whether the component should/could scroll on the Y axis.
void	keyPressed(int keyCode) If this Component is focused, the key pressed event will call this method.
void	keyReleased(int keyCode) If this Component is focused, the key released event will call this method.
void	paint(Graphics g) This method paints the Component on the screen, it should be overriden by subclasses to perform custom drawing or invoke the UI API's to let the PLAF perform the rendering.
void	pointerDragged(int x, int y) If this Component is focused, the pointer dragged event will call this method.
void	pointerReleased(int x, int y) If this Component is focused, the pointer released event will call this method.
void	processEvent(AWTEvent event) Handle the specified AWTEvent.
void	refreshTheme() Makes sure the component is up to date with the current style object.
void	removeActionListener(ActionListener l) Allows binding a listener to user selection actions.
void	removeSelectionListener(SelectionListener l) Invoked to indicate no further interest in future selection events.
void	scrollRectToVisible(Rectangle rect) Makes sure the selected index is visible if it is not in the current view rect the list will scroll so it fits within.
void	setAnimateContent(Image[] images, int state) Assigns an array of graphical content to be used for animation to this component which is state-dependent.
void	setBorderGap(int borderGap) Setting the surrounding border gap.
void	setFixedSelection(int fixedSelection) Indicates whether selection is fixable to place in which case all the elements in the list move and selection stays in place.
void	setGraphicContent(Image image, int state) Assigns graphical content to this component which is state-dependent.
void	setHandlesInput(boolean b) Prevents key events from being grabbed for focus traversal.
void	setHorizontalAlignment(int alignment) Set the horizontal alignment for any state-based content in this component.
void	setInputOnFocus(boolean inputOnFocus) A list can start handling input implicitly upon gaining focus, this can make for a more intuitive UI when no other focus elements exist or when their use case is infrequent.
void	setInteractionState(int state) Set the current state of the component with respect to interaction.
void	setItemGap(int itemGap) Set the gap between items.
void	setListCellRenderer(ListCellRenderer renderer) Sets the renderer which is used to draw list elements.
void	setMatte(Matte matte) Adds an Matte to the component implementing this interface in order to enable matte compositing.
void	setModel(ListModel model) Replaces/sets the model underlying the list.
void	setNumericKeyActions(boolean numericKeyActions) Indicate whether pressing the number keys should trigger an action.
void	setOrientation(int orientation) Sets the list orientation HORIZONTAL or VERTICAL.
void	setPaintFocusBehindList(boolean paintFocusBehindList) This method determines if the animated focus is drawn on top of the List or behind the List when moving.
void	setRenderingPrototype(Object renderingPrototype) The rendering prototype is optionally used in calculating the size of the List and is recommended for performance reasons.
void	setScalingMode(int scaling) Set the scaling mode for this component.
void	setSelectedIndex(int index) Sets the current selected offset in the list, by default this implementation will scroll the list to the selection if the selection is outside of the screen.
void	setSelectedIndex(int index, boolean scrollToSelection) Sets the current selected offset in the list.
void	setSelectedItem(Object item) Sets the current selected item in the list.
void	setTextContent(String text, int state) Assigns text content to this component which is state-dependent.
void	setTextLayoutManager(TextLayoutManager manager) Sets the text layout manager that should be used for text layout in this component.
void	setVerticalAlignment(int valign) Set the vertical alignment for any state-based content in this component.
int	size() Returns the number of elements in the list, shorthand for getModel().getSize().

Methods inherited from class com.sun.dtv.lwuit.Component

addFocusListener, calcPreferredSize, contains, deinitialize, getAbsoluteX, getAbsoluteY, getAnimationMode, getBaseline, getBaselineResizeBehavior, getBottomGap, getBounds, getClientProperty, getComponentForm, getDelay, getHeight, getNextFocusDown, getNextFocusLeft, getNextFocusRight, getNextFocusUp, getParent, getPosition, getPreferredSize, getRepetitionMode, getScrollAnimationSpeed, getScrollX, getScrollY, getSideGap, getStyle, getUIID, getWidth, getX, getY, handlesInput, hasFocus, initialize, isEnabled, isFocusable, isFocusPainted, isInitialized, isRunning, isScrollVisible, isSmoothScrolling, isVisible, jumpTo, keyRepeated, longKeyPress, paintBackgrounds, paintComponent, paintComponent, pointerPressed, putClientProperty, removeFocusListener, repaint, repaint, requestFocus, scrollRectToVisible, setAnimationMode, setCellRenderer, setDelay, setEnabled, setFocus, setFocusable, setFocusPainted, setHeight, setInitialized, setIsScrollVisible, setNextFocusDown, setNextFocusLeft, setNextFocusRight, setNextFocusUp, setPreferredSize, setRepetitionMode, setScrollAnimationSpeed, setScrollX, setScrollY, setShouldCalcPreferredSize, setSize, setSmoothScrolling, setStyle, setUIID, setVisible, setWidth, setX, setY, start, stop, styleChanged, toString

Methods inherited from class java.lang.Object

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

Field Detail

FIXED_NONE

public static final int FIXED_NONE

Indicates the list isn't fixed and that selection is movable.

See Also:

Constant Field Values

FIXED_NONE_CYCLIC

public static final int FIXED_NONE_CYCLIC

Indicates that the list is not fixed in place but cycles its elements.

See Also:

Constant Field Values

FIXED_NONE_ONE_ELEMENT_MARGIN_FROM_EDGE

public static final int FIXED_NONE_ONE_ELEMENT_MARGIN_FROM_EDGE

Indicates the list selection will only reach the edge when there are no more elements in the list.

See Also:

Constant Field Values

FIXED_LEAD

public static final int FIXED_LEAD

Indicates the list selection is fixed into place at the top of the list or at the left of the list.

See Also:

Constant Field Values

FIXED_TRAIL

public static final int FIXED_TRAIL

Indicates the list selection is fixed into place at the bottom of the list or at the right of the list.

See Also:

Constant Field Values

FIXED_CENTER

public static final int FIXED_CENTER

Indicates the list selection is fixed into place at the center of the list.

See Also:

Constant Field Values

VERTICAL

public static final int VERTICAL

Indicates the list orientation is VERTICAL.

See Also:

Constant Field Values

HORIZONTAL

public static final int HORIZONTAL

Indicates the list orientation is HORIZONTAL.

See Also:

Constant Field Values

Constructor Detail

List

public List(Vector items)

Creates a new instance of List.

Parameters:

items - set of items placed into the list model

List

public List(Object[] items)

Creates a new instance of List.

Parameters:

items - set of items placed into the list model

List

public List()

Creates a new instance of List with an empty default model.

List

public List(ListModel model)

Creates a new instance of List with the given model.

Parameters:

model - the model instance

Method Detail

isScrollableY

public boolean isScrollableY()

Description copied from class: Component

Indicates whether the component should/could scroll on the Y axis.

Overrides:

isScrollableY in class Component

Returns:

whether the component is scrollable on the X axis

isScrollableX

public boolean isScrollableX()

Description copied from class: Component

Indicates whether the component should/could scroll on the X axis.

Overrides:

isScrollableX in class Component

Returns:

whether the component is scrollable on the X axis

size

public int size()

Returns the number of elements in the list, shorthand for getModel().getSize().

Returns:

the number of elements in the list

getSelectedIndex

public int getSelectedIndex()

Returns the current selected offset in the list.

Returns:

the current selected offset in the list

See Also:

setSelectedIndex(int), setSelectedIndex(int, boolean)

setSelectedIndex

public void setSelectedIndex(int index)

Sets the current selected offset in the list, by default this implementation will scroll the list to the selection if the selection is outside of the screen.

Parameters:

index - the current selected offset in the list

See Also:

getSelectedIndex()

setSelectedIndex

public void setSelectedIndex(int index,
                             boolean scrollToSelection)

Sets the current selected offset in the list.

Parameters:

index - the current selected offset in the list

scrollToSelection - indicates whether scrolling to selection should occur if the selection is outside of view

See Also:

getSelectedIndex()

getSelectedItem

public Object getSelectedItem()

Returns the current selected item in the list or null for no selection.

Returns:

the current selected item in the list

See Also:

setSelectedItem(java.lang.Object)

setSelectedItem

public void setSelectedItem(Object item)

Sets the current selected item in the list.

Parameters:

item - the current selected item in the list

See Also:

getSelectedItem()

getModel

public ListModel getModel()

Returns the model underlying the list.

Returns:

the model underlying the list

See Also:

setModel(com.sun.dtv.lwuit.list.ListModel)

setModel

public void setModel(ListModel model)

Replaces/sets the model underlying the list.

Parameters:

model - the new model underlying the list

See Also:

getModel()

isNumericKeyActions

public boolean isNumericKeyActions()

Indicate whether pressing the number keys should trigger an action.

Returns:

true if pressing the number keys should trigger an action, false otherwise

setNumericKeyActions

public void setNumericKeyActions(boolean numericKeyActions)

Indicate whether pressing the number keys should trigger an action.

Parameters:

numericKeyActions - true to trigger an action on number keys

setListCellRenderer

public void setListCellRenderer(ListCellRenderer renderer)

Sets the renderer which is used to draw list elements.

Parameters:

renderer - cell renderer instance

getRenderer

public ListCellRenderer getRenderer()

Returns the renderer which is used to draw list elements.

Returns:

the renderer which is used to draw list elements

getOrientation

public int getOrientation()

Returns the list orientation.

Returns:

the list orientation HORIZONTAL or VERTICAL

See Also:

setOrientation(int), HORIZONTAL, VERTICAL

refreshTheme

public void refreshTheme()

Description copied from class: Component

Makes sure the component is up to date with the current style object.

Overrides:

refreshTheme in class Component

setOrientation

public void setOrientation(int orientation)

Sets the list orientation HORIZONTAL or VERTICAL.

Parameters:

orientation - the list orientation HORIZONTAL or VERTICAL

See Also:

getOrientation(), HORIZONTAL, VERTICAL

scrollRectToVisible

public void scrollRectToVisible(Rectangle rect)

Makes sure the selected index is visible if it is not in the current view rect the list will scroll so it fits within.

Parameters:

rect - the rectangle area to scroll to

setHandlesInput

public void setHandlesInput(boolean b)

Description copied from class: Component

Prevents key events from being grabbed for focus traversal. E.g. a list component might use the arrow keys for internal navigation so it will switch this flag to true in order to prevent the focus manager from moving to the next component.

Overrides:

setHandlesInput in class Component

Parameters:

b - indicates whether key events can be grabbed for focus traversal

keyReleased

public void keyReleased(int keyCode)

Description copied from class: Component

If this Component is focused, the key released event will call this method.

Overrides:

keyReleased in class Component

Parameters:

keyCode - the key code value to indicate a physical key.

keyPressed

public void keyPressed(int keyCode)

Description copied from class: Component

If this Component is focused, the key pressed event will call this method.

Overrides:

keyPressed in class Component

Parameters:

keyCode - the key code value to indicate a physical key.

paint

public void paint(Graphics g)

Description copied from class: Component

This method paints the Component on the screen, it should be overriden by subclasses to perform custom drawing or invoke the UI API's to let the PLAF perform the rendering.

Specified by:

paint in interface Animation

Specified by:

paint in interface ViewOnlyComponent

Overrides:

paint in class Component

Parameters:

g - the component graphics

addSelectionListener

public void addSelectionListener(SelectionListener l)

Invoked to indicate interest in future selection events.

Parameters:

l - the selection listener to be added

See Also:

removeSelectionListener(com.sun.dtv.lwuit.events.SelectionListener)

removeSelectionListener

public void removeSelectionListener(SelectionListener l)

Invoked to indicate no further interest in future selection events.

Parameters:

l - the selection listener to be removed

See Also:

addSelectionListener(com.sun.dtv.lwuit.events.SelectionListener)

addActionListener

public void addActionListener(ActionListener l)

Allows binding a listener to user selection actions.

Parameters:

l - the action listener to be added

See Also:

removeActionListener(com.sun.dtv.lwuit.events.ActionListener)

removeActionListener

public void removeActionListener(ActionListener l)

Allows binding a listener to user selection actions.

Parameters:

l - the action listener to be removed

See Also:

addActionListener(com.sun.dtv.lwuit.events.ActionListener)

setInputOnFocus

public void setInputOnFocus(boolean inputOnFocus)

A list can start handling input implicitly upon gaining focus, this can make for a more intuitive UI when no other focus elements exist or when their use case is infrequent. However, it might be odd in some cases where the list "steals" focus.

Parameters:

inputOnFocus - true is a list can start handling input implicitly upon gaining focus

setPaintFocusBehindList

public void setPaintFocusBehindList(boolean paintFocusBehindList)

This method determines if the animated focus is drawn on top of the List or behind the List when moving.

Parameters:

paintFocusBehindList - true for behind, false for on top

getItemGap

public int getItemGap()

Returns the gap between items.

Returns:

the gap between items

See Also:

setItemGap(int)

setItemGap

public void setItemGap(int itemGap)

Set the gap between items.

Parameters:

itemGap - the gap between items

See Also:

getItemGap()

setRenderingPrototype

public void setRenderingPrototype(Object renderingPrototype)

The rendering prototype is optionally used in calculating the size of the List and is recommended for performance reasons. You should invoke it with an object representing a theoretical value in the list which will be used to calculate the size required for each element in the list.

This allows list size calculations to work across look and feels and allows developers to predetermine size for list elements.

e.g. For a list of Strings which you would like to always be 5 characters wide you can use a prototype "XXXXX" which would use the preferred size of the XXXXX String to determine the size of the list element. E.g. for a list of dates you can use new Date(30, 12, 00) etc..

Parameters:

renderingPrototype - a value that can be passed to the renderer to indicate the preferred size of a list component.

See Also:

getRenderingPrototype()

getRenderingPrototype

public Object getRenderingPrototype()

See set rendering prototype.

Returns:

the value of the rendering prototype

See Also:

setRenderingPrototype(java.lang.Object)

pointerDragged

public void pointerDragged(int x,
                           int y)

Description copied from class: Component

If this Component is focused, the pointer dragged event will call this method.

Overrides:

pointerDragged in class Component

Parameters:

x - the pointer x coordinate

y - the pointer y coordinate

pointerReleased

public void pointerReleased(int x,
                            int y)

Description copied from class: Component

If this Component is focused, the pointer released event will call this method.

Overrides:

pointerReleased in class Component

Parameters:

x - the pointer x coordinate

y - the pointer y coordinate

addItem

public void addItem(Object item)

Allows adding an element to a list if the underlying model supports this, notice that it is an optional operation and if the model does not support it (default list model does) then this operation may failed.

Parameters:

item - the item to be added to a list model

getFixedSelection

public int getFixedSelection()

Indicates whether selection is fixable to place in which case all the elements in the list move and selection stays in place.

Returns:

one of: FIXED_NONE, FIXED_TRAIL, FIXED_LEAD, FIXED_CENTER, FIXED_NONE_CYCLIC

See Also:

setFixedSelection(int)

setFixedSelection

public void setFixedSelection(int fixedSelection)

Indicates whether selection is fixable to place in which case all the elements in the list move and selection stays in place.

Parameters:

fixedSelection - one of: FIXED_NONE, FIXED_TRAIL, FIXED_LEAD, FIXED_CENTER, FIXED_NONE_CYCLIC

See Also:

getFixedSelection()

animate

public boolean animate()

Description copied from interface: Animation

Allows the animation to reduce "repaint" calls when it returns false. It is called once for every frame.

Specified by:

animate in interface Animation

Overrides:

animate in class Component

Returns:

true if a repaint is desired or false if no repaint is necessary

setBorderGap

public void setBorderGap(int borderGap)

Setting the surrounding border gap.

Parameters:

borderGap - number of pixels for the gap

See Also:

getBorderGap()

getBorderGap

public int getBorderGap()

Getting the surrounding border gap.

Returns:

border gap in pixels

See Also:

setBorderGap(int)

setTextContent

public void setTextContent(String text,
                           int state)
                    throws IllegalArgumentException

Description copied from interface: ViewOnlyComponent

Assigns text content to this component which is state-dependent.

Specified by:

setTextContent in interface ViewOnlyComponent

Parameters:

text - the text content, or null (removes text content which had been assigned before)

state - the state of the component for which this content should be displayed, one of STATE_ENABLED or STATE_DISABLED

Throws:

IllegalArgumentException - if the state parameter does not represent a state

See Also:

ViewOnlyComponent.getTextContent(int)

setGraphicContent

public void setGraphicContent(Image image,
                              int state)
                       throws IllegalArgumentException

Description copied from interface: ViewOnlyComponent

Assigns graphical content to this component which is state-dependent.

Specified by:

setGraphicContent in interface ViewOnlyComponent

Parameters:

image - the graphical content, or null (removes graphical content which had been assigned before)

state - the state of the component for which this content should be displayed, one of STATE_ENABLED or STATE_DISABLED

Throws:

IllegalArgumentException - if the state parameter does not represent a state

See Also:

ViewOnlyComponent.getGraphicContent(int)

setAnimateContent

public void setAnimateContent(Image[] images,
                              int state)
                       throws IllegalArgumentException

Description copied from interface: ViewOnlyComponent

Assigns an array of graphical content to be used for animation to this component which is state-dependent.

Specified by:

setAnimateContent in interface ViewOnlyComponent

Parameters:

images - the graphical content array, or null (removes any graphical content which had been assigned before)

state - the state of the component for which this content should be displayed, one of STATE_ENABLED or STATE_DISABLED

Throws:

IllegalArgumentException - if the state parameter does not represent a state

See Also:

ViewOnlyComponent.getAnimateContent(int)

getTextContent

public String getTextContent(int state)
                      throws IllegalArgumentException

Description copied from interface: ViewOnlyComponent

Returns the text content for this component, depending on the current state.

Specified by:

getTextContent in interface ViewOnlyComponent

Parameters:

state - the state of the component for which this content is to be retrieved, one of STATE_ENABLED or STATE_DISABLED

Returns:

The text content associated with the specified state, or null if there is none.

Throws:

IllegalArgumentException - if the state parameter does not represent a state

See Also:

ViewOnlyComponent.setTextContent(java.lang.String, int)

getGraphicContent

public Image getGraphicContent(int state)
                        throws IllegalArgumentException

Description copied from interface: ViewOnlyComponent

Returns the graphical content for this component, depending on the current state.

Specified by:

getGraphicContent in interface ViewOnlyComponent

Parameters:

state - the state of the component for which this content is to be retrieved, one of STATE_ENABLED or STATE_DISABLED

Returns:

The graphical content associated with the specified state, or null if there is none.

Throws:

IllegalArgumentException - if the state parameter does not represent a state

See Also:

ViewOnlyComponent.setGraphicContent(com.sun.dtv.lwuit.Image, int)

getAnimateContent

public Image[] getAnimateContent(int state)
                          throws IllegalArgumentException

Description copied from interface: ViewOnlyComponent

Returns the animated content for this component, depending on the current state.

Specified by:

getAnimateContent in interface ViewOnlyComponent

Parameters:

state - the state of the component for which this content is to be retrieved, one of STATE_ENABLED or STATE_DISABLED

Returns:

The graphical content associated with the specified state, or null if there is none.

Throws:

IllegalArgumentException - if the state parameter does not represent a state

See Also:

ViewOnlyComponent.setAnimateContent(com.sun.dtv.lwuit.Image[], int)

setInteractionState

public void setInteractionState(int state)
                         throws IllegalArgumentException

Description copied from interface: ViewOnlyComponent

Set the current state of the component with respect to interaction.

Specified by:

setInteractionState in interface ViewOnlyComponent

Parameters:

state - the interaction state for this content, one of STATE_ENABLED or STATE_DISABLED

Throws:

IllegalArgumentException - if the state parameter does not represent a state

See Also:

ViewOnlyComponent.getInteractionState()

getInteractionState

public int getInteractionState()

Description copied from interface: ViewOnlyComponent

Return the current interaction state of the component.

Specified by:

getInteractionState in interface ViewOnlyComponent

Returns:

the current interaction state of the component.

See Also:

ViewOnlyComponent.setInteractionState(int)

setTextLayoutManager

public void setTextLayoutManager(TextLayoutManager manager)

Description copied from interface: ViewOnlyComponent

Sets the text layout manager that should be used for text layout in this component.

Specified by:

setTextLayoutManager in interface ViewOnlyComponent

Parameters:

manager - the TextLayoutManager

See Also:

ViewOnlyComponent.getTextLayoutManager()

getTextLayoutManager

public TextLayoutManager getTextLayoutManager()

Description copied from interface: ViewOnlyComponent

Gets the text layout manager that is currently in use for text layout in this component.

Specified by:

getTextLayoutManager in interface ViewOnlyComponent

Returns:

the TextLayoutManager

See Also:

ViewOnlyComponent.setTextLayoutManager(com.sun.dtv.ui.TextLayoutManager)

setHorizontalAlignment

public void setHorizontalAlignment(int alignment)

Description copied from interface: ViewOnlyComponent

Set the horizontal alignment for any state-based content in this component.

Specified by:

setHorizontalAlignment in interface ViewOnlyComponent

Parameters:

alignment - the horizontal alignment mode, one of ViewOnlyComponent.HORIZONTAL_ALIGN_LEFT, ViewOnlyComponent.HORIZONTAL_ALIGN_CENTER, ViewOnlyComponent.HORIZONTAL_ALIGN_RIGHT or ViewOnlyComponent.HORIZONTAL_ALIGN_JUSTIFIED.

See Also:

ViewOnlyComponent.getHorizontalAlignment()

getHorizontalAlignment

public int getHorizontalAlignment()

Description copied from interface: ViewOnlyComponent

Retrieve the horizontal alignment for any state-based content in this component.

Specified by:

getHorizontalAlignment in interface ViewOnlyComponent

Returns:

the current horizontal alignment mode, one of ViewOnlyComponent.HORIZONTAL_ALIGN_LEFT, ViewOnlyComponent.HORIZONTAL_ALIGN_CENTER, ViewOnlyComponent.HORIZONTAL_ALIGN_RIGHT or ViewOnlyComponent.HORIZONTAL_ALIGN_JUSTIFIED.

See Also:

ViewOnlyComponent.setHorizontalAlignment(int)

setScalingMode

public void setScalingMode(int scaling)

Description copied from interface: ViewOnlyComponent

Set the scaling mode for this component.

Specified by:

setScalingMode in interface ViewOnlyComponent

Parameters:

scaling - the scaling mode, one of ViewOnlyComponent.SCALE_NO, ViewOnlyComponent.SCALE_NO_ASPECT_PROOF or ViewOnlyComponent.SCALE_ASPECT_PROOF.

See Also:

ViewOnlyComponent.getScalingMode()

getScalingMode

public int getScalingMode()

Description copied from interface: ViewOnlyComponent

Retrieve the scaling mode for this component.

Specified by:

getScalingMode in interface ViewOnlyComponent

Returns:

the current scaling mode, one of ViewOnlyComponent.SCALE_NO, ViewOnlyComponent.SCALE_NO_ASPECT_PROOF or ViewOnlyComponent.SCALE_ASPECT_PROOF.

See Also:

ViewOnlyComponent.setScalingMode(int)

isDoubleBuffered

public boolean isDoubleBuffered()

Description copied from interface: ViewOnlyComponent

Returns true if double buffering is available and activated.

Specified by:

isDoubleBuffered in interface ViewOnlyComponent

Returns:

true if double buffering is available and activated, and false otherwise

isOpaque

public boolean isOpaque()

Description copied from interface: ViewOnlyComponent

Returns true if the whole area of the Component (as returned by the com.sun.dtv.lwuit.Component#getBounds method, is opaque.

Specified by:

isOpaque in interface ViewOnlyComponent

Returns:

true if all the pixels within the area defined by the com.sun.dtv.lwuit.Component#getBounds method are opaque, i.e. all pixels are painted in an opaque color, false otherwise.

processEvent

public void processEvent(AWTEvent event)

Description copied from interface: ViewOnlyComponent

Handle the specified AWTEvent.

Specified by:

processEvent in interface ViewOnlyComponent

Parameters:

event - a java.awt.AWTEvent to handle.

setMatte

public void setMatte(Matte matte)
              throws MatteException

Description copied from interface: MatteEnabled

Adds an Matte to the component implementing this interface in order to enable matte compositing. If there is already a Matte assigned to the component, and this Matte is animated, it has to be stopped before any call to this method.

Specified by:

setMatte in interface MatteEnabled

Parameters:

matte - the Matte to be assigned to the component. At any point of time there can only be one matte associated to the component, that's way any matte that has been associated before will be overriden by a call to this method. The Matte parameter can also be null, in this case there is no matte associated with the component after the call, even if there had been one before.

Throws:

MatteException - if the Matte has an unsupported type, the platform does not support mattes at all, or an animated matte is associated with the component and is still running

See Also:

MatteEnabled.getMatte()

getMatte

public Matte getMatte()

Description copied from interface: MatteEnabled

Return the Matte currently associated with the component implementing this interface.

Specified by:

getMatte in interface MatteEnabled

Returns:

the Matte currently associated with the component or null if there is none

See Also:

MatteEnabled.setMatte(com.sun.dtv.ui.Matte)

setVerticalAlignment

public void setVerticalAlignment(int valign)

Description copied from interface: ViewOnlyComponent

Set the vertical alignment for any state-based content in this component.

Specified by:

setVerticalAlignment in interface ViewOnlyComponent

Parameters:

valign - the vertical alignment mode, one of ViewOnlyComponent.VERTICAL_ALIGN_TOP, ViewOnlyComponent.VERTICAL_ALIGN_CENTER, ViewOnlyComponent.VERTICAL_ALIGN_BOTTOM or ViewOnlyComponent.VERTICAL_ALIGN_JUSTIFIED.

See Also:

ViewOnlyComponent.getVerticalAlignment()

getVerticalAlignment

public int getVerticalAlignment()

Description copied from interface: ViewOnlyComponent

Retrieve the vertical alignment for any state-based content in this component.

Specified by:

getVerticalAlignment in interface ViewOnlyComponent

Returns:

the current horizontal alignment mode, one of ViewOnlyComponent.VERTICAL_ALIGN_TOP, ViewOnlyComponent.VERTICAL_ALIGN_CENTER, ViewOnlyComponent.VERTICAL_ALIGN_BOTTOM or ViewOnlyComponent.VERTICAL_ALIGN_JUSTIFIED.

See Also:

ViewOnlyComponent.setVerticalAlignment(int)