displayable.html

是MIDP 的API 查詢文件, 大家可以看一下裡面的index.html, 再用Package 或 Class 名字來查.

 of the area available for <code>Displayable</code> content. 
 Addition, removal, or the setting of the title text at runtime
 may dynamically change the size of the content area.
 This is most important to be aware of when using the
 <code>Canvas</code> class.
 If the available area does change, the application will be notified
 via a call to <A HREF="../../../javax/microedition/lcdui/Displayable.html#sizeChanged(int, int)"><CODE>sizeChanged()</CODE></A>. </p><DD><DL>
<DT><B>Parameters:</B><DD><CODE>s</CODE> - the new title, or <code>null</code> for no title<DT><B>Since: </B><DD>MIDP 2.0</DD>
<DT><B>See Also: </B><DD><A HREF="../../../javax/microedition/lcdui/Displayable.html#getTitle()"><CODE>getTitle()</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getTicker()"><!-- --></A><H3>
getTicker</H3>
<PRE>
public <A HREF="../../../javax/microedition/lcdui/Ticker.html">Ticker</A> <B>getTicker</B>()</PRE>
<DL>
<DD>Gets the ticker used by this <code>Displayable</code>.<DD><DL>
<DT><B>Returns:</B><DD>ticker object used, or <code>null</code> if no
 ticker is present<DT><B>Since: </B><DD>MIDP 2.0</DD>
<DT><B>See Also: </B><DD><A HREF="../../../javax/microedition/lcdui/Displayable.html#setTicker(javax.microedition.lcdui.Ticker)"><CODE>setTicker(javax.microedition.lcdui.Ticker)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="setTicker(javax.microedition.lcdui.Ticker)"><!-- --></A><H3>
setTicker</H3>
<PRE>
public void <B>setTicker</B>(<A HREF="../../../javax/microedition/lcdui/Ticker.html">Ticker</A>&nbsp;ticker)</PRE>
<DL>
<DD>Sets a ticker for use with this <code>Displayable</code>,
 replacing any
 previous ticker.
 If <code>null</code>, removes the ticker object
 from this <code>Displayable</code>. The same ticker may be shared by 
 several <code>Displayable</code>
 objects within an application. This is done by calling
 <code>setTicker()</code>
 with the same <code>Ticker</code> object on several
 different <code>Displayable</code> objects.
 If the <code>Displayable</code> is actually visible on the display,
 the implementation should update 
 the display as soon as it is feasible to do so.
 
 <p>The existence of a ticker may affect the size
 of the area available for <code>Displayable's</code> contents. 
 Addition, removal, or the setting of the ticker at runtime
 may dynamically change the size of the content area.
 This is most important to be aware of when using the
 <code>Canvas</code> class.
 If the available area does change, the application will be notified
 via a call to <A HREF="../../../javax/microedition/lcdui/Displayable.html#sizeChanged(int, int)"><CODE>sizeChanged()</CODE></A>. </p><DD><DL>
<DT><B>Parameters:</B><DD><CODE>ticker</CODE> - the ticker object used on this screen<DT><B>Since: </B><DD>MIDP 2.0</DD>
<DT><B>See Also: </B><DD><A HREF="../../../javax/microedition/lcdui/Displayable.html#getTicker()"><CODE>getTicker()</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="isShown()"><!-- --></A><H3>
isShown</H3>
<PRE>
public boolean <B>isShown</B>()</PRE>
<DL>
<DD>Checks if the <code>Displayable</code> is actually visible
 on the display.  In order
 for a <code>Displayable</code> to be visible, all of the
 following must be true:
 the <code>Display's</code> <code>MIDlet</code> must be
 running in the foreground, the <code>Displayable</code>
 must be the <code>Display's</code> current screen, and the
 <code>Displayable</code> must not be
 obscured by a <a href="Display.html#systemscreens">
 system screen</a>.<DD><DL>
<DT><B>Returns:</B><DD><code>true</code> if the
 <code>Displayable</code> is currently visible</DL>
</DD>
</DL>
<HR>

<A NAME="addCommand(javax.microedition.lcdui.Command)"><!-- --></A><H3>
addCommand</H3>
<PRE>
public void <B>addCommand</B>(<A HREF="../../../javax/microedition/lcdui/Command.html">Command</A>&nbsp;cmd)</PRE>
<DL>
<DD>Adds a command to the <code>Displayable</code>. The
 implementation may choose,
 for example,
 to add the command to any of the available soft buttons or place it 
 in a menu.
 If the added command is already in the screen (tested by comparing the
 object references), the method has no effect.
 If the <code>Displayable</code> is actually visible on the
 display, and this call
 affects the set of visible commands, the implementation should update 
 the display as soon as it is feasible to do so.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>cmd</CODE> - the command to be added<DT><B>Throws:</B><DD><CODE><A HREF="../../../java/lang/NullPointerException.html">NullPointerException</A></CODE> - if <code>cmd</code> is
 <code>null</code></DL>
</DD>
</DL>
<HR>

<A NAME="removeCommand(javax.microedition.lcdui.Command)"><!-- --></A><H3>
removeCommand</H3>
<PRE>
public void <B>removeCommand</B>(<A HREF="../../../javax/microedition/lcdui/Command.html">Command</A>&nbsp;cmd)</PRE>
<DL>
<DD>Removes a command from the <code>Displayable</code>.
 If the command is not in the <code>Displayable</code>
 (tested by comparing the
 object references), the method has no effect.
 If the <code>Displayable</code> is actually visible on the
 display, and this call
 affects the set of visible commands, the implementation should update 
 the display as soon as it is feasible to do so.
 If <code>cmd</code> is <code>null</code>, this method
 does nothing.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>cmd</CODE> - the command to be removed</DL>
</DD>
</DL>
<HR>

<A NAME="setCommandListener(javax.microedition.lcdui.CommandListener)"><!-- --></A><H3>
setCommandListener</H3>
<PRE>
public void <B>setCommandListener</B>(<A HREF="../../../javax/microedition/lcdui/CommandListener.html">CommandListener</A>&nbsp;l)</PRE>
<DL>
<DD>Sets a listener for <A HREF="../../../javax/microedition/lcdui/Command.html"><CODE>Commands</CODE></A> to this
 <code>Displayable</code>,
 replacing any previous <code>CommandListener</code>. A
 <code>null</code> reference is
 allowed and has the effect of removing any existing listener.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>l</CODE> - the new listener, or <code>null</code>.</DL>
</DD>
</DL>
<HR>

<A NAME="getWidth()"><!-- --></A><H3>
getWidth</H3>
<PRE>
public int <B>getWidth</B>()</PRE>
<DL>
<DD>Gets the width in pixels of the displayable area available to the 
 application.  The value returned is appropriate for the particular 
 <code>Displayable</code> subclass.  This value may depend
 on how the device uses the
 display and may be affected by the presence of a title, a ticker, or 
 commands.
 This method returns the proper result at all times, even if the
 <code>Displayable</code> object has not yet been shown.<DD><DL>
<DT><B>Returns:</B><DD>width of the area available to the application<DT><B>Since: </B><DD>MIDP 2.0</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="getHeight()"><!-- --></A><H3>
getHeight</H3>
<PRE>
public int <B>getHeight</B>()</PRE>
<DL>
<DD>Gets the height in pixels of the displayable area available to the 
 application.  The value returned is appropriate for the particular 
 <code>Displayable</code> subclass.  This value may depend
 on how the device uses the
 display and may be affected by the presence of a title, a ticker, or 
 commands.
 This method returns the proper result at all times, even if the
 <code>Displayable</code> object has not yet been shown.<DD><DL>
<DT><B>Returns:</B><DD>height of the area available to the application<DT><B>Since: </B><DD>MIDP 2.0</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="sizeChanged(int, int)"><!-- --></A><H3>
sizeChanged</H3>
<PRE>
protected void <B>sizeChanged</B>(int&nbsp;w,
                           int&nbsp;h)</PRE>
<DL>
<DD>The implementation calls this method when the available area of the
 <code>Displayable</code> has been changed. 
 The &quot;available area&quot; is the area of the display that
 may be occupied by
 the application's contents, such as <code>Items</code> in a
 <code>Form</code> or graphics within
 a <code>Canvas</code>.  It does not include space occupied
 by a title, a ticker,
 command labels, scroll bars, system status area, etc.  A size change
 can occur as a result of the addition, removal, or changed contents of 
 any of these display features.

 <p> This method is called at least once before the
 <code>Displayable</code> is shown for the first time.
 If the size of a <code>Displayable</code> changes while
 it is visible,
 <CODE>sizeChanged</CODE> will be called.  If the size of a
 <code>Displayable</code>
 changes while it is <em>not</em> visible, calls to
 <CODE>sizeChanged</CODE> may be deferred.  If the size had changed
 while the <code>Displayable</code> was not visible,
 <CODE>sizeChanged</CODE> will be
 called at least once at the time the
 <code>Displayable</code> becomes visible once
 again.</p>

 <p>The default implementation of this method in <code>Displayable</code>
 and its
 subclasses defined in this specification must be empty.
 This method is intended solely for being overridden by the
 application. This method is defined on <code>Displayable</code>
 even though applications are prohibited from creating 
 direct subclasses of <code>Displayable</code>.
 It is defined here so that applications can override it in
 subclasses of <code>Canvas</code> and <code>Form</code>.
 This is useful for <code>Canvas</code> subclasses to tailor
 their graphics and for <code>Forms</code> to modify
 <code>Item</code> sizes and layout
 directives in order to fit their contents within the the available
 display area.</p><DD><DL>
<DT><B>Parameters:</B><DD><CODE>w</CODE> - the new width in pixels of the available area<DD><CODE>h</CODE> - the new height in pixels of the available area<DT><B>Since: </B><DD>MIDP 2.0</DD>
</DL>
</DD>
</DL>
<!-- ========= END OF CLASS DATA ========= -->
<HR>

<!-- ========== START OF NAVBAR ========== -->
<A NAME="navbar_bottom"><!-- --></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_bottom_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
  <TR ALIGN="center" VALIGN="top">
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/Displayable.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
  </TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
<strong>MID Profile</strong></EM>
</TD>
</TR>

<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
&nbsp;<A HREF="../../../javax/microedition/lcdui/Display.html"><B>PREV CLASS</B></A>&nbsp;
&nbsp;<A HREF="../../../javax/microedition/lcdui/Font.html"><B>NEXT CLASS</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>  &nbsp;
&nbsp;<A HREF="Displayable.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  SUMMARY: &nbsp;INNER&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL: &nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<!-- =========== END OF NAVBAR =========== -->

<HR>
<font size="-1"><a href="mailto:[e-mail]">Submit a comment or suggestion</a> Version 2.0 of MID Profile Specification<br>Java is a trademark or registered trademark of Sun Microsystems,  Inc. in the US and other countries. Copyright (c) 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road,Palo Alto, California, 94303, U.S.A.  All Rights Reserved.</font>
</BODY>
</HTML>