MathItemListener (J/Link 5.3 API Documentation)

java.lang.Object
- com.wolfram.jlink.MathListener
- - com.wolfram.jlink.MathItemListener

All Implemented Interfaces:

java.awt.event.ItemListener, java.util.EventListener
```
public class MathItemListener
extends MathListener
implements java.awt.event.ItemListener
```
This class lets you trigger a call into Mathematica on the occurrence of a particular event. Like all the MathXXXListener classes, it is intended to be used primarily from Mathematica, although it can be used from Java code as well.
In response to an ItemEvent, objects of this class send to Mathematica:
```
     userCode[theItemEvent, theItemEvent.getStateChange()]
```
userFunc is specified as a string, either a function name or an expression (like a pure function "foo[##]&"), via the setHandler() method.

Constructor Summary

Constructors
Constructor	Description
`MathItemListener()`	The constructor that is typically called from Mathematica.
`MathItemListener(KernelLink ml)`	You must use this constructor when using this class in a Java program, because you need to specify the KernelLink that will be used.
`MathItemListener(java.lang.String func)`	Because the ItemListener interface has only one method, itemStateChanged(), you can specify the Mathematica function to be called with this constructor, rather than having to separately call setHandler().

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type Method Description

void itemStateChanged(java.awt.event.ItemEvent e)
- Methods inherited from class com.wolfram.jlink.MathListener
  callMathHandler, callVoidMathHandler, getHandler, getLink, setHandler
- Methods inherited from class java.lang.Object
  clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - MathItemListener
```
public MathItemListener()
```
    The constructor that is typically called from Mathematica.
  - MathItemListener
```
public MathItemListener(KernelLink ml)
```
    You must use this constructor when using this class in a Java program, because you need to specify the KernelLink that will be used.
    
    Parameters:
    
    ml - The link to which computations will be sent when itemStateChanged is called.
  - MathItemListener
```
public MathItemListener(java.lang.String func)
```
    Because the ItemListener interface has only one method, itemStateChanged(), you can specify the Mathematica function to be called with this constructor, rather than having to separately call setHandler(). Use this constructor from Mathematica code only.
    
    Parameters:
    
    func - The Mathematica function to be executed in response to an ItemEvent.
- Method Detail
  - itemStateChanged
```
public void itemStateChanged(java.awt.event.ItemEvent e)
```
    Specified by:
    
    itemStateChanged in interface java.awt.event.ItemListener