diff options
Diffstat (limited to 'libjava/java/awt/List.java')
| -rw-r--r-- | libjava/java/awt/List.java | 1413 |
1 files changed, 982 insertions, 431 deletions
diff --git a/libjava/java/awt/List.java b/libjava/java/awt/List.java index f3d5e4becfa..c4fa0aa879b 100644 --- a/libjava/java/awt/List.java +++ b/libjava/java/awt/List.java @@ -1,443 +1,994 @@ -/* Copyright (C) 2000, 2001 Free Software Foundation +/* List.java -- A listbox widget + Copyright (C) 1999, 2002 Free Software Foundation, Inc. - This file is part of libgcj. +This file is part of GNU Classpath. + +GNU Classpath is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2, or (at your option) +any later version. + +GNU Classpath is distributed in the hope that it will be useful, but +WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +General Public License for more details. + +You should have received a copy of the GNU General Public License +along with GNU Classpath; see the file COPYING. If not, write to the +Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA +02111-1307 USA. + +As a special exception, if you link this library with other files to +produce an executable, this library does not by itself cause the +resulting executable to be covered by the GNU General Public License. +This exception does not however invalidate any other reasons why the +executable file might be covered by the GNU General Public License. */ -This software is copyrighted work licensed under the terms of the -Libgcj License. Please consult the file "LIBGCJ_LICENSE" for -details. */ package java.awt; +import java.io.Serializable; +import java.awt.event.ActionEvent; +import java.awt.event.ActionListener; +import java.awt.event.ItemEvent; +import java.awt.event.ItemListener; import java.awt.peer.ListPeer; -import java.awt.event.*; +import java.awt.peer.ComponentPeer; import java.util.Vector; /** - * @author Tom Tromey <tromey@redhat.com> - * @date April 17, 2001 - * Status: incomplete + * Class that implements a listbox widget + * + * @author Aaron M. Renn (arenn@urbanophile.com) + */ +public class List extends Component implements ItemSelectable, Serializable +{ + +/* + * Static Variables + */ + +// Serialization constant +private static final long serialVersionUID = -3304312411574666869L; + +/*************************************************************************/ + +/* + * Instance Variables + */ + +// FIXME: Need read/writeObject + +/** + * @serial The items in the list. + */ +private Vector items = new Vector(); + +/** + * @serial Indicates whether or not multiple items can be selected + * simultaneously. + */ +private boolean multipleMode; + +/** + * @serial The number of rows in the list. This is set on creation + * only and cannot be modified. + */ +private int rows; + +/** + * @serial An array of the item indices that are selected. + */ +private int[] selected; + +/** + * @serial An index value used by <code>makeVisible()</code> and + * <code>getVisibleIndex</code>. + */ +private int visibleIndex; + +// The list of ItemListeners for this object. +private ItemListener item_listeners; + +// The list of ActionListeners for this object. +private ActionListener action_listeners; + +/*************************************************************************/ + +/* + * Constructors + */ + +/** + * Initializes a new instance of <code>List</code> with no visible lines + * and multi-select disabled. + */ +public +List() +{ + this(4, false); +} + +/*************************************************************************/ + +/** + * Initializes a new instance of <code>List</code> with the specified + * number of visible lines and multi-select disabled. + * + * @param lines The number of visible lines in the list. + */ +public +List(int rows) +{ + this(rows, false); +} + +/*************************************************************************/ + +/** + * Initializes a new instance of <code>List</code> with the specified + * number of lines and the specified multi-select setting. + * + * @param lines The number of visible lines in the list. + * @param multipleMode <code>true</code> if multiple lines can be selected + * simultaneously, <code>false</code> otherwise. + */ +public +List(int rows, boolean multipleMode) +{ + this.rows = rows; + this.multipleMode = multipleMode; +} + +/*************************************************************************/ + +/* + * Instance Variables */ -public class List extends Component implements ItemSelectable -{ - /** Creates a new scrolling list with four rows. - * Initially, multiple selections are not allowed. - */ - public List () - { - this (4, false); - } - - /** Create a new scrolling list with the indicated number of rows. - * Initially, multiple selections are not allowed. - * @param rows Number of rows - */ - public List (int rows) - { - this (rows, false); - } - - /** Create a new scrolling list with the indicated number of rows. - * @param rows Number of rows - * @param multiple True if multiple selections allowed - */ - public List (int rows, boolean multiple) - { - this.rows = rows; - this.multipleMode = multiple; - } - - /** Create the peer if it does not already exist. */ - public void addNotify () - { - if (peer != null) - peer = getToolkit ().createList (this); - super.addNotify (); - } - - public int getItemCount () - { - return items.size (); - } - - /** @deprecated Use getItemCount() instead. */ - public int countItems () - { - return getItemCount (); - } - - public String getItem (int index) - { - return (String) items.elementAt (index); - } - - public String[] getItems () - { - String[] els = new String[items.size ()]; - items.copyInto (els); - return els; - } - - public void add (String item) - { - add (item, items.size ()); - } - - /** @deprecated Use add() instead. */ - public void addItem (String item) - { - add (item); - } - - public void add (String item, int index) - { - items.insertElementAt (item, index); - if (peer != null) - { - ListPeer l = (ListPeer) peer; - l.add (item, index); - } - } - - /** @deprecated Use add() instead. */ - public void addItem (String item, int index) - { - add (item, index); - } - - public void replaceItem (String item, int index) - { - items.setElementAt (item, index); - if (peer != null) - { - ListPeer l = (ListPeer) peer; - l.delItems (index, index); - l.add (item, index); - } - } - - public void removeAll () - { - items.clear (); - if (peer != null) - { - ListPeer l = (ListPeer) peer; - l.removeAll (); - } - } - - /** @deprecated Use removeAll() instead. */ - public void clear () - { - removeAll (); - } - - public void remove (String item) - { - remove (items.indexOf (item)); - } - - public void remove (int index) - { - items.removeElementAt (index); - if (peer != null) - { - ListPeer l = (ListPeer) peer; - l.delItems (index, index); - } - } - - /** @deprecated Use remove() instead. */ - public void delItem (int index) - { - remove (index); - } - - public int getSelectedIndex () - { - if (peer != null) - { - ListPeer l = (ListPeer) peer; - selected = l.getSelectedIndexes (); - } - - if (selected == null || selected.length > 1) - return -1; - return selected[0]; - } - - public int[] getSelectedIndexes () - { - if (peer != null) - { - ListPeer l = (ListPeer) peer; - selected = l.getSelectedIndexes (); - } - return selected; - } - - public String getSelectedItem () - { - int i = getSelectedIndex (); - return i == -1 ? null : (String) items.elementAt (i); - } - - public String[] getSelectedItems () - { - int[] is = getSelectedIndexes (); - if (is == null) - return null; - String[] r = new String[is.length]; - for (int i = 0; i < is.length; ++i) - r[i] = (String) items.elementAt (is[i]); - return r; - } - - public Object[] getSelectedObjects () - { - return getSelectedItems (); - } - - public void select (int index) - { - if (peer != null) - { - ListPeer l = (ListPeer) peer; - l.select (index); - } - else if (selected == null) - { - selected = new int[1]; - selected[0] = index; - } - else - { - int i; - for (i = 0; i < selected.length; ++i) - { - if (selected[i] == index) - return; - if (selected[i] > index) - break; - } - - int[] ns = new int[selected.length + 1]; - System.arraycopy (selected, 0, ns, 0, i); - ns[i] = index; - System.arraycopy (selected, i, ns, i + 1, selected.length - i); - - selected = ns; - } - } - - public void deselect (int index) - { - if (peer != null) - { - ListPeer l = (ListPeer) peer; - l.deselect (index); - } - else if (selected != null) - { - int i; - for (i = 0; i < selected.length; ++i) - { - if (selected[i] == index) - break; - } - if (i < selected.length) - { - int[] ns = new int[selected.length - 1]; - System.arraycopy (selected, 0, ns, 0, i); - System.arraycopy (selected, i + 1, ns, i, selected.length - i); - selected = ns; - } - } - } - - public boolean isIndexSelected (int index) - { - int[] is = getSelectedIndexes (); - for (int i = 0; i < is.length; ++i) - { - if (is[i] == index) - return true; - } - return false; - } - - /** @deprecated Use isIndexSelected(). */ - public boolean isSelected (int index) - { - return isIndexSelected (index); - } - - public int getRows () - { - return rows; - } - - public boolean isMultipleMode () - { - return multipleMode; - } - - /** @deprecated Use isMultipleMode(). */ - public boolean allowsMultipleSelections () - { - return isMultipleMode (); - } - - public void setMultipleMode (boolean multiple) - { - this.multipleMode = multiple; - if (peer != null) - { - ListPeer l = (ListPeer) peer; - l.setMultipleMode (multiple); - } - } - - /** @deprecated Use setMultipleMode(). */ - public void setMultipleSelections (boolean multiple) - { - setMultipleMode (multiple); - } - - public int getVisibleIndex () - { - return visibleIndex; - } - - public void makeVisible (int index) - { - visibleIndex = index; - if (peer != null) - { - ListPeer l = (ListPeer) peer; - l.makeVisible (index); - } - } - - public Dimension getPreferredSize (int rows) - { - return null; // FIXME - } - - /** @deprecated Use getPreferredSize(int). */ - public Dimension preferredSize (int rows) - { - return getPreferredSize (rows); - } - - public Dimension getPreferredSize () - { - return null; // FIXME - } - - /** @deprecated Use getPreferredSize(). */ - public Dimension preferredSize () - { - return getPreferredSize (); - } - - public Dimension getMinimumSize (int rows) - { - return null; // FIXME - } - - /** @deprecated Use getMinimumSize(int). */ - public Dimension minimumSize (int rows) - { - return getMinimumSize (rows); - } - - public Dimension getMinimumSize () - { - return null; // FIXME - } - - /** @deprecated Use getMinimumSize(). */ - public Dimension minimumSize () - { - return getMinimumSize (); - } - - public void addItemListener (ItemListener listen) - { - item_listeners = AWTEventMulticaster.add (item_listeners, listen); - } - - public void removeItemListener (ItemListener listen) - { - item_listeners = AWTEventMulticaster.remove (item_listeners, listen); - } - - public void addActionListener (ActionListener listen) - { - action_listeners = AWTEventMulticaster.add (action_listeners, listen); - } - - public void removeActionListener (ActionListener listen) - { - action_listeners = AWTEventMulticaster.remove (action_listeners, listen); - } - - protected void processEvent (AWTEvent e) - { - if (e instanceof ItemEvent) - processItemEvent ((ItemEvent) e); - else if (e instanceof ActionEvent) - processActionEvent ((ActionEvent) e); - else - super.processEvent (e); - } - - protected void processItemEvent (ItemEvent e) - { - if (item_listeners != null) - item_listeners.itemStateChanged (e); - } - - protected void processActionEvent (ActionEvent e) - { - if (action_listeners != null) - action_listeners.actionPerformed (e); - } - - protected String paramString () - { - return ("List[multiple=" + multipleMode - + ",rows=" + rows - + "]"); - } - - /** @deprecated */ - public void delItems (int start, int end) - { - for (int i = end; i >= start; --i) - items.removeElementAt (i); - if (peer != null) - { - ListPeer l = (ListPeer) peer; - l.delItems (start, end); - } - } - - // Vector of items in the list. - private Vector items; - // True if multiple selection mode enabled. - private boolean multipleMode; - // Number of rows. - private int rows; - // Array of indices of selected items. When there is no peer, we - // maintain this in place. When there is a peer, the peer maintains - // the list and we ask for it whenever needed. - private int[] selected; - // Value used by makeVisible(). - private int visibleIndex; - - // Listeners. - private ActionListener action_listeners; - private ItemListener item_listeners; +/** + * Returns the number of items in this list. + * + * @return The number of items in this list. + */ +public int +getItemCount() +{ + return(items.size()); +} + +/*************************************************************************/ + +/** + * Returns the number of items in this list. + * + * @return The number of items in this list. + * + * @deprecated This method is deprecated in favor of + * <code>getItemCount()</code> + */ +public int +countItems() +{ + return(getItemCount()); +} + +/*************************************************************************/ + +/** + * Returns the complete list of items. + * + * @return The complete list of items in the list. + */ +public synchronized String[] +getItems() +{ + String[] l_items = new String[getItemCount()]; + + items.copyInto(l_items); + return(l_items); +} + +/*************************************************************************/ + +/** + * Returns the item at the specified index. + * + * @param index The index of the item to retrieve. + * + * @exception IndexOutOfBoundsException If the index value is not valid. + */ +public String +getItem(int index) +{ + return((String)items.elementAt(index)); +} + +/*************************************************************************/ + +/** + * Returns the number of visible rows in the list. + * + * @return The number of visible rows in the list. + */ +public int +getRows() +{ + return(rows); +} + +/*************************************************************************/ + +/** + * Tests whether or not multi-select mode is enabled. + * + * @return <code>true</code> if multi-select mode is enabled, + * <code>false</code> otherwise. + */ +public boolean +isMultipleMode() +{ + return(multipleMode); +} + +/*************************************************************************/ + +/** + * Tests whether or not multi-select mode is enabled. + * + * @return <code>true</code> if multi-select mode is enabled, + * <code>false</code> otherwise. + * + * @deprecated This method is deprecated in favor of + * <code>isMultipleMode()</code>. + */ +public boolean +allowsMultipleSelections() +{ + return(multipleMode); +} + +/*************************************************************************/ + +/** + * This method enables or disables multiple selection mode for this + * list. + * + * @param multipleMode <code>true</code> to enable multiple mode, + * <code>false</code> otherwise. + */ +public void +setMultipleMode(boolean multipleMode) +{ + this.multipleMode = multipleMode; + if (peer != null) + { + ListPeer l = (ListPeer) peer; + l.setMultipleMode (multipleMode); + } +} + +/*************************************************************************/ + +/** + * This method enables or disables multiple selection mode for this + * list. + * + * @param multipleMode <code>true</code> to enable multiple mode, + * <code>false</code> otherwise. + */ +public void +setMultipleSelections(boolean multipleMode) +{ + setMultipleMode(multipleMode); +} + +/*************************************************************************/ + +/** + * Returns the minimum size of this component. + * + * @return The minimum size of this component. + */ +public Dimension +getMinimumSize() +{ + return(getMinimumSize(rows)); +} + +/*************************************************************************/ + +/** + * Returns the minimum size of this component. + * + * @return The minimum size of this component. + * + * @deprecated This method is deprecated in favor of + * <code>getMinimumSize</code>. + */ +public Dimension +minimumSize() +{ + return(getMinimumSize(rows)); +} + +/*************************************************************************/ + +/** + * Returns the minimum size of this component assuming it had the specified + * number of rows. + * + * @param rows The number of rows to size for. + * + * @return The minimum size of this component. + */ +public Dimension +getMinimumSize(int rows) +{ + ListPeer lp = (ListPeer)getPeer(); + if (lp != null) + return(lp.minimumSize(rows)); + else + return(new Dimension(0,0)); +} + +/*************************************************************************/ + +/** + * Returns the minimum size of this component assuming it had the specified + * number of rows. + * + * @param rows The number of rows to size for. + * + * @return The minimum size of this component. + * + * @deprecated This method is deprecated in favor of + * <code>getMinimumSize(int)</code>> + */ +public Dimension +minimumSize(int rows) +{ + return(getMinimumSize(rows)); +} + +/*************************************************************************/ + +/** + * Returns the preferred size of this component. + * + * @return The preferred size of this component. + */ +public Dimension +getPreferredSize() +{ + return(getPreferredSize(rows)); +} + +/*************************************************************************/ + +/** + * Returns the preferred size of this component. + * + * @return The preferred size of this component. + * + * @deprecated This method is deprecated in favor of + * <code>getPreferredSize</code>. + */ +public Dimension +preferredSize() +{ + return(getPreferredSize(rows)); +} + +/*************************************************************************/ + +/** + * Returns the preferred size of this component assuming it had the specified + * number of rows. + * + * @param rows The number of rows to size for. + * + * @return The preferred size of this component. + */ +public Dimension +getPreferredSize(int rows) +{ + ListPeer lp = (ListPeer)getPeer(); + if (lp != null) + return(lp.preferredSize(rows)); + else + return(new Dimension(0,0)); +} + +/*************************************************************************/ + +/** + * Returns the preferred size of this component assuming it had the specified + * number of rows. + * + * @param rows The number of rows to size for. + * + * @return The preferred size of this component. + * + * @deprecated This method is deprecated in favor of + * <code>getPreferredSize(int)</code>> + */ +public Dimension +preferredSize(int rows) +{ + return(getPreferredSize(rows)); +} + +/*************************************************************************/ + +/** + * This method adds the specified item to the end of the list. + * + * @param item The item to add to the list. + */ +public void +add(String item) +{ + add(item, -1); } + +/*************************************************************************/ + +/** + * This method adds the specified item to the end of the list. + * + * @param item The item to add to the list. + * + * @deprecated Use add() instead. + */ +public void +addItem(String item) +{ + addItem(item, -1); +} + +/*************************************************************************/ + +/** + * Adds the specified item to the specified location in the list. + * If the desired index is -1 or greater than the number of rows + * in the list, then the item is added to the end. + * + * @param item The item to add to the list. + * @param index The location in the list to add the item, or -1 to add + * to the end. + */ +public void +add(String item, int index) +{ + if ((index == -1) || (index >= items.size())) + items.addElement(item); + else + items.insertElementAt(item, index); + + if (peer != null) + { + ListPeer l = (ListPeer) peer; + l.add (item, index); + } +} + +/*************************************************************************/ + +/** + * Adds the specified item to the specified location in the list. + * If the desired index is -1 or greater than the number of rows + * in the list, then the item is added to the end. + * + * @param item The item to add to the list. + * @param index The location in the list to add the item, or -1 to add + * to the end. + * + * @deprecated Use add() instead. + */ +public void +addItem(String item, int index) +{ + add(item, index); +} + +/*************************************************************************/ + +/** + * Deletes the item at the specified index. + * + * @param index The index of the item to delete. + * + * @exception IllegalArgumentException If the index is not valid + */ +public void +delItem(int index) throws IllegalArgumentException +{ + remove(index); +} + +/*************************************************************************/ + +/** + * Deletes the item at the specified index. + * + * @param index The index of the item to delete. + * + * @exception IllegalArgumentException If the index is not valid + */ +public void +remove(int index) throws IllegalArgumentException +{ + items.removeElementAt (index); + if (peer != null) + { + ListPeer l = (ListPeer) peer; + l.delItems (index, index); + } +} + +/*************************************************************************/ + +/** + * Deletes all items in the specified index range. + * + * @param start The beginning index of the range to delete. + * @param end The ending index of the range to delete. + * + * @exception IllegalArgumentException If the indexes are not valid + * + * @deprecated This method is deprecated for some unknown reason. + */ +public synchronized void +delItems(int start, int end) throws IllegalArgumentException +{ + if ((start < 0) || (start >= items.size())) + throw new IllegalArgumentException("Bad list start index value: " + start); + + if ((start < 0) || (start >= items.size())) + throw new IllegalArgumentException("Bad list start index value: " + start); + + if (start > end) + throw new IllegalArgumentException("Start is greater than end!"); + + // We must run the loop in reverse direction. + for (int i = end; i >= start; --i) + items.removeElementAt (i); + if (peer != null) + { + ListPeer l = (ListPeer) peer; + l.delItems (start, end); + } +} + +/*************************************************************************/ + +/** + * Deletes the first occurrence of the specified item from the list. + * + * @param item The item to delete. + * + * @exception IllegalArgumentException If the specified item does not exist. + */ +public synchronized void +remove(String item) throws IllegalArgumentException +{ + int index = items.indexOf(item); + if (index == -1) + throw new IllegalArgumentException("List element to delete not found"); + + remove(index); +} + +/*************************************************************************/ + +/** + * Deletes all of the items from the list. + */ +public synchronized void +removeAll() +{ + items.clear(); + if (peer != null) + { + ListPeer l = (ListPeer) peer; + l.removeAll (); + } +} + +/*************************************************************************/ + +/** + * Deletes all of the items from the list. + * + * @deprecated This method is deprecated in favor of <code>removeAll()</code>. + */ +public void +clear() +{ + removeAll(); +} + +/*************************************************************************/ + +/** + * Replaces the item at the specified index with the specified item. + * + * @param item The new item value. + * @param index The index of the item to replace. + * + * @exception IllegalArgumentException If the index is not valid. + */ +public synchronized void +replaceItem(String item, int index) throws IllegalArgumentException +{ + remove(index); + addItem(item, index); +} + +/*************************************************************************/ + +/** + * Returns the index of the currently selected item. -1 will be returned + * if there are no selected rows or if there are multiple selected rows. + * + * @return The index of the selected row. + */ +public synchronized int +getSelectedIndex() +{ + if (peer != null) + { + ListPeer l = (ListPeer) peer; + selected = l.getSelectedIndexes (); + } + + if (selected == null || selected.length > 1) + return -1; + return selected[0]; +} + +/*************************************************************************/ + +/** + * Returns an array containing the indexes of the rows that are + * currently selected. + * + * @return A list of indexes of selected rows. + */ +public synchronized int[] +getSelectedIndexes() +{ + if (peer != null) + { + ListPeer l = (ListPeer) peer; + selected = l.getSelectedIndexes (); + } + return selected; +} + +/*************************************************************************/ + +/** + * Returns the item that is currently selected, or <code>null</code> if there + * is no item selected. FIXME: What happens if multiple items selected? + * + * @return The selected item, or <code>null</code> if there is no + * selected item. + */ +public synchronized String +getSelectedItem() +{ + int index = getSelectedIndex(); + if (index == -1) + return(null); + + return((String)items.elementAt(index)); +} + +/*************************************************************************/ + +/** + * Returns the list of items that are currently selected in this list. + * + * @return The list of currently selected items. + */ +public synchronized String[] +getSelectedItems() +{ + int[] indexes = getSelectedIndexes(); + if (indexes == null) + return(new String[0]); + + String[] retvals = new String[indexes.length]; + if (retvals.length > 0) + for (int i = 0 ; i < retvals.length; i++) + retvals[i] = (String)items.elementAt(indexes[i]); + + return(retvals); +} + +/*************************************************************************/ + +/** + * Returns the list of items that are currently selected in this list as + * an array of type <code>Object[]</code> instead of <code>String[]</code>. + * + * @return The list of currently selected items. + */ +public synchronized Object[] +getSelectedObjects() +{ + int[] indexes = getSelectedIndexes(); + if (indexes == null) + return(new Object[0]); + + Object[] retvals = new Object[indexes.length]; + if (retvals.length > 0) + for (int i = 0 ; i < retvals.length; i++) + retvals[i] = items.elementAt(indexes[i]); + + return(retvals); +} + +/*************************************************************************/ + +/** + * Tests whether or not the specified index is selected. + * + * @param index The index to test. + * + * @return <code>true</code> if the index is selected, <code>false</code> + * otherwise. + */ +public boolean +isIndexSelected(int index) +{ + int[] indexes = getSelectedIndexes(); + + for (int i = 0; i < indexes.length; i++) + if (indexes[i] == index) + return(true); + + return(false); +} + +/*************************************************************************/ + +/** + * Tests whether or not the specified index is selected. + * + * @param index The index to test. + * + * @return <code>true</code> if the index is selected, <code>false</code> + * otherwise. + * + * @deprecated This method is deprecated in favor of + * <code>isIndexSelected(int)</code>. + */ +public boolean +isSelected(int index) +{ + return(isIndexSelected(index)); +} + +/*************************************************************************/ + +/** + * This method ensures that the item at the specified index is visible. + * + * @exception IllegalArgumentException If the specified index is out of + * range. + */ +public synchronized void +makeVisible(int index) throws IllegalArgumentException +{ + if ((index < 0) || (index >= items.size())) + throw new IllegalArgumentException("Bad list index: " + index); + + visibleIndex = index; + if (peer != null) + { + ListPeer l = (ListPeer) peer; + l.makeVisible (index); + } +} + +/*************************************************************************/ + +/** + * Returns the index of the last item that was made visible via the + * <code>makeVisible()</code> method. + * + * @return The index of the last item made visible via the + * <code>makeVisible()</code> method. + */ +public int +getVisibleIndex() +{ + return(visibleIndex); +} + +/*************************************************************************/ + +/** + * Makes the item at the specified index selected. + * + * @param index The index of the item to select. + */ +public synchronized void +select(int index) +{ + ListPeer lp = (ListPeer)getPeer(); + if (lp != null) + lp.select(index); +} + +/*************************************************************************/ + +/** + * Makes the item at the specified index not selected. + * + * @param index The index of the item to unselect. + */ +public synchronized void +deselect(int index) +{ + ListPeer lp = (ListPeer)getPeer(); + if (lp != null) + lp.deselect(index); +} + +/*************************************************************************/ + +/** + * Notifies this object to create its native peer. + */ +public void +addNotify() +{ + if (peer != null) + peer = getToolkit ().createList (this); + super.addNotify (); +} + +/*************************************************************************/ + +/** + * Notifies this object to destroy its native peer. + */ +public void +removeNotify() +{ + super.removeNotify(); +} + +/*************************************************************************/ + +/** + * Adds the specified <code>ActionListener</code> to the list of + * registered listeners for this object. + * + * @param listener The listener to add. + */ +public synchronized void +addActionListener(ActionListener listener) +{ + action_listeners = AWTEventMulticaster.add(action_listeners, listener); +} + +/*************************************************************************/ + +/** + * Removes the specified <code>ActionListener</code> from the list of + * registers listeners for this object. + * + * @param listener The listener to remove. + */ +public synchronized void +removeActionListener(ActionListener listener) +{ + action_listeners = AWTEventMulticaster.remove(action_listeners, listener); +} + +/*************************************************************************/ + +/** + * Adds the specified <code>ItemListener</code> to the list of + * registered listeners for this object. + * + * @param listener The listener to add. + */ +public synchronized void +addItemListener(ItemListener listener) +{ + item_listeners = AWTEventMulticaster.add(item_listeners, listener); +} + +/*************************************************************************/ + +/** + * Removes the specified <code>ItemListener</code> from the list of + * registers listeners for this object. + * + * @param listener The listener to remove. + */ +public synchronized void +removeItemListener(ItemListener listener) +{ + item_listeners = AWTEventMulticaster.remove(item_listeners, listener); +} + +/*************************************************************************/ + +/** + * Processes the specified event for this object. If the event is an + * instance of <code>ActionEvent</code> then the + * <code>processActionEvent()</code> method is called. Similarly, if the + * even is an instance of <code>ItemEvent</code> then the + * <code>processItemEvent()</code> method is called. Otherwise the + * superclass method is called to process this event. + * + * @param event The event to process. + */ +protected void +processEvent(AWTEvent event) +{ + if (event instanceof ActionEvent) + processActionEvent((ActionEvent)event); + if (event instanceof ItemEvent) + processItemEvent((ItemEvent)event); + + super.processEvent(event); +} + +/*************************************************************************/ + +/** + * This method processes the specified event by dispatching it to any + * registered listeners. Note that this method will only get called if + * action events are enabled. This will happen automatically if any + * listeners are added, or it can be done "manually" by calling + * the <code>enableEvents()</code> method. + * + * @param event The event to process. + */ +protected void +processActionEvent(ActionEvent event) +{ + if (action_listeners != null) + action_listeners.actionPerformed(event); +} + +/*************************************************************************/ + +/** + * This method processes the specified event by dispatching it to any + * registered listeners. Note that this method will only get called if + * item events are enabled. This will happen automatically if any + * listeners are added, or it can be done "manually" by calling + * the <code>enableEvents()</code> method. + * + * @param event The event to process. + */ +protected void +processItemEvent(ItemEvent event) +{ + if (item_listeners != null) + item_listeners.itemStateChanged(event); +} + +/*************************************************************************/ + +/** + * Returns a debugging string for this object. + * + * @return A debugging string for this object. + */ +protected String +paramString() +{ + return "multiple=" + multipleMode + ",rows=" + rows + super.paramString(); +} + +} // class List |