qtmousecontroller.html

这个是java的quicktime for java 的详细使用文档

<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../quicktime/app/event/QTMouseController.html#mouseExited(quicktime.app.event.QTMouseEvent)">mouseExited</A></B>(<A HREF="../../../quicktime/app/event/QTMouseEvent.html">QTMouseEvent</A>&nbsp;e)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;If the QTMouseController has a MouseEnterExitListener(s) it will 
 dispatch a mouseExited event when the mouse moves or is dragged out of the space.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../quicktime/app/event/QTMouseController.html#mouseMoved(quicktime.app.event.QTMouseEvent)">mouseMoved</A></B>(<A HREF="../../../quicktime/app/event/QTMouseEvent.html">QTMouseEvent</A>&nbsp;e)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;If the QTMouseController has a MouseMoveListener(s) it will 
 dispatch move events that occur within its Space's area to those listeners.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../quicktime/app/event/QTMouseController.html#mousePressed(quicktime.app.event.QTMouseEvent)">mousePressed</A></B>(<A HREF="../../../quicktime/app/event/QTMouseEvent.html">QTMouseEvent</A>&nbsp;e)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;If the QTMouseController has a MouseButtonListener(s) it will 
 dispatch press events that occur within its Space's area to those listeners.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../quicktime/app/event/QTMouseController.html#mouseReleased(quicktime.app.event.QTMouseEvent)">mouseReleased</A></B>(<A HREF="../../../quicktime/app/event/QTMouseEvent.html">QTMouseEvent</A>&nbsp;e)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;If the QTMouseController has a MouseButtonListener(s) it will 
 dispatch release events that occur within its Space's area to those listeners.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>protected &nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../quicktime/app/event/QTMouseController.html#removeActiveHandler()">removeActiveHandler</A></B>()</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;This method is called when a controller is removed from its space and it had an active event
 handler</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../quicktime/app/event/QTMouseController.html#removedFrom(java.lang.Object)">removedFrom</A></B>(java.lang.Object&nbsp;interest)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;This method is called by the specified object when the instance of 
 the class that implements this interface is removed from the object
 that is the source of the interest.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../quicktime/app/event/QTMouseController.html#removedFromSpace()">removedFromSpace</A></B>()</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Called by the Space when a Controller is being removed
 from a Space.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../quicktime/app/event/QTMouseController.html#removeQTMouseListener(quicktime.app.event.QTMouseListener)">removeQTMouseListener</A></B>(<A HREF="../../../quicktime/app/event/QTMouseListener.html">QTMouseListener</A>&nbsp;l)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Remove a QTMouseListener for this controller.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>protected &nbsp;boolean</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../quicktime/app/event/QTMouseController.html#translateAndIsWithin(quicktime.app.event.QTMouseEvent)">translateAndIsWithin</A></B>(<A HREF="../../../quicktime/app/event/QTMouseEvent.html">QTMouseEvent</A>&nbsp;e)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;This method returns true if the location of the QTMouseEvent is
 within the Space's area, or false if it isn't.</TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TD><B>Methods inherited from class java.lang.Object</B></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE>clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait</CODE></TD>
</TR>
</TABLE>
&nbsp;
<P>

<!-- ============ FIELD DETAIL =========== -->

<A NAME="field_detail"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=1><FONT SIZE="+2">
<B>Field Detail</B></FONT></TD>
</TR>
</TABLE>

<A NAME="space"><!-- --></A><H3>
space</H3>
<PRE>
protected <A HREF="../../../quicktime/app/spaces/Space.html">Space</A> <B>space</B></PRE>
<DL>
<DD>The space which the controller is attached too. If the controller is not
 attached to a space this variable will be null. It is set in the addedToSpace method.</DL>

<!-- ========= CONSTRUCTOR DETAIL ======== -->

<A NAME="constructor_detail"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=1><FONT SIZE="+2">
<B>Constructor Detail</B></FONT></TD>
</TR>
</TABLE>

<A NAME="QTMouseController()"><!-- --></A><H3>
QTMouseController</H3>
<PRE>
public <B>QTMouseController</B>()</PRE>
<DL>
<DD>Creates a mouse controller.</DL>

<!-- ============ METHOD DETAIL ========== -->

<A NAME="method_detail"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=1><FONT SIZE="+2">
<B>Method Detail</B></FONT></TD>
</TR>
</TABLE>

<A NAME="getSpace()"><!-- --></A><H3>
getSpace</H3>
<PRE>
public <A HREF="../../../quicktime/app/spaces/Space.html">Space</A> <B>getSpace</B>()</PRE>
<DL>
<DD>This method returns the Space which the MouseController has been attached to.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>the current space.</DL>
</DD>
</DL>
<HR>

<A NAME="addedToSpace(quicktime.app.spaces.Space)"><!-- --></A><H3>
addedToSpace</H3>
<PRE>
public void <B>addedToSpace</B>(<A HREF="../../../quicktime/app/spaces/Space.html">Space</A>&nbsp;s)</PRE>
<DL>
<DD>This method is called by the space when a Controller is being addedTo the Space s.
 If the Controller is not an appropriate controller for that kind of Space this
 method can throw an exception and the controller won't be added to the Space.<DD><DL>
<DT><B>Specified by: </B><DD><CODE><A HREF="../../../quicktime/app/spaces/Controller.html#addedToSpace(quicktime.app.spaces.Space)">addedToSpace</A></CODE> in interface <CODE><A HREF="../../../quicktime/app/spaces/Controller.html">Controller</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>s</CODE> - the Space being added to<DT><B>See Also: </B><DD><CODE>setTargetSpace()</CODE></DL>
</DD>
</DL>
<HR>

<A NAME="removedFromSpace()"><!-- --></A><H3>
removedFromSpace</H3>
<PRE>
public void <B>removedFromSpace</B>()</PRE>
<DL>
<DD>Called by the Space when a Controller is being removed
 from a Space. This is only called by the Space on controllers that have
 previously been added, thus the space they are being removed from
 is the space they were added to. Sets the targetSpace to null.<DD><DL>
<DT><B>Specified by: </B><DD><CODE><A HREF="../../../quicktime/app/spaces/Controller.html#removedFromSpace()">removedFromSpace</A></CODE> in interface <CODE><A HREF="../../../quicktime/app/spaces/Controller.html">Controller</A></CODE></DL>
</DD>
</DL>
<HR>

<A NAME="addedTo(java.lang.Object)"><!-- --></A><H3>
addedTo</H3>
<PRE>
public void <B>addedTo</B>(java.lang.Object&nbsp;interest)</PRE>
<DL>
<DD>This method is called by the specified object when the instance of 
 the class that implements this interface is added to the object
 that is the source of the interest. When this method is called the source
 of interest will determine the event handling mechanism that must be installed.
 The event dispatch to the QTMouseController is handled by an EventDispatcher
 that is created for the QTMouseController.<DD><DL>
<DT><B>Specified by: </B><DD><CODE><A HREF="../../../quicktime/app/spaces/Listener.html#addedTo(java.lang.Object)">addedTo</A></CODE> in interface <CODE><A HREF="../../../quicktime/app/spaces/Listener.html">Listener</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>interest</CODE> - the object that is to be the source of interest for the
 the object that implements this interface.</DL>
</DD>
</DL>
<HR>

<A NAME="removedFrom(java.lang.Object)"><!-- --></A><H3>
removedFrom</H3>
<PRE>
public void <B>removedFrom</B>(java.lang.Object&nbsp;interest)</PRE>
<DL>
<DD>This method is called by the specified object when the instance of 
 the class that implements this interface is removed from the object
 that is the source of the interest.<DD><DL>
<DT><B>Specified by: </B><DD><CODE><A HREF="../../../quicktime/app/spaces/Listener.html#removedFrom(java.lang.Object)">removedFrom</A></CODE> in interface <CODE><A HREF="../../../quicktime/app/spaces/Listener.html">Listener</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>interest</CODE> - the object that was the source of interest for the
 the object that implements this interface.</DL>
</DD>
</DL>
<HR>

<A NAME="addHandler()"><!-- --></A><H3>
addHandler</H3>
<PRE>
protected void <B>addHandler</B>()</PRE>
<DL>
<DD>This method is called when a controller is added to its space and
 the controller needs to create its event handler<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="removeActiveHandler()"><!-- --></A><H3>
removeActiveHandler</H3>
<PRE>
protected void <B>removeActiveHandler</B>()</PRE>
<DL>
<DD>This method is called when a controller is removed from its space and it had an active event
 handler<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="translateAndIsWithin(quicktime.app.event.QTMouseEvent)"><!-- --></A><H3>
translateAndIsWithin</H3>
<PRE>
protected boolean <B>translateAndIsWithin</B>(<A HREF="../../../quicktime/app/event/QTMouseEvent.html">QTMouseEvent</A>&nbsp;e)</PRE>
<DL>
<DD>This method returns true if the location of the QTMouseEvent is
 within the Space's area, or false if it isn't. This test
 assumes that the space is some kind of QTDisplaySpace, and can
 be overriden for a custom Space.
 <P>
 If the event is located within the space the coordinates of the event
 will be translated into the local coordinates of the space, with the top, left
 point of the space being 0,0. Returning true will also indicate that this
 translation has been done on the event coordinates.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>e</CODE> - the mouse event<DT><B>Returns:</B><DD>a boolean</DL>
</DD>
</DL>
<HR>

<A NAME="addQTMouseListener(quicktime.app.event.QTMouseListener)"><!-- --></A><H3>
addQTMouseListener</H3>
<PRE>
public void <B>addQTMouseListener</B>(<A HREF="../../../quicktime/app/event/QTMouseListener.html">QTMouseListener</A>&nbsp;l)</PRE>
<DL>
<DD>Add a QTMouseListener for this controller. The controller
 will take the appropriate action based on the known mouse listeners
 in the quicktime.app.event package.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>l</CODE> - a new QTMouseListener</DL>
</DD>
</DL>
<HR>