/*

* 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 java.util.Vector;

import javax.microedition.lcdui.EventDispatcher.LCDUIEvent;

import org.eclipse.swt.graphics.Point;

/**

 * Abstract class representing an item.<br>

 */

    /**

     * A layout directive.

     */

    public static final int LAYOUT_DEFAULT = 0;

    /**

     * A layout directive.

     */

    public static final int LAYOUT_LEFT = 1;

    /**

     * A layout directive.

     */

    public static final int LAYOUT_RIGHT = 2;

    /**

     * A layout directive.

     */

    public static final int LAYOUT_CENTER = 3;

    /**

     * A layout directive.

     */

    public static final int LAYOUT_TOP = 16;

    /**

     * A layout directive.

     */

    public static final int LAYOUT_BOTTOM = 32;

    /**

     * A layout directive.

     */

    public static final int LAYOUT_VCENTER = 48;

    /**

     * A layout directive.

     */

    public static final int LAYOUT_NEWLINE_BEFORE = 256;

    /**

     * A layout directive.

     */

    public static final int LAYOUT_NEWLINE_AFTER = 512;

    /**

     * A layout directive.

     */

    public static final int LAYOUT_SHRINK = 1024;

    /**

     * A layout directive.

     */

    public static final int LAYOUT_EXPAND = 2048;

    /**

     * A layout directive.

     */

    public static final int LAYOUT_VSHRINK = 4096;

    /**

     * A layout directive.

     */

    public static final int LAYOUT_VEXPAND = 8192;

    /**

     * A layout directive indicating that MIDP 2 layout rules are used.

     */

    public static final int LAYOUT_2 = 16384;

    /**

     * An appearance mode value.

     */

    public static final int PLAIN = 0;

    /**

     * An appearance mode value.

     */

    public static final int HYPERLINK = 1;

    /**

     * An appearance mode value.

     */

    public static final int BUTTON = 2;

    /**

     * Combination of all possible layout directives.

     */

    private static final int LAYOUT_BITMASK =

        | LAYOUT_LEFT

        | LAYOUT_RIGHT

        | LAYOUT_CENTER

        | LAYOUT_TOP

        | LAYOUT_BOTTOM

        | LAYOUT_VCENTER

        | LAYOUT_NEWLINE_BEFORE

        | LAYOUT_NEWLINE_AFTER

        | LAYOUT_SHRINK

        | LAYOUT_EXPAND

        | LAYOUT_VSHRINK

        | LAYOUT_VEXPAND

        | LAYOUT_2;

    static final int LAYOUT_HORIZONTAL_MASK = LAYOUT_CENTER; // 15;

    static final int LAYOUT_VERTICAL_MASK = LAYOUT_VCENTER; // 48;

    static final int UPDATE_NONE = 0;

    static final int UPDATE_ADDCOMMAND = 1;

    static final int UPDATE_REMOVECOMMAND = 2;

    /**

     * Item content has changed. Re-layouting not needed.

     */

    static final int UPDATE_CONTENT = 3; // general update value

    static final int UPDATE_REASON_MASK = 255;

    /**

     * Item height has changed. Re-layouting not needed.

     */

    static final int UPDATE_HEIGHT_CHANGED = 256;

    /**

     * Item width is changed. Re-layouting asap.

     */

    static final int UPDATE_WIDTH_CHANGED = 512;

    /**

     * Item width and height changed. Re-layouting asap.

     */

    static final int UPDATE_SIZE_CHANGED =

        UPDATE_HEIGHT_CHANGED | UPDATE_WIDTH_CHANGED;

    private String label;

    /**

     * Vector of commands added to this item that have eSWT Command associated

     * with them.

     */

    private Vector commands = new Vector();

    private ItemCommandListener itemCommandListener;

    private Command defaultCommand;

    private Screen parent;

    private int layout;

    private int lockedPrefWidth = -1;

    private int lockedPrefHeight = -1;

    private Point calculatedMinSize;

    private Point calculatedPrefSize;

    private boolean focused;

    private boolean visible;

    /**

     * Sets the parent of this Item.

     * @param parent new Parent. If null, current parent is removed.

     */

        this.parent = parent;

    }

    /**

     * Gets the Item's parent.

     *

     * @return the Item's parent or null if it has none.

     */

        return parent;

    }

    /**

     * Sets the label of the item.

     *

     * @param newLabel New label to be set.

     * @throws IllegalStateException If this item is contained within an alert.

     */

            throw new IllegalStateException(

        }

        label = newLabel;

        updateParent(UPDATE_SIZE_CHANGED);

    }

    /**

     * Gets the label of the item.

     *

     * @return The label of the item.

     */

        return label;

    }

    /**

     * Returns if this item has a valid label, not null and not empty.

     */

        return ((label != null) && (!label.equals("")));

    }

    /**

     * Gets item's current layout.

     *

     * @return A combination of layout directives currently in use.

     */

        return layout;

    }

    /**

     * Sets the layout of the item.

     *

     * @param newLayout a Combination of layout directives to be used.

     * @throws IllegalArgumentException if newLayout is not valid bitwise OR

     *             combination of layout directives spesified in this class.

     * @throws IllegalStateException If this Item is contained within an Alert.

     */

            throw new IllegalStateException(

        }

            throw new IllegalArgumentException(

        }

        layout = newLayout;

        Logger.method(this, "setLayout", String.valueOf(layout));

        updateParent(UPDATE_SIZE_CHANGED);

    }

    /**

     * Adds command to this item. If same command is already added to this item,

     * nothing happens.

     *

     * @param command A command to be added.

     * @throws NullPointerException if cmd is null.

     * @throws IllegalStateException If this Item is contained within an Alert.

     */

            throw new IllegalStateException(

        }

            throw new NullPointerException(

        }

            commands.addElement(command);

            int reason = UPDATE_ADDCOMMAND;

                reason |= UPDATE_SIZE_CHANGED;

            }

                reason |= UPDATE_SIZE_CHANGED;

            }

            updateParent(reason, command);

        }

    }

    /**

     * Removes command from the item. If command doesn't exists in this item,

     * nothing happens.

     *

     * @param command The command to be removed.

     */

        // It is not specified what should happen when this method is

        // called with null-parameter !

            // Remove command from commands-vector

            commands.removeElement(command);

            int reason = UPDATE_REMOVECOMMAND;

                reason |= UPDATE_SIZE_CHANGED;

            }

                reason |= UPDATE_SIZE_CHANGED;

            }

            updateParent(reason, command);

        }

    }

    /**

     * Sets Listener which will receive command events associated with this

     * item.

     *

     * @param newItemCmdListener A new listener. If null, already existing

     *            listener is removed.

     * @throws IllegalStateException If this Item is contained within an Alert.

     */

            throw new IllegalStateException(

        }

        itemCommandListener = newItemCmdListener;

    }

    /**

     * Gets the minimum width of this item.

     *

     * @return Minimum width.

     */

        return getCalculatedMinimumSize().x;

    }

    /**

     * Gets the minimum height of this item.

     *

     * @return Minimum height.

     */

        return getCalculatedMinimumSize().y;

    }

            calculatedMinSize = calculateMinimumSize();

            // Logger.method(this, "calculateMinimumSize", calculatedMinSize);

        }

        return calculatedMinSize;

    }

    /**

     * Calculates minimum size of this item.

     *

     * @return Minimum size.

     */

    abstract Point calculateMinimumSize();

    /**

     * Gets the preferred width of this item.

     *

     * @return Preferred width.

     */

                checkLockedSizes();

            }

            return lockedPrefWidth;

        }

            return getCalculatedPreferredSize().x;

        }

    }

    /**

     * Gets the preferred height of this item.

     *

     * @return Preferred height.

     */

                checkLockedSizes();

            }

            return lockedPrefHeight;

        }

            return getCalculatedPreferredSize().y;

        }

    }

            calculatedPrefSize = calculatePreferredSize();

            // Logger.method(this, "calculatePreferredSize", calculatedPrefSize);

        }

        return calculatedPrefSize;

    }

            lockedPrefWidth = Math.min(

        }

            lockedPrefHeight = Math.max(lockedPrefHeight, getMinimumHeight());

        }

    }

    /**

     * Invalidates this Item's calculated preferred size. Forces the

     * implementation to calculate it again.

     */

        calculatedMinSize = null;

        calculatedPrefSize = null;

    }

    /**

     * Calculates preferred size of this item.

     *

     * @return Preferred size.

     */

    abstract Point calculatePreferredSize();

    /**

     * Sets the preferred size of this item. If new value is larger than -1 and

     * less than minimum value, the minimum value is used instead. If value is

     * larger than minimum value, the dimension is locked to provided value. It

     * is possible to unlock dimension by setting value to -1.

     *

     * @param w New preferred width.

     * @param h New preferred height.

     * @throws IllegalArgumentException if w or h is less than -1.

     * @throws IllegalStateException If this Item is contained within an Alert.

     */

            throw new IllegalStateException(

        }

            throw new IllegalArgumentException(

        }