groupdrawable.html

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

<DD>Provided for subclasses to create a group drawable.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>initialSize</CODE> - initial size of the Drawable object<DD><CODE>bc</CODE> - the background color<DD><CODE>scale</CODE> - the scale of the Space's Timer<DD><CODE>period</CODE> - the period of the Space's Timer.<DD><CODE>p</CODE> - the Protocol that is enforced on candidate member objects of this group</DL>
</DD>
</DL>
<HR>

<A NAME="GroupDrawable(quicktime.qd.QDDimension, quicktime.qd.QDColor, int, int, quicktime.app.spaces.Protocol)"><!-- --></A><H3>
GroupDrawable</H3>
<PRE>
protected <B>GroupDrawable</B>(<A HREF="../../../quicktime/qd/QDDimension.html">QDDimension</A>&nbsp;initialSize,
                        <A HREF="../../../quicktime/qd/QDColor.html">QDColor</A>&nbsp;bc,
                        int&nbsp;scale,
                        int&nbsp;period,
                        <A HREF="../../../quicktime/app/spaces/Protocol.html">Protocol</A>&nbsp;p)
                 throws <A HREF="../../../quicktime/QTException.html">QTException</A></PRE>
<DL>
<DD>Provided for subclasses to create a group drawable.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>initialSize</CODE> - initial size of the Drawable object<DD><CODE>bc</CODE> - the background color<DD><CODE>scale</CODE> - the scale of the Space's Timer<DD><CODE>period</CODE> - the period of the Space's Timer.<DD><CODE>p</CODE> - the Protocol that is enforced on candidate member objects of this group</DL>
</DD>
</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="getGWorld()"><!-- --></A><H3>
getGWorld</H3>
<PRE>
public <A HREF="../../../quicktime/qd/QDGraphics.html">QDGraphics</A> <B>getGWorld</B>()
                     throws <A HREF="../../../quicktime/std/StdQTException.html">StdQTException</A></PRE>
<DL>
<DD>QTCanvas calls this method to get the destination QDGraphics of its client.<DD><DL>
<DT><B>Specified by: </B><DD><CODE><A HREF="../../../quicktime/app/display/QTDrawable.html#getGWorld()">getGWorld</A></CODE> in interface <CODE><A HREF="../../../quicktime/app/display/QTDrawable.html">QTDrawable</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>a QDGraphics object or null</DL>
</DD>
</DL>
<HR>

<A NAME="setGWorld(quicktime.qd.QDGraphics)"><!-- --></A><H3>
setGWorld</H3>
<PRE>
public void <B>setGWorld</B>(<A HREF="../../../quicktime/qd/QDGraphics.html">QDGraphics</A>&nbsp;cgp)
               throws <A HREF="../../../quicktime/QTException.html">QTException</A></PRE>
<DL>
<DD>QTCanvas calls this method to give the client the QDGraphics object it should 
 use to do its drawing. If the incoming QDGraphics is the QDGraphics.scratch then
 the drawable will not be visible and can disable itself.
 If a client is unable to set the graphics world it should throw an exception.
 <br><DD><DL>
<DT><B>Specified by: </B><DD><CODE><A HREF="../../../quicktime/app/display/QTDrawable.html#setGWorld(quicktime.qd.QDGraphics)">setGWorld</A></CODE> in interface <CODE><A HREF="../../../quicktime/app/display/QTDrawable.html">QTDrawable</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>cgp</CODE> - a QDGraphics object</DL>
</DD>
</DL>
<HR>

<A NAME="setLocation(int, int)"><!-- --></A><H3>
setLocation</H3>
<PRE>
public void <B>setLocation</B>(int&nbsp;x,
                        int&nbsp;y)
                 throws <A HREF="../../../quicktime/QTException.html">QTException</A></PRE>
<DL>
<DD>A convenience method to set the position of a QTDrawable object.<DD><DL>
<DT><B>Specified by: </B><DD><CODE><A HREF="../../../quicktime/app/display/QTDrawable.html#setLocation(int, int)">setLocation</A></CODE> in interface <CODE><A HREF="../../../quicktime/app/display/QTDrawable.html">QTDrawable</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>x</CODE> - the new x location<DD><CODE>y</CODE> - the new y location</DL>
</DD>
</DL>
<HR>

<A NAME="setDisplayBounds(quicktime.qd.QDRect)"><!-- --></A><H3>
setDisplayBounds</H3>
<PRE>
public void <B>setDisplayBounds</B>(<A HREF="../../../quicktime/qd/QDRect.html">QDRect</A>&nbsp;bounds)
                      throws <A HREF="../../../quicktime/QTException.html">QTException</A></PRE>
<DL>
<DD>This method is called automatically via the QTCanvas object associated with
 this client to set its boundary.
 <br><DD><DL>
<DT><B>Specified by: </B><DD><CODE><A HREF="../../../quicktime/app/display/Drawable.html#setDisplayBounds(quicktime.qd.QDRect)">setDisplayBounds</A></CODE> in interface <CODE><A HREF="../../../quicktime/app/display/Drawable.html">Drawable</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>bounds</CODE> - a QDRect object describing the boundary</DL>
</DD>
</DL>
<HR>

<A NAME="getDisplayBounds()"><!-- --></A><H3>
getDisplayBounds</H3>
<PRE>
public <A HREF="../../../quicktime/qd/QDRect.html">QDRect</A> <B>getDisplayBounds</B>()
                        throws <A HREF="../../../quicktime/std/StdQTException.html">StdQTException</A></PRE>
<DL>
<DD>This method is called automatically via the QTCanvas object associated with
 this client to set the boundary of the movie.
 <br><DD><DL>
<DT><B>Specified by: </B><DD><CODE><A HREF="../../../quicktime/app/display/Drawable.html#getDisplayBounds()">getDisplayBounds</A></CODE> in interface <CODE><A HREF="../../../quicktime/app/display/Drawable.html">Drawable</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>bounds</CODE> - a QDRect object describing the boundary</DL>
</DD>
</DL>
<HR>

<A NAME="getBackgroundColor()"><!-- --></A><H3>
getBackgroundColor</H3>
<PRE>
public <A HREF="../../../quicktime/qd/QDColor.html">QDColor</A> <B>getBackgroundColor</B>()</PRE>
<DL>
<DD>Returns the current background colour or null if no background colour.<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="setBackgroundColor(quicktime.qd.QDColor)"><!-- --></A><H3>
setBackgroundColor</H3>
<PRE>
public void <B>setBackgroundColor</B>(<A HREF="../../../quicktime/qd/QDColor.html">QDColor</A>&nbsp;col)
                        throws <A HREF="../../../quicktime/QTException.html">QTException</A></PRE>
<DL>
<DD>Sets the background color. This will force a redraw of the Compositor.<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="removeMember(java.lang.Object)"><!-- --></A><H3>
removeMember</H3>
<PRE>
public void <B>removeMember</B>(java.lang.Object&nbsp;member)
                  throws <A HREF="../../../quicktime/QTException.html">QTException</A></PRE>
<DL>
<DD>Remove a QTDrawable object from the Group of drawn items.<DD><DL>
<DT><B>Specified by: </B><DD><CODE><A HREF="../../../quicktime/app/spaces/Collection.html#removeMember(java.lang.Object)">removeMember</A></CODE> in interface <CODE><A HREF="../../../quicktime/app/spaces/Collection.html">Collection</A></CODE><DT><B>Overrides:</B><DD><CODE><A HREF="../../../quicktime/app/spaces/SimpleSpace.html#removeMember(java.lang.Object)">removeMember</A></CODE> in class <CODE><A HREF="../../../quicktime/app/spaces/SimpleSpace.html">SimpleSpace</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>QTDrawable</CODE> - drawer the item to remove</DL>
</DD>
</DL>
<HR>

<A NAME="members()"><!-- --></A><H3>
members</H3>
<PRE>
public java.util.Enumeration <B>members</B>()</PRE>
<DL>
<DD>Returns an iterator of QTDrawable members that are the items that are 
 currently contained within the DirectGroup.<DD><DL>
<DT><B>Specified by: </B><DD><CODE><A HREF="../../../quicktime/app/spaces/Collection.html#members()">members</A></CODE> in interface <CODE><A HREF="../../../quicktime/app/spaces/Collection.html">Collection</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>an Enumeration</DL>
</DD>
</DL>
<HR>

<A NAME="isEmpty()"><!-- --></A><H3>
isEmpty</H3>
<PRE>
public boolean <B>isEmpty</B>()</PRE>
<DL>
<DD>Returns true if the space does not have any members.<DD><DL>
<DT><B>Specified by: </B><DD><CODE><A HREF="../../../quicktime/app/spaces/Collection.html#isEmpty()">isEmpty</A></CODE> in interface <CODE><A HREF="../../../quicktime/app/spaces/Collection.html">Collection</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>a boolean</DL>
</DD>
</DL>
<HR>

<A NAME="getGroupMember(java.lang.Object)"><!-- --></A><H3>
getGroupMember</H3>
<PRE>
public <A HREF="../../../quicktime/app/display/GroupMember.html">GroupMember</A> <B>getGroupMember</B>(java.lang.Object&nbsp;member)</PRE>
<DL>
<DD>Returns a GroupMember that contains the specified QTDrawable object or null
 if the requested item is not a member of this group.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>drawer</CODE> - the QTDrawable object to search for.<DT><B>Returns:</B><DD>a GroupMember that contains the layer and alignment information for the member in this group</DL>
</DD>
</DL>
<HR>

<A NAME="size()"><!-- --></A><H3>
size</H3>
<PRE>
public int <B>size</B>()</PRE>
<DL>
<DD>Returns the number of members in the collection, ie. the collection's size.<DD><DL>
<DT><B>Specified by: </B><DD><CODE><A HREF="../../../quicktime/app/spaces/Collection.html#size()">size</A></CODE> in interface <CODE><A HREF="../../../quicktime/app/spaces/Collection.html">Collection</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>the size of the collection.</DL>
</DD>
</DL>
<HR>

<A NAME="memberChanged(quicktime.app.display.QTDrawable)"><!-- --></A><H3>
memberChanged</H3>
<PRE>
public abstract <A HREF="../../../quicktime/app/display/GroupMember.html">GroupMember</A> <B>memberChanged</B>(<A HREF="../../../quicktime/app/display/QTDrawable.html">QTDrawable</A>&nbsp;d)
                                   throws <A HREF="../../../quicktime/QTException.html">QTException</A></PRE>
<DL>
<DD>This tells the group that the position or display size of the 
 drawer has changed and it should do whatever actions are appropriate
 to reestablish the display integrity of the group.
 If the drawer is not a member of the group then null should be returned, if
 it is a member then a GroupMember object is returned that contains the layout
 characteristics of the drawer.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>d</CODE> - the drawer that has changed<DT><B>Returns:</B><DD>the GroupMember object that is associated with that drawer.</DL>
</DD>
</DL>
<HR>

<A NAME="redrawMember(quicktime.app.display.QTDrawable, quicktime.qd.Region)"><!-- --></A><H3>
redrawMember</H3>
<PRE>
public abstract void <B>redrawMember</B>(<A HREF="../../../quicktime/app/display/QTDrawable.html">QTDrawable</A>&nbsp;d,
                                  <A HREF="../../../quicktime/qd/Region.html">Region</A>&nbsp;invalidRgn)
                           throws <A HREF="../../../quicktime/QTException.html">QTException</A></PRE>
<DL>
<DD>An optimized redraw that will redraw only those objects that it needs to
 based on the fact that the supplied drawer has changed but those behind or in front 
 of it have not.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>d</CODE> - the member of which some display characteristic has changed.<DD><CODE>invalidRgn</CODE> - the Region that has changed as a result of the changes in the specified
 member. Generally this Region should encompass the area of the Group's display space that
 was occupied before the member was changed as this call will result in the member
 itself being redrawn.</DL>
</DD>
</DL>
<HR>

<A NAME="setMemberAlignment(quicktime.app.display.QTDrawable, float, float)"><!-- --></A><H3>
setMemberAlignment</H3>
<PRE>
public boolean <B>setMemberAlignment</B>(<A HREF="../../../quicktime/app/display/QTDrawable.html">QTDrawable</A>&nbsp;d,
                                  float&nbsp;xAlign,
                                  float&nbsp;yAlign)
                           throws <A HREF="../../../quicktime/QTException.html">QTException</A></PRE>
<DL>
<DD>This will reset an item's alignment and redraw the group.
 Internally the group uses alignment values to recall where an
 item is in relation to the other members and the group's display space.
 Upon resize of the group's display space items are layed out in accordance
 of their alignment settings.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>d</CODE> - the drawer to reposition the alignment<DD><CODE>xAlign</CODE> - the new x alignment value for the member<DD><CODE>yAlign</CODE> - the new y alignemen value for the member<DT><B>Returns:</B><DD>true if the drawer is a member of the group</DL>
</DD>
</DL>
<HR>

<A NAME="setMemberLayer(quicktime.app.display.QTDrawable, int)"><!-- --></A><H3>
setMemberLayer</H3>
<PRE>
public boolean <B>setMemberLayer</B>(<A HREF="../../../quicktime/app/display/QTDrawable.html">QTDrawable</A>&nbsp;member,
                              int&nbsp;layer)
                       throws <A HREF="../../../quicktime/QTException.html">QTException</A></PRE>
<DL>
<DD>This sets the layer of the incoming drawable to the new layer.
 It returns true if the drawable is a member of the group and
 was reset, false otherwise.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>d</CODE> - the group member to reset<DD><CODE>layer</CODE> - the new layer<DT><B>Returns:</B><DD>true if d is a member of the group</DL>
</DD>
</DL>