de.enough.polish.ui
Class FakeStringCustomItem

java.lang.Object
  javax.microedition.lcdui.Item
      javax.microedition.lcdui.CustomItem
          de.enough.polish.ui.FakeCustomItem
              de.enough.polish.ui.FakeStringCustomItem

Direct Known Subclasses:

AccelationInfoItem, ClockItem, FakeIconCustomItem, FakeTextFieldCustomItem

public class FakeStringCustomItem
extends FakeCustomItem

Meant for classes that want to be compatible with javax.microedition.lcdui.CustomItem for IDEs only while extending de.enough.polish.ui.StringItem in reality.

Subclasses can change the hierarchy with preprocessing like this:

 public class MyCustomItem
 //#if polish.LibraryBuild
                 extends FakeStringCustomItem
 //#else
                //# extends StringItem
 //#endif        
 

This allows subclasses to access all fields and methods of the J2ME Polish item class.

Note that this class can never be used in reality. Ever.

Since:

J2ME Polish 1.3

Author:

Robert Virkus, robert@enough.de

Field Summary

protected boolean	animateTextWrap
protected int	availableTextWidth
protected boolean	clipText
protected Font	font
protected boolean	isHorizontalAnimationDirectionRight
protected boolean	isTextInitializationRequired
protected int	maxLines
protected String	maxLinesAppendix
protected int	maxLinesAppendixPosition
protected String	text
protected int	textColor
protected TextEffect	textEffect
protected int	textHorizontalAdjustment
protected int	textLayout
protected WrappedText	textLines
protected int	textVerticalAdjustment
protected int	textWidth
protected int	textWrapDirection
protected int	textWrapSpeed
protected boolean	useSingleLine
protected int	xOffset

Fields inherited from class de.enough.polish.ui.FakeCustomItem

_bbField, appearanceMode, availableHeight, availableWidth, availContentHeight, availContentWidth, background, backgroundHeight, backgroundWidth, backgroundYOffset, beforeWidth, bgBorder, border, BUTTON, cacheItemImage, colSpan, commands, completeBackground, completeBackgroundPadding, completeBorder, contentHeight, contentWidth, contentX, contentXAdjustment, contentY, contentYAdjustment, cssHeight, cssSelector, cssWidth, defaultCommand, focusedStyle, HORIZONTAL, HYPERLINK, ignoreRepaintRequests, includeLabel, INTERACTIVE, internalHeight, internalWidth, internalX, internalY, isContentVisible, isFocused, isInlineLabel, isInvisible, isLayoutCenter, isLayoutExpand, isLayoutRight, isPressed, isShown, isStyleInitialised, itemCommandListener, itemHeight, itemWidth, label, labelStyle, landscapeStyle, layout, 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, marginBottom, marginLeft, marginRight, marginTop, maximumHeight, maximumItemHeight, maximumItemWidth, maximumWidth, minimumHeight, minimumItemHeight, minimumItemWidth, minimumWidth, nativeItem, NO_POSITION_SET, opacity, opacityPaintNormally, opacityRgbData, paddingBottom, paddingHorizontal, paddingLeft, paddingRight, paddingTop, paddingVertical, parent, PLAIN, portraitStyle, preferredHeight, preferredWidth, preserveViewType, relativeX, relativeY, rowSpan, screen, setView, style, TRANSPARENT, useSingleRow, VERTICAL, view, xAdjustment, yAdjustment

Fields inherited from class javax.microedition.lcdui.CustomItem

KEY_PRESS, KEY_RELEASE, KEY_REPEAT, NONE, POINTER_DRAG, POINTER_PRESS, POINTER_RELEASE, TRAVERSE_HORIZONTAL, TRAVERSE_VERTICAL

Constructor Summary

FakeStringCustomItem(String label, String text)
Creates a new StringItem object.

FakeStringCustomItem(String label, String text, int appearanceMode)
Creates a new StringItem object with the given label, textual content, and appearance mode.

FakeStringCustomItem(String label, String text, int appearanceMode, Style style)
Creates a new StringItem object with the given label, textual content, and appearance mode.

FakeStringCustomItem(String label, String text, Style style)
Creates a new StringItem object.

Method Summary

void	addRepaintArea(ClippingRegion repaintRegion) Adds a repaint request for this item's space.
void	animate(long currentTime, ClippingRegion repaintRegion) Animates this item.
int	charWidth(char c) Retrieves the width of the given char
protected String	createCssSelector() Retrieves the CSS selector for this item.
protected void	defocus(Style originalStyle) Removes the focus from this item.
void	drawString(String line, int x, int y, int anchor, Graphics g)
Font	getFont() Gets the application's preferred font for rendering this StringItem.
int	getFontHeight() Retrieves the height necessary for displaying a row of text without the padding-vertical.
int	getLineHeight() Returns the height of one line
String	getText() Gets the text contents of the StringItem, or null if the StringItem is empty.
protected void	hideNotify() Called by the system to notify the item that it is now completely invisible, when it previously had been at least partially visible.
protected void	initContent(int firstLineWidth, int availWidth, int availHeight) Initialises this item.
void	paintContent(int x, int y, int leftBorder, int rightBorder, Graphics g) Paints the content of this item.
void	releaseResources() Releases all (memory intensive) resources such as images or RGB arrays of this item.
protected void	setContentWidth(int width) Sets the content width of this item.
void	setFont(Font font) Sets the application's preferred font for rendering this StringItem.
void	setStyle(Style style) Sets the style of this item.
void	setStyle(Style style, boolean resetStyle) Sets the style of this item for animatable CSS attributes.
void	setText(String text) Sets the text contents of the StringItem.
void	setText(String text, Style style) Sets the text contents of the StringItem along with a style.
void	setTextColor(int color) Sets the text color for contents of the StringItem.
void	setTextEffect(TextEffect effect) Sets the effect for this StringItem Note that this method is only available when either using font-bitmap or the text-effect CSS attributes:
protected void	showNotify() Called by the system to notify the item that it is now at least partially visible, when it previously had been completely invisible.
int	stringWidth(String str) Calculates the width of the given text.
String	toString() Generates a String representation of this item.
protected void	wrap(String body, int firstLineWidth, int availWidth) Wraps the specified text and adds the result to the internal field 'wrappedText'.

Methods inherited from class de.enough.polish.ui.FakeCustomItem

addCommand, addCommand, addCommand, addCommands, addRelativeToBackgroundRegion, addRelativeToBackgroundRegion, addRelativeToContentRegion, animate, containsCommand, destroy, fireEvent, focus, getAbsoluteX, getAbsoluteY, getAppearanceMode, getAttribute, getAttributes, getAvailableContentHeight, getAvailableContentWidth, getAvailableHeight, getAvailableWidth, getBackgroundHeight, getBackgroundWidth, getBackgroundX, getBackgroundY, getBorderWidthBottom, getBorderWidthLeft, getBorderWidthRight, getBorderWidthTop, getContentHeight, getContentWidth, getContentX, getContentY, getDefaultCommand, getFocusedStyle, getInternalHeight, getInternalWidth, getInternalX, getInternalY, getItemAreaHeight, getItemAt, getItemCommandListener, getItemCommands, getItemHeight, getItemHeight, getItemStateListener, getItemWidth, getItemWidth, getLabel, getLabelItem, getLayout, getMaximumHeight, getMaximumHeight, getMaximumWidth, getMaximumWidth, getMinContentHeight, getMinContentWidth, getMinimumHeight, getMinimumHeight, getMinimumWidth, getMinimumWidth, getNativeItem, getParent, getPrefContentHeight, getPrefContentWidth, getpreferredHeight, getpreferredWidth, getRgbData, getRgbData, getScreen, getStyle, getUiEventListener, getView, getView, handleCommand, handleCommand, handleGesture, handleGestureHold, handleGestureSwipeLeft, handleGestureSwipeRight, handleKeyPressed, handleKeyReleased, handleKeyRepeated, handlePointerDragged, handlePointerDragged, handlePointerPressed, handlePointerReleased, handlePointerTouchDown, handlePointerTouchUp, init, initLayout, initMargin, initPadding, initStyle, isFocused, isInContentArea, isInContentWithPaddingArea, isInItemArea, isInItemArea, isInitialized, isInteractive, isLayoutBottom, isLayoutCenter, isLayoutExpand, isLayoutLeft, isLayoutNewlineAfter, isLayoutNewlineBefore, isLayoutRight, isLayoutShrink, isLayoutTop, isLayoutVerticalCenter, isLayoutVerticalExpand, isLayoutVerticalShrink, isPressed, isVisible, notifyItemPressedEnd, notifyItemPressedStart, notifyStateChanged, notifyUnvisited, notifyValueChanged, notifyVisited, onScreenSizeChanged, paint, paint, paintBackground, paintBackgroundAndBorder, paintBorder, paintCommands, paintFilter, removeAttribute, removeCommand, repaintFully, requestInit, setAbsoluteY, setAppearanceMode, setAttribute, setBackground, setBorder, setContentHeight, setDefaultCommand, setDefaultCommand, setInitialized, setItemCommandListener, setItemCommandListener, setItemHeight, setItemStateListener, setItemTransition, setLabel, setLayout, setNativeItem, setParent, setParent, setpreferredSize, setStyle, setUiEventListener, setView, setVisible, show, showCommands, toImage, toRgbImage, updateInternalArea

Methods inherited from class javax.microedition.lcdui.CustomItem

getGameAction, getInteractionModes, invalidate, keyPressed, keyReleased, keyRepeated, pointerDragged, pointerPressed, pointerReleased, repaint, repaint, sizeChanged, traverse, traverseOut

Methods inherited from class javax.microedition.lcdui.Item

getPreferredHeight, getPreferredWidth, removeCommand, setPreferredSize

Methods inherited from class java.lang.Object

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

Field Detail

text

protected String text

textLines

protected final WrappedText textLines

textColor

protected int textColor

font

protected Font font

useSingleLine

protected boolean useSingleLine

clipText

protected boolean clipText

xOffset

protected int xOffset

textWidth

protected int textWidth

isHorizontalAnimationDirectionRight

protected boolean isHorizontalAnimationDirectionRight

animateTextWrap

protected boolean animateTextWrap

availableTextWidth

protected int availableTextWidth

textWrapDirection

protected int textWrapDirection

textWrapSpeed

protected int textWrapSpeed

textHorizontalAdjustment

protected int textHorizontalAdjustment

textVerticalAdjustment

protected int textVerticalAdjustment

textEffect

protected TextEffect textEffect

maxLines

protected int maxLines

maxLinesAppendix

protected String maxLinesAppendix

maxLinesAppendixPosition

protected int maxLinesAppendixPosition

textLayout

protected int textLayout

isTextInitializationRequired

protected boolean isTextInitializationRequired

Constructor Detail

FakeStringCustomItem

public FakeStringCustomItem(String label,
                            String text)

Creates a new StringItem object. Calling this constructor is equivalent to calling

 StringItem(label, text, Item.PLAIN, null);     
 

Parameters:

label - the Item label

text - the text contents

See Also:

FakeStringCustomItem(String, String, int, Style)

FakeStringCustomItem

public FakeStringCustomItem(String label,
                            String text,
                            Style style)

Creates a new StringItem object. Calling this constructor is equivalent to calling

 StringItem(label, text, Item.PLAIN, style);     
 

Parameters:

label - the Item label

text - the text contents

style - the style

See Also:

FakeStringCustomItem(String, String, int, Style)

FakeStringCustomItem

public FakeStringCustomItem(String label,
                            String text,
                            int appearanceMode)

Creates a new StringItem object with the given label, textual content, and appearance mode. Either label or text may be present or null.

The appearanceMode parameter (see Appearance Modes) is a hint to the platform of the application's intended use for this StringItem. To provide hyperlink- or button-like behavior, the application should associate a default Command with this StringItem and add an ItemCommandListener to this StringItem.

Here is an example showing the use of a StringItem as a button:

 StringItem strItem = new StringItem("Default: ", "Set", Item.BUTTON);
 strItem.setDefaultCommand(
 new Command("Set", Command.ITEM, 1);
 // icl is ItemCommandListener
 strItem.setItemCommandListener(icl);     
 

Parameters:

label - the StringItem's label, or null if no label

text - the StringItem's text contents, or null if the contents are initially empty

appearanceMode - the appearance mode of the StringItem, one of Item.PLAIN, Item.HYPERLINK, or Item.BUTTON

Throws:

IllegalArgumentException - if appearanceMode invalid

Since:

MIDP 2.0

FakeStringCustomItem

public FakeStringCustomItem(String label,
                            String text,
                            int appearanceMode,
                            Style style)

Creates a new StringItem object with the given label, textual content, and appearance mode. Either label or text may be present or null.

The appearanceMode parameter (see Appearance Modes) is a hint to the platform of the application's intended use for this StringItem. To provide hyperlink- or button-like behavior, the application should associate a default Command with this StringItem and add an ItemCommandListener to this StringItem.

Here is an example showing the use of a StringItem as a button:

 StringItem strItem = new StringItem("Default: ", "Set", Item.BUTTON);
 strItem.setDefaultCommand(
 new Command("Set", Command.ITEM, 1);
 // icl is ItemCommandListener
 strItem.setItemCommandListener(icl);     
 

Parameters:

label - the StringItem's label, or null if no label

text - the StringItem's text contents, or null if the contents are initially empty

appearanceMode - the appearance mode of the StringItem, one of Item.PLAIN, Item.HYPERLINK, or Item.BUTTON

style - the style for this item

Throws:

IllegalArgumentException - if appearanceMode invalid

Since:

MIDP 2.0

Method Detail

animate

public void animate(long currentTime,
                    ClippingRegion repaintRegion)

Description copied from class: FakeCustomItem

Animates this item. Subclasses can override this method to create animations. The default implementation animates the background and the item view if present.

Overrides:

animate in class FakeCustomItem

Parameters:

currentTime - the current time in milliseconds

repaintRegion - the repaint area that needs to be updated when this item is animated

See Also:

FakeCustomItem.addRelativeToContentRegion(ClippingRegion, int, int, int, int)

addRepaintArea

public void addRepaintArea(ClippingRegion repaintRegion)

Description copied from class: FakeCustomItem

Adds a repaint request for this item's space.

Overrides:

addRepaintArea in class FakeCustomItem

Parameters:

repaintRegion - the clipping rectangle to which the repaint area should be added

defocus

protected void defocus(Style originalStyle)

Description copied from class: FakeCustomItem

Removes the focus from this item.

Overrides:

defocus in class FakeCustomItem

Parameters:

originalStyle - the original style which will be restored.

hideNotify

protected void hideNotify()

Description copied from class: FakeCustomItem

Called by the system to notify the item that it is now completely invisible, when it previously had been at least partially visible. No further paint() calls will be made on this item until after a showNotify() has been called again.

The default implementation of this method sets the isShown field to false and calls hideNotify on style elements.

Overrides:

hideNotify in class FakeCustomItem

showNotify

protected void showNotify()

Description copied from class: FakeCustomItem

Called by the system to notify the item that it is now at least partially visible, when it previously had been completely invisible. The item may receive paint() calls after showNotify() has been called.

The default implementation of this method sets the isShown field to true and calls showNotify on style elements.

Overrides:

showNotify in class FakeCustomItem

getText

public String getText()

Gets the text contents of the StringItem, or null if the StringItem is empty.

Returns:

a string with the content of the item

See Also:

setText(java.lang.String)

setText

public void setText(String text)

Sets the text contents of the StringItem. If text is null, the StringItem is set to be empty.

Parameters:

text - the new content

See Also:

getText()

setText

public void setText(String text,
                    Style style)

Sets the text contents of the StringItem along with a style. If text is null, the StringItem is set to be empty.

Parameters:

text - the new content

style - the new style, is ignored when null

See Also:

getText()

setTextEffect

public void setTextEffect(TextEffect effect)

Sets the effect for this StringItem Note that this method is only available when either using font-bitmap or the text-effect CSS attributes:

        //#if polish.css.font-bitmap || polish.css.text-effect
 

Parameters:

effect - the new text effect, use null for removing the current text effect

setTextColor

public void setTextColor(int color)

Sets the text color for contents of the StringItem.

Parameters:

color - the new color for the content

setFont

public void setFont(Font font)

Sets the application's preferred font for rendering this StringItem. The font is a hint, and the implementation may disregard the application's preferred font.

The font parameter must be a valid Font object or null. If the font parameter is null, the implementation must use its default font to render the StringItem.

Parameters:

font - - the preferred font to use to render this StringItem

Since:

MIDP 2.0

See Also:

getFont()

getFont

public Font getFont()

Gets the application's preferred font for rendering this StringItem. The value returned is the font that had been set by the application, even if that value had been disregarded by the implementation. If no font had been set by the application, or if the application explicitly set the font to null, the value is the default font chosen by the implementation.

Returns:

the preferred font to use to render this StringItem

Since:

MIDP 2.0

See Also:

setFont(javax.microedition.lcdui.Font)

paintContent

public void paintContent(int x,
                         int y,
                         int leftBorder,
                         int rightBorder,
                         Graphics g)

Description copied from class: FakeCustomItem

Paints the content of this item. The background has already been painted and the border will be added after this method returns.

Specified by:

paintContent in class FakeCustomItem

Parameters:

x - the left start position

y - the upper start position

leftBorder - the left border, nothing must be painted left of this position

rightBorder - the right border, nothing must be painted right of this position

g - the Graphics on which this item should be painted.

drawString

public void drawString(String line,
                       int x,
                       int y,
                       int anchor,
                       Graphics g)

Parameters:

line -

x -

y -

anchor -

getLineHeight

public int getLineHeight()

Returns the height of one line

Returns:

the height of one line

stringWidth

public int stringWidth(String str)

Calculates the width of the given text. When a bitmap font is used, the calculation is forwarded to it. When a texteffect is used, the calculation is forwarded to it. In other cases font.stringWidth(text) is returned.

Parameters:

str - the text of which the width should be determined

Returns:

the width of the text

charWidth

public int charWidth(char c)

Retrieves the width of the given char

Parameters:

c - the char

Returns:

the width of that char

getFontHeight

public int getFontHeight()

Retrieves the height necessary for displaying a row of text without the padding-vertical.

Returns:

the font height (either from the bitmap, the text-effect or the font used)

initContent

protected void initContent(int firstLineWidth,
                           int availWidth,
                           int availHeight)

Description copied from class: FakeCustomItem

Initialises this item. The implementation needs to calculate and set the contentWidth and contentHeight fields. The implementation should take the fields preferredWidth and preferredHeight into account.

Specified by:

initContent in class FakeCustomItem

Parameters:

firstLineWidth - the maximum width of the first line

availWidth - the available maximum width of this item in pixels

availHeight - the available maximum height of this item in pixels

See Also:

FakeCustomItem.contentWidth, FakeCustomItem.contentHeight, FakeCustomItem.preferredWidth, FakeCustomItem.preferredHeight

wrap

protected void wrap(String body,
                    int firstLineWidth,
                    int availWidth)

Wraps the specified text and adds the result to the internal field 'wrappedText'.

Parameters:

body - the text

firstLineWidth - the available width for the first line

availWidth - the available width for subsequent lines

setContentWidth

protected void setContentWidth(int width)

Description copied from class: FakeCustomItem

Sets the content width of this item. Subclasses can override this to react to content width changes

Overrides:

setContentWidth in class FakeCustomItem

Parameters:

width - the new content width in pixel

setStyle

public void setStyle(Style style)

Description copied from class: FakeCustomItem

Sets the style of this item.

Overrides:

setStyle in class FakeCustomItem

Parameters:

style - the new style for this item.

setStyle

public void setStyle(Style style,
                     boolean resetStyle)

Description copied from class: FakeCustomItem

Sets the style of this item for animatable CSS attributes.

Overrides:

setStyle in class FakeCustomItem

Parameters:

style - the new style for this element.

resetStyle - true when style settings should be resetted. This is not the case when styles are animated, for example.

createCssSelector

protected String createCssSelector()

Description copied from class: FakeCustomItem

Retrieves the CSS selector for this item. The CSS selector is used for the dynamic assignment of styles - that is the styles are assigned by the usage of the item and not by a predefined style-name. With the #style preprocessing command styles are set fix, this method yields in a faster GUI and is recommended. When in a style-sheet dynamic styles are used, e.g. "Form>p", than the selector of the item is needed.
This abstract method needs only be implemented, when dynamic styles are used: #ifdef polish.useDynamicStyles
The returned selector needs to be in lower case.

Specified by:

createCssSelector in class FakeCustomItem

Returns:

the appropriate CSS selector for this item. The selector needs to be in lower case.

toString

public String toString()

Description copied from class: FakeCustomItem

Generates a String representation of this item. This method is only implemented when the logging framework is active or the preprocessing variable "polish.keepToString" is set to true.

Overrides:

toString in class FakeCustomItem

Returns:

a String representation of this item.

releaseResources

public void releaseResources()

Description copied from class: FakeCustomItem

Releases all (memory intensive) resources such as images or RGB arrays of this item. The default implementation releases any background resources.

Overrides:

releaseResources in class FakeCustomItem