| java.lang.Object
 java.awt.Component
java.awt.Choice
| Choice | | public class Choice extends Component implements ItemSelectable(Code) | | The Choice class presents a pop-up menu of choices.
The current choice is displayed as the title of the menu.
The following code example produces a pop-up menu:
Choice ColorChooser = new Choice();
ColorChooser.add("Green");
ColorChooser.add("Red");
ColorChooser.add("Blue");
After this choice menu has been added to a panel,
it appears as follows in its normal state:
In the picture, "Green" is the current choice.
Pushing the mouse button down on the object causes a menu to
appear with the current choice highlighted.
version:
1.49 08/10/01
author:
Sami Shaio
author:
Arthur van Hoff
since:
JDK1.0 |
| Constructor Summary | |
| public | Choice()
Creates a new choice menu. |
| Method Summary | |
| public void | add(String item)
Adds an item to this Choice menu. | | public synchronized void | addItem(String item)
Adds an item to this Choice. | | public synchronized void | addItemListener(ItemListener l)
Adds the specified item listener to receive item events from
this Choice menu. | | public void | addNotify()
Creates the Choice's peer. | | String | constructComponentName()
Construct a name for this component. | | public int | countItems()
| | boolean | eventEnabled(AWTEvent e)
| | public String | getItem(int index)
Gets the string at the specified index in this
Choice menu. | | public int | getItemCount()
Returns the number of items in this Choice menu. | | public synchronized ItemListener[] | getItemListeners()
Returns an array of all the item listeners
registered on this choice. | | public int | getSelectedIndex()
Returns the index of the currently selected item. | | public synchronized String | getSelectedItem()
Gets a representation of the current choice as a string. | | public synchronized Object[] | getSelectedObjects()
Returns an array (length 1) containing the currently selected
item. | | public synchronized void | insert(String item, int index)
Inserts the item into this choice at the specified position. | | protected String | paramString()
Returns the parameter string representing the state of this
choice menu. | | protected void | processEvent(AWTEvent e)
Processes events on this choice. | | protected void | processItemEvent(ItemEvent e)
Processes item events occurring on this Choice
menu by dispatching them to any registered
ItemListener objects.
This method is not called unless item events are
enabled for this component. | | public synchronized void | remove(String item)
Remove the first occurrence of item
from the Choice menu. | | public synchronized void | remove(int position)
Removes an item from the choice menu
at the specified position. | | public synchronized void | removeAll()
Removes all items from the choice menu. | | public synchronized void | removeItemListener(ItemListener l)
Removes the specified item listener so that it no longer receives
item events from this Choice menu. | | public void | select(int pos)
Sets the selected item in this Choice menu to be the
item at the specified position. | | public synchronized void | select(String str)
Sets the selected item in this Choice menu
to be the item whose name is equal to the specified string. |
| selectedIndex | | int selectedIndex(Code) | | The index of the current choice for this Choice.
|
| add | | public void add(String item)(Code) | | Adds an item to this Choice menu.
Parameters:
item - the item to be added
exception:
NullPointerException - if the item's value is null.
since:
JDK1.1 |
| addItem | | public synchronized void addItem(String item)(Code) | | Adds an item to this Choice.
Parameters:
item - the item to be added
exception:
NullPointerException - If the item's value is equal to null. |
| constructComponentName | | String constructComponentName()(Code) | | Construct a name for this component. Called by getName() when the
name is null.
|
| countItems | | public int countItems()(Code) | | |
| getItem | | public String getItem(int index)(Code) | | Gets the string at the specified index in this
Choice menu.
Parameters:
index - the index at which to begin.
See Also: java.awt.Choice.getItemCount
since:
JDK1.0 |
| getSelectedItem | | public synchronized String getSelectedItem()(Code) | | Gets a representation of the current choice as a string.
a string representation of the currentlyselected item in this choice menu.
See Also: java.awt.Choice.getSelectedIndex
since:
JDK1.0 |
| getSelectedObjects | | public synchronized Object[] getSelectedObjects()(Code) | | Returns an array (length 1) containing the currently selected
item. If this choice has no items, returns null.
See Also: ItemSelectable |
| insert | | public synchronized void insert(String item, int index)(Code) | | Inserts the item into this choice at the specified position.
Parameters:
item - the item to be inserted
Parameters:
index - the position at which the item should be inserted
exception:
IllegalArgumentException - if index is less than 0. |
| paramString | | protected String paramString()(Code) | | Returns the parameter string representing the state of this
choice menu. This string is useful for debugging.
the parameter string of this Choice menu.
since:
JDK1.0 |
| remove | | public synchronized void remove(String item)(Code) | | Remove the first occurrence of item
from the Choice menu.
Parameters:
item - the item to remove from this Choice menu.
exception:
IllegalArgumentException - if the item doesn'texist in the choice menu.
since:
JDK1.1 |
| remove | | public synchronized void remove(int position)(Code) | | Removes an item from the choice menu
at the specified position.
Parameters:
position - the position of the item.
since:
JDK1.1 |
| select | | public synchronized void select(String str)(Code) | | Sets the selected item in this Choice menu
to be the item whose name is equal to the specified string.
If more than one item matches (is equal to) the specified string,
the one with the smallest index is selected.
Parameters:
str - the specified string
See Also: java.awt.Choice.getSelectedItem
See Also: java.awt.Choice.getSelectedIndex
since:
JDK1.0 |
| Methods inherited from java.awt.Component | public boolean action(Event evt, Object what)(Code)(Java Doc)
public synchronized void add(PopupMenu popup)(Code)(Java Doc)
public synchronized void addComponentListener(ComponentListener l)(Code)(Java Doc)
public synchronized void addFocusListener(FocusListener l)(Code)(Java Doc)
public synchronized void addKeyListener(KeyListener l)(Code)(Java Doc)
public synchronized void addMouseListener(MouseListener l)(Code)(Java Doc)
public synchronized void addMouseMotionListener(MouseMotionListener l)(Code)(Java Doc)
public void addNotify()(Code)(Java Doc)
boolean areInputMethodsEnabled()(Code)(Java Doc)
public Rectangle bounds()(Code)(Java Doc)
final void checkEnableNewEventsOnly(Object listener)(Code)(Java Doc)
public int checkImage(Image image, ImageObserver observer)(Code)(Java Doc)
public int checkImage(Image image, int width, int height, ImageObserver observer)(Code)(Java Doc)
protected AWTEvent coalesceEvents(AWTEvent existingEvent, AWTEvent newEvent)(Code)(Java Doc)
String constructComponentName()(Code)(Java Doc)
public boolean contains(int x, int y)(Code)(Java Doc)
public boolean contains(Point p)(Code)(Java Doc)
public Image createImage(ImageProducer producer)(Code)(Java Doc)
public Image createImage(int width, int height)(Code)(Java Doc)
ComponentXWindow createXWindow()(Code)(Java Doc)
public void deliverEvent(Event e)(Code)(Java Doc)
public void disable()(Code)(Java Doc)
final protected void disableEvents(long eventsToDisable)(Code)(Java Doc)
final public void dispatchEvent(AWTEvent e)(Code)(Java Doc)
void dispatchEventImpl(AWTEvent e)(Code)(Java Doc)
public void doLayout()(Code)(Java Doc)
public void enable()(Code)(Java Doc)
public void enable(boolean b)(Code)(Java Doc)
final protected synchronized void enableEvents(long eventsToEnable)(Code)(Java Doc)
boolean eventEnabled(AWTEvent e)(Code)(Java Doc)
Component findFocusDelegate(Container container)(Code)(Java Doc)
public float getAlignmentX()(Code)(Java Doc)
public float getAlignmentY()(Code)(Java Doc)
public Color getBackground()(Code)(Java Doc)
public Rectangle getBounds()(Code)(Java Doc)
public ColorModel getColorModel()(Code)(Java Doc)
public Component getComponentAt(int x, int y)(Code)(Java Doc)
public Component getComponentAt(Point p)(Code)(Java Doc)
public Cursor getCursor()(Code)(Java Doc)
Component getFocusDelegate()(Code)(Java Doc)
public Font getFont()(Code)(Java Doc)
Component getFontAndColorDelegate()(Code)(Java Doc)
public FontMetrics getFontMetrics(Font font)(Code)(Java Doc)
public Color getForeground()(Code)(Java Doc)
public Graphics getGraphics()(Code)(Java Doc)
InputContext getInputContext()(Code)(Java Doc)
public Locale getLocale()(Code)(Java Doc)
public Point getLocation()(Code)(Java Doc)
public Point getLocationOnScreen()(Code)(Java Doc)
public Dimension getMaximumSize()(Code)(Java Doc)
public Dimension getMinimumSize()(Code)(Java Doc)
public String getName()(Code)(Java Doc)
Container getNativeContainer()(Code)(Java Doc)
public Container getParent()(Code)(Java Doc)
public Dimension getPreferredSize()(Code)(Java Doc)
public Dimension getSize()(Code)(Java Doc)
public Toolkit getToolkit()(Code)(Java Doc)
final public Object getTreeLock()(Code)(Java Doc)
public boolean gotFocus(Event evt, Object what)(Code)(Java Doc)
public boolean handleEvent(Event evt)(Code)(Java Doc)
public void hide()(Code)(Java Doc)
public boolean imageUpdate(Image img, int flags, int x, int y, int w, int h)(Code)(Java Doc)
public boolean inside(int x, int y)(Code)(Java Doc)
public void invalidate()(Code)(Java Doc)
static void invokeAndWait(Runnable runnable)(Code)(Java Doc)
public boolean isDisplayable()(Code)(Java Doc)
public boolean isEnabled()(Code)(Java Doc)
public boolean isFocusTraversable()(Code)(Java Doc)
public boolean isLightweight()(Code)(Java Doc)
boolean isLightweightWhenDisplayable()(Code)(Java Doc)
public boolean isOpaque()(Code)(Java Doc)
public boolean isShowing()(Code)(Java Doc)
public boolean isValid()(Code)(Java Doc)
public boolean isVisible()(Code)(Java Doc)
public boolean keyDown(Event evt, int key)(Code)(Java Doc)
public boolean keyUp(Event evt, int key)(Code)(Java Doc)
public void layout()(Code)(Java Doc)
void lightweightPrint(Graphics g)(Code)(Java Doc)
public void list()(Code)(Java Doc)
public void list(PrintStream out)(Code)(Java Doc)
public void list(PrintStream out, int indent)(Code)(Java Doc)
public void list(PrintWriter out)(Code)(Java Doc)
public void list(PrintWriter out, int indent)(Code)(Java Doc)
public Component locate(int x, int y)(Code)(Java Doc)
public Point location()(Code)(Java Doc)
public boolean lostFocus(Event evt, Object what)(Code)(Java Doc)
public Dimension minimumSize()(Code)(Java Doc)
public boolean mouseDown(Event evt, int x, int y)(Code)(Java Doc)
public boolean mouseDrag(Event evt, int x, int y)(Code)(Java Doc)
public boolean mouseEnter(Event evt, int x, int y)(Code)(Java Doc)
public boolean mouseExit(Event evt, int x, int y)(Code)(Java Doc)
public boolean mouseMove(Event evt, int x, int y)(Code)(Java Doc)
public boolean mouseUp(Event evt, int x, int y)(Code)(Java Doc)
public void move(int x, int y)(Code)(Java Doc)
public void nextFocus()(Code)(Java Doc)
public void paint(Graphics g)(Code)(Java Doc)
public void paintAll(Graphics g)(Code)(Java Doc)
protected String paramString()(Code)(Java Doc)
public boolean postEvent(Event e)(Code)(Java Doc)
public Dimension preferredSize()(Code)(Java Doc)
public boolean prepareImage(Image image, ImageObserver observer)(Code)(Java Doc)
public boolean prepareImage(Image image, int width, int height, ImageObserver observer)(Code)(Java Doc)
public void print(Graphics g)(Code)(Java Doc)
public void printAll(Graphics g)(Code)(Java Doc)
protected void processComponentEvent(ComponentEvent e)(Code)(Java Doc)
protected void processEvent(AWTEvent e)(Code)(Java Doc)
protected void processFocusEvent(FocusEvent e)(Code)(Java Doc)
protected void processKeyEvent(KeyEvent e)(Code)(Java Doc)
protected void processMouseEvent(MouseEvent e)(Code)(Java Doc)
protected void processMouseMotionEvent(MouseEvent e)(Code)(Java Doc)
public synchronized void remove(MenuComponent popup)(Code)(Java Doc)
public synchronized void removeComponentListener(ComponentListener l)(Code)(Java Doc)
public synchronized void removeFocusListener(FocusListener l)(Code)(Java Doc)
public synchronized void removeKeyListener(KeyListener l)(Code)(Java Doc)
public synchronized void removeMouseListener(MouseListener l)(Code)(Java Doc)
public synchronized void removeMouseMotionListener(MouseMotionListener l)(Code)(Java Doc)
public void removeNotify()(Code)(Java Doc)
public void repaint()(Code)(Java Doc)
public void repaint(long tm)(Code)(Java Doc)
public void repaint(int x, int y, int width, int height)(Code)(Java Doc)
public void repaint(long tm, int x, int y, int width, int height)(Code)(Java Doc)
public void requestFocus()(Code)(Java Doc)
public void reshape(int x, int y, int width, int height)(Code)(Java Doc)
public void resize(int width, int height)(Code)(Java Doc)
public void resize(Dimension d)(Code)(Java Doc)
public void setBackground(Color c)(Code)(Java Doc)
public void setBounds(int x, int y, int width, int height)(Code)(Java Doc)
public void setBounds(Rectangle r)(Code)(Java Doc)
public synchronized void setCursor(Cursor cursor)(Code)(Java Doc)
public void setEnabled(boolean b)(Code)(Java Doc)
public void setFont(Font f)(Code)(Java Doc)
public void setForeground(Color c)(Code)(Java Doc)
public void setLocale(Locale l)(Code)(Java Doc)
public void setLocation(int x, int y)(Code)(Java Doc)
public void setLocation(Point p)(Code)(Java Doc)
public void setName(String name)(Code)(Java Doc)
public void setSize(int width, int height)(Code)(Java Doc)
public void setSize(Dimension d)(Code)(Java Doc)
public void setVisible(boolean b)(Code)(Java Doc)
public void show()(Code)(Java Doc)
public void show(boolean b)(Code)(Java Doc)
public Dimension size()(Code)(Java Doc)
public String toString()(Code)(Java Doc)
public void transferFocus()(Code)(Java Doc)
public void update(Graphics g)(Code)(Java Doc)
public void validate()(Code)(Java Doc)
|
|
|