| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> |
| <HEAD><meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> |
| <STYLE type="text/css"> |
| div.dtd-fragment { |
| width: 100%; |
| border: none; |
| background-color: #eee; |
| } |
| </STYLE> |
| </HEAD> |
| <HTML> |
| <BODY> |
| <H1><CENTER>Listeners</CENTER></H1> |
| <b><i>Identifier: </i></b>com.bolour.sample.eclipse.listener.subject.listeners<p> |
| <b><i>Since: </i></b>2.1.0<p> |
| <b><i>Description: </i></b>This extension-point is used to include one or more notification |
| listeners in the host plugin's list of listeners to be notified |
| of host menu events.<p><b><i>Configuration Markup:</i></b><p> |
| <p><samp><font color="#800000"> <!ELEMENT <a name="e.extension">extension</a> (<a href="#e.listener">listener</a>*)></font></samp> |
| <br><br><samp><font color="#800000"> <!ATTLIST extension</samp> |
| <br><samp> point CDATA #REQUIRED</samp> |
| <br><samp> id CDATA #IMPLIED</samp> |
| <br><samp> name CDATA #IMPLIED</samp> |
| <br><samp> ></font></samp> |
| <ul> |
| <li><b>point</b> - The fully-qualified name of the extension point. |
| That is com.bolour.sample.eclipse.listener.subject.listeners.</li> |
| <li><b>id</b> - An optional id.</li> |
| <li><b>name</b> - An optional name.</li> |
| </ul> |
| <p><samp><font color="#800000"> <!ELEMENT <a name="e.listener">listener</a> EMPTY></font></samp> |
| <br><br><samp><font color="#800000"> <!ATTLIST listener</samp> |
| <br><samp> class CDATA #REQUIRED</samp> |
| <br><samp> ></font></samp> |
| <ul> |
| <li><b>class</b> - The fully-qualified name of this listener's callback class. |
| The class is instantiated by the host plugin, and the instance |
| is added to the host plugin's notification list.</li> |
| </ul> |
| <b><i>Examples: </i></b><p> |
| <pre> |
| <font color="#000080"><!-- Extend the listeners of the subject ... --></font> |
| <font color="#000080"><extension |
| id=<font color="#008000">"listener.firstlistener"</font> |
| name=<font color="#008000">"FirstListener"</font> |
| point=<font color="#008000">"com.bolour.sample.eclipse.listener.subject.listeners"</font>></font> |
| <font color="#000080"><!-- ... by a listener of type X ... --></font> |
| <font color="#000080"><listener |
| class=<font color="#008000">"com.bolour.sample.eclipse.listener.firstlistener.ListenerX"</font>/></font> |
| <font color="#000080"><!-- and by a listener of type Y. --></font> |
| <font color="#000080"><listener |
| class=<font color="#008000">"com.bolour.sample.eclipse.listener.firstlistener.ListenerY"</font>/></font> |
| <font color="#000080"></extension></font> |
| </pre> |
| <p><p> |
| <b><i>API Information: </i></b>Each listener callback must implement the interface |
| com.bolour.sample.eclipse.listener.subject.IListener.<p> |
| <b><i>Supplied Implementation: </i></b>An update of the subject plug-in causes a notification to |
| be broadcast to all listeners.<p> |
| <font size="-1" color="#336699"> |
| </font> |
| </BODY> |
| </HTML> |