/*

* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).

* All rights reserved.

* This component and the accompanying materials are made available

* under the terms of "Eclipse Public License v1.0"

* which accompanies this distribution, and is available

* at the URL "http://www.eclipse.org/legal/epl-v10.html".

*

* Initial Contributors:

* Nokia Corporation - initial contribution.

*

* Contributors:

*

*

*/

package javax.microedition.lcdui;

import org.eclipse.swt.graphics.Point;

/**

 * Item representing an editable TextField.

 */

    /**

     * Constant value shows that any text is allowed.

     */

    public static final int ANY = 0;

    /**

     * Constant value shows that email address is allowed.

     */

    public static final int EMAILADDR = 1;

    /**

     * Constant value shows that numeric values allowed.

     */

    public static final int NUMERIC = 2;

    /**

     * Constant value shows that phone number format is allowed.

     */

    public static final int PHONENUMBER = 3;

    /**

     * Constant value shows that URL is allowed.

     */

    public static final int URL = 4;

    /**

     * Constant value shows that decimal values allowed.

     */

    public static final int DECIMAL = 5;

    /**

     * Constant value shows that password is allowed.

     */

    public static final int PASSWORD = 65536; // 0x10000

    /**

     * Constant value shows that user is not to allow modify text.

     */

    public static final int UNEDITABLE = 131072; // 0x20000

    /**

     * Constant value shows that sensitive text is allowed.

     */

    public static final int SENSITIVE = 262144; // 0x40000

    /**

     * Constant value shows that input text is most likely not in predictive

     * dictionary.

     */

    public static final int NON_PREDICTIVE = 524288; // 0x80000

    /**

     * Constant value shows that every word will start from capital letter.

     */

    public static final int INITIAL_CAPS_WORD = 1048576; // 0x100000

    /**

     * Constant value shows that every sentence will start with Cap.

     */

    public static final int INITIAL_CAPS_SENTENCE = 2097152; // 0x200000

    /**

     * the mask to detect constraint mode.

     */

    public static final int CONSTRAINT_MASK = 65535; // 0xFFFF

    /**

     * Constant used by layouter to update TextField when setInitialInputMode

     * was called.

     */

    static final int UPDATE_INITIAL_INPUT_MODE = 8;

    private TextWrapper textWrapper;

    private int linesCount = 1;

    private int maxVisibleLines = 1;

    /**

     * Creates new TextField item.

     *

     * @param header label of the TextField.

     * @param txt initial text.

     * @param maxSize maximum number of characters allowed.

     * @param constraints TextField constraints.

     */

        setLabel(header);

        textWrapper = new TextWrapper(txt, maxSize, constraints);

    }

    /**

     * Get current caret's position.

     *

     * @return index in TextField where caret is.

     */

        return textWrapper.getCaretPosition();

    }

    /**

     * Get content of TextField.

     *

     * @return String which represents content of TextField;

     */

        return textWrapper.getContent();

    }

    /**

     * Set text into TextField, replacing previous content.

     *

     * @param newTxt text to set.

     */

        textWrapper.setContent(newTxt);

        linesCount = 0;

        updateParent(Item.UPDATE_CONTENT | Item.UPDATE_HEIGHT_CHANGED);

    }

    /**

     * Copy content of TextField into array charaData.

     *

     * @param charData array where to copy.

     * @return number of copied characters.

     */

            throw new NullPointerException(

        }

            throw new ArrayIndexOutOfBoundsException(

        }

        String content = textWrapper.getContent();

        content.getChars(0, content.length(), charData, 0);

        return content.length();

    }

    /**

     * Set content of charData into TextField.

     *

     * @param charData array of chars to set.

     * @param offset index in charData to start copy from.

     * @param length number of character to copy into TextField.

     */

        String extractedString = null;

                extractedString = new String(charData, offset, length);

            }

                throw new ArrayIndexOutOfBoundsException(

            }

        }

        textWrapper.setContent(extractedString);

        linesCount = 0;

        updateParent(Item.UPDATE_CONTENT | Item.UPDATE_HEIGHT_CHANGED);

    }

    /**

     * Insert text into content of TextField.

     *

     * @param newTxt string to insert.

     * @param position where to insert.

     */

        textWrapper.insert(newTxt, position);

        linesCount = 0;

        updateParent(Item.UPDATE_CONTENT | Item.UPDATE_HEIGHT_CHANGED);

    }

    /**

     * Insert into TextField subset of characters from char[] array.

     *

     * @param charData array of characters where to copy from.

     * @param offset start index in charData[].

     * @param length number of characters to copy.

     * @param position index in TextField where to insert to.

     */

            throw new NullPointerException(

        }

        String extractedString = null;

            extractedString = new String(charData, offset, length);

        }

            throw new ArrayIndexOutOfBoundsException(

        }

        textWrapper.insert(extractedString, position);

        linesCount = 0;

        updateParent(Item.UPDATE_CONTENT | Item.UPDATE_HEIGHT_CHANGED);

    }

    /**

     * Delete subset of characters from TextField.

     *

     * @param offset start index where to start deletion.

     * @param length number of characters to delete.

     */

        textWrapper.delete(offset, length);

        linesCount = 0;

        updateParent(Item.UPDATE_CONTENT | Item.UPDATE_HEIGHT_CHANGED);

    }

    /**

     * Get number of characters allowed for input.

     *

     * @return number of characters which TextField can contain.

     */

        return textWrapper.getMaxSize();

    }

    /**

     * Set the maximum size of TextField.

     *

     * @param newMaxSize size to set.

     * @return max size that was set, depending on implementation may be smaller

     *         then requested.

     */

        textWrapper.setMaxSize(newMaxSize);

        linesCount = 0;

        updateParent(Item.UPDATE_CONTENT | Item.UPDATE_HEIGHT_CHANGED);

        return textWrapper.getMaxSize();

    }

    /**

     * Get number of characters stored in TextField.

     *

     * @return current content length.

     */

        return textWrapper.getSize();

    }

    /**

     * Set constraints for TextField.

     *

     * @param newConstraints constraints to set.

     */

        textWrapper.setConstraints(newConstraints);

        updateParent(Item.UPDATE_CONTENT | Item.UPDATE_SIZE_CHANGED);

    }

    /**

     * Get current constraints active in TextField.

     *

     * @return current constraints.

     */

        return textWrapper.getConstraints();

    }

    /**

     * Set initial input mode for TextField.

     *

     * @param inputMode input mode to set.

     */

        textWrapper.setInputMode(inputMode);

        updateParent(UPDATE_INITIAL_INPUT_MODE);

    }

    /**

     * Get Initial input mode.

     *

     * @return inputMode currently set for TextField.

     */

        return textWrapper.getInputMode();

    }

    /**

     * Calculates minimum size of this item.

     *

     * @return Minimum size.

     */

        return TextFieldLayouter.calculateMinimumBounds(this);

    }

    /**

     * Calculates preferred size of this item.

     *

     * @return Preferred size.

     */

        return TextFieldLayouter.calculatePreferredBounds(this);

    }

    /**

     * Return layout with optional custom flags.

     *

     * @return layout directive

     */

        return super.internalGetLayout(); // | Item.LAYOUT_NEWLINE_BEFORE;

    }

    /**

     * @see javax.microedition.lcdui.Item#isFocusable()

     */

        return true;

    }

    /**

     * Update caret position.

     *

     * @param newPosition new caret position.

     */

        textWrapper.setCaretposition(newPosition);

    }

    /**

     * Set String when user interacts with TextField.

     *

     * @param newText new text.

     * @return true if this resulted in a change

     */

            textWrapper.setContent(newText);

            return true;

        }

        return false;

    }

    /**

     * Set number of lines for the TextField.

     *

     * @param newLinesCount new number lines.

     */

        linesCount = newLinesCount;

    }

    /**

     * Get number of lines currently in TextField;

     *

     * @return lines count.

     */

        return linesCount;

    }

    /**

     * Set number of maximum visible lines.

     *

     * @param newMax maximum visible lines allowed for TextField.

     */

        maxVisibleLines = newMax;

    }

    /**

     * Get number maximum visible lines allowed for TextField.

     *

     * @return number of maximum visible lines to display on the Form.

     */

        return maxVisibleLines;

    }

}