contactlist.html

J2ME手机编程规范JSR-75文档

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Removes a specific Contact from the list.</TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_javax.microedition.pim.PIMList"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TD><B>Methods inherited from interface javax.microedition.pim.<A HREF="../../../javax/microedition/pim/PIMList.html">PIMList</A></B></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><A HREF="../../../javax/microedition/pim/PIMList.html#addCategory(java.lang.String)">addCategory</A>, <A HREF="../../../javax/microedition/pim/PIMList.html#close()">close</A>, <A HREF="../../../javax/microedition/pim/PIMList.html#deleteCategory(java.lang.String, boolean)">deleteCategory</A>, <A HREF="../../../javax/microedition/pim/PIMList.html#getArrayElementLabel(int, int)">getArrayElementLabel</A>, <A HREF="../../../javax/microedition/pim/PIMList.html#getAttributeLabel(int)">getAttributeLabel</A>, <A HREF="../../../javax/microedition/pim/PIMList.html#getCategories()">getCategories</A>, <A HREF="../../../javax/microedition/pim/PIMList.html#getFieldDataType(int)">getFieldDataType</A>, <A HREF="../../../javax/microedition/pim/PIMList.html#getFieldLabel(int)">getFieldLabel</A>, <A HREF="../../../javax/microedition/pim/PIMList.html#getName()">getName</A>, <A HREF="../../../javax/microedition/pim/PIMList.html#getSupportedArrayElements(int)">getSupportedArrayElements</A>, <A HREF="../../../javax/microedition/pim/PIMList.html#getSupportedAttributes(int)">getSupportedAttributes</A>, <A HREF="../../../javax/microedition/pim/PIMList.html#getSupportedFields()">getSupportedFields</A>, <A HREF="../../../javax/microedition/pim/PIMList.html#isCategory(java.lang.String)">isCategory</A>, <A HREF="../../../javax/microedition/pim/PIMList.html#isSupportedArrayElement(int, int)">isSupportedArrayElement</A>, <A HREF="../../../javax/microedition/pim/PIMList.html#isSupportedAttribute(int, int)">isSupportedAttribute</A>, <A HREF="../../../javax/microedition/pim/PIMList.html#isSupportedField(int)">isSupportedField</A>, <A HREF="../../../javax/microedition/pim/PIMList.html#items()">items</A>, <A HREF="../../../javax/microedition/pim/PIMList.html#items(javax.microedition.pim.PIMItem)">items</A>, <A HREF="../../../javax/microedition/pim/PIMList.html#items(java.lang.String)">items</A>, <A HREF="../../../javax/microedition/pim/PIMList.html#itemsByCategory(java.lang.String)">itemsByCategory</A>, <A HREF="../../../javax/microedition/pim/PIMList.html#maxCategories()">maxCategories</A>, <A HREF="../../../javax/microedition/pim/PIMList.html#maxValues(int)">maxValues</A>, <A HREF="../../../javax/microedition/pim/PIMList.html#renameCategory(java.lang.String, java.lang.String)">renameCategory</A></CODE></TD>
</TR>
</TABLE>
&nbsp;
<P>

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


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


<!-- ============ 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="createContact()"><!-- --></A><H3>
createContact</H3>
<PRE>
public <A HREF="../../../javax/microedition/pim/Contact.html">Contact</A> <B>createContact</B>()</PRE>
<DL>
<DD>Factory method to create a Contact for this contact list.  The Contact
 is empty upon creation with none of its fields containing any data (i.e. a
 call to the method <code>Contact.getFields()</code> will return an array
 of zero length).  Even though it is initially empty, the Contact is
 <i>capable</i> of containing data for exactly those fields that this list
 supports.
 Note that creation of the Contact does not add the Contact to the list
 from which the item was created; a specific call to
 <code>PIMItem.commit()</code> must be made to commit the item and
 its data to the list.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>Returns:</B><DD>a new, empty Contact object associated with this list.  However,
           the Contact is still not persistent in the list until a call to
           <code>PIMItem.commit()</code> for the Contact is made.</DL>
</DD>
</DL>
<HR>

<A NAME="importContact(javax.microedition.pim.Contact)"><!-- --></A><H3>
importContact</H3>
<PRE>
public <A HREF="../../../javax/microedition/pim/Contact.html">Contact</A> <B>importContact</B>(<A HREF="../../../javax/microedition/pim/Contact.html">Contact</A>&nbsp;contact)</PRE>
<DL>
<DD>Imports the given Contact into this contact list by making a new Contact
 for the list and filling its information with as much information as it
 can from the provided Contact.  If the input Contact is already in the
 list, a new Contact is still created with information similar to the input
 item (but not necessarily identical). </P>
 <P>Note that not all data from the input Contact may be supported in the
 new Contact due to field restrictions for the list instance.  In this
 case, data fields not supported are not transferred to the new Contact
 object. </P>
 <P>Also note that creation of the Contact does not add the Contact
 to this list; a specific call to <code>PIMItem.commit()</code> must be
 made to commit the item and its data to the list. </P>
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>contact</CODE> - the Contact to import into the list.
<DT><B>Returns:</B><DD>a newly created Contact.
<DT><B>Throws:</B>
<DD><CODE>java.lang.NullPointerException</CODE> - If <code>contact</code> is
           <code>null</code>.</DL>
</DD>
</DL>
<HR>

<A NAME="removeContact(javax.microedition.pim.Contact)"><!-- --></A><H3>
removeContact</H3>
<PRE>
public void <B>removeContact</B>(<A HREF="../../../javax/microedition/pim/Contact.html">Contact</A>&nbsp;contact)
                   throws <A HREF="../../../javax/microedition/pim/PIMException.html">PIMException</A></PRE>
<DL>
<DD>Removes a specific Contact from the list.  The item must already
 exist in the list for this method to succeed.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>contact</CODE> - the Contact to be removed from the list.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/microedition/pim/PIMException.html">PIMException</A></CODE> - If an error occurs deleting the item
           or the list is no longer accessible or closed.
<DD><CODE>java.lang.NullPointerException</CODE> - If <code>contact</code> is
           <code>null</code>.
<DD><CODE>java.lang.SecurityException</CODE> - if the application is not given
           permission to write to the Contact list or the list is opened
           READ_ONLY.</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=3 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="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>
Proposed Final Draft<br>Rev. 0.24</EM>
</TD>
</TR>

<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
&nbsp;<A HREF="../../../javax/microedition/pim/Contact.html"><B>PREV CLASS</B></A>&nbsp;
&nbsp;<A HREF="../../../javax/microedition/pim/Event.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="ContactList.html" TARGET="_top"><B>NO FRAMES</B></A>  &nbsp;
&nbsp;
<SCRIPT>
  <!--
  if(window==top) {
    document.writeln('<A HREF="../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>');
  }
  //-->
</SCRIPT>
<NOSCRIPT>
<A HREF="../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>
</NOSCRIPT>
</FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  SUMMARY:&nbsp;NESTED&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>Copyright &copy; 2002-2003 PalmSource, Inc.  All Rights Reserved.<br>Java is a trademark of Sun Microsystems, Inc.</font>
</BODY>
</HTML>