contact.html

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

<DL>
<DD>Field specifying a photo of a Contact.  Data associated
 with this field is of String type, representing a URL for the photo.
 Manipulation of this field may affect data stored in the
 <code>PHOTO</code> field since some implementation may use the same
 memory for both fields (e.g. one can either have PHOTO or have PHOTO_URL
 but not both).
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../javax/microedition/pim/PIMList.html#isSupportedField(int)"><CODE>PIMList.isSupportedField(int)</CODE></A>, 
<A HREF="../../../constant-values.html#javax.microedition.pim.Contact.PHOTO_URL">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="PUBLIC_KEY"><!-- --></A><H3>
PUBLIC_KEY</H3>
<PRE>
public static final int <B>PUBLIC_KEY</B></PRE>
<DL>
<DD>Field specifying the public encryption key for a Contact.
 Data associated with this field is inline binary encoded data.
 Manipulation of this field may affect data stored in the
 <code>PUBLIC_KEY_STRING</code> field since some implementation may use
 the same memory for both fields (e.g. one can either have PUBLIC_KEY or
 have PUBLIC_KEY_STRING but not both).
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.microedition.pim.Contact.PUBLIC_KEY">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="PUBLIC_KEY_STRING"><!-- --></A><H3>
PUBLIC_KEY_STRING</H3>
<PRE>
public static final int <B>PUBLIC_KEY_STRING</B></PRE>
<DL>
<DD>Field specifying the public encryption key for a Contact.
 Data associated with this field is of String type.
 Manipulation of this field may affect data stored in the
 <code>PUBLIC_KEY</code> field since some implementation may use the same
 memory for both fields (e.g. one can either have PUBLIC_KEY or have
 PUBLIC_KEY_STRING but not both).
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.microedition.pim.Contact.PUBLIC_KEY_STRING">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="REVISION"><!-- --></A><H3>
REVISION</H3>
<PRE>
public static final int <B>REVISION</B></PRE>
<DL>
<DD>Field specifying the last modification date and time of a Contact
 item.  If the Contact has ever been committed to a ContactList, then
 this attribute becomes read only.  This field is set automatically on
 imports and commits of a Contact.  Data for this field is expressed
 in the same long value format as java.util.Date, which is
 milliseconds since the epoch (00:00:00 GMT, January 1, 1970).
 </P><P>
 Note that the value provided may be rounded-down by an implementation due
 to platform restrictions.  For example, should a native Contact database
 only support contact date values with granularity in terms of seconds,
 then the provided date value will be rounded down to a date time with a
 full second.
 </p>
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.microedition.pim.Contact.REVISION">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="TEL"><!-- --></A><H3>
TEL</H3>
<PRE>
public static final int <B>TEL</B></PRE>
<DL>
<DD>Field for a voice telephone number. Data associated with this field is
 of String type and can be any valid String.  No telephone formatting
 is enforced since many native implementations allow free form text to
 be associated with TEL fields.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.microedition.pim.Contact.TEL">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="TITLE"><!-- --></A><H3>
TITLE</H3>
<PRE>
public static final int <B>TITLE</B></PRE>
<DL>
<DD>Field specifying the job title for a Contact.  Data for this field is of
 String type. This title is based on the X.520 Title attributes.
 For example: <BR>
 "Director, Research and Development"
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.microedition.pim.Contact.TITLE">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="UID"><!-- --></A><H3>
UID</H3>
<PRE>
public static final int <B>UID</B></PRE>
<DL>
<DD>Field specifying a unique ID for a Contact.  This field can be
 used to check for identity using <code>String.equals</code>.  UID is
 read only if the Contact has been committed to a ContactList at least
 once in its lifetime. The UID does not contain a valid value if the
 Contact has never been committed to a ContactList;
 <CODE>getString(UID)</CODE> returns <code>null</code> before a newly
 created Contact object is committed to its list.  The attribute is valid
 for the persistent life of the Contact and may be reused by the platform
 once this particular Contact is deleted. Data for this field is of
 String data type.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.microedition.pim.Contact.UID">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="URL"><!-- --></A><H3>
URL</H3>
<PRE>
public static final int <B>URL</B></PRE>
<DL>
<DD>Field specifying the uniform resource locator for a Contact. Data for
 this field is of String data type.
 For example: <BR>
 "http://www.swbyps.restaurant.french/~chezchic.html"
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.microedition.pim.Contact.URL">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="ATTR_ASST"><!-- --></A><H3>
ATTR_ASST</H3>
<PRE>
public static final int <B>ATTR_ASST</B></PRE>
<DL>
<DD>Attribute classifying a data value as related to an ASSISTANT.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.microedition.pim.Contact.ATTR_ASST">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="ATTR_AUTO"><!-- --></A><H3>
ATTR_AUTO</H3>
<PRE>
public static final int <B>ATTR_AUTO</B></PRE>
<DL>
<DD>Attribute classifying a data value as related to AUTO.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.microedition.pim.Contact.ATTR_AUTO">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="ATTR_FAX"><!-- --></A><H3>
ATTR_FAX</H3>
<PRE>
public static final int <B>ATTR_FAX</B></PRE>
<DL>
<DD>Attribute classifying a data value as related to FAX.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.microedition.pim.Contact.ATTR_FAX">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="ATTR_HOME"><!-- --></A><H3>
ATTR_HOME</H3>
<PRE>
public static final int <B>ATTR_HOME</B></PRE>
<DL>
<DD>Attribute classifying a data value as related to HOME.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.microedition.pim.Contact.ATTR_HOME">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="ATTR_MOBILE"><!-- --></A><H3>
ATTR_MOBILE</H3>
<PRE>
public static final int <B>ATTR_MOBILE</B></PRE>
<DL>
<DD>Attribute classifying a data value as related to MOBILE.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.microedition.pim.Contact.ATTR_MOBILE">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="ATTR_OTHER"><!-- --></A><H3>
ATTR_OTHER</H3>
<PRE>
public static final int <B>ATTR_OTHER</B></PRE>
<DL>
<DD>Attribute classifying a data value as "OTHER".
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.microedition.pim.Contact.ATTR_OTHER">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="ATTR_PAGER"><!-- --></A><H3>
ATTR_PAGER</H3>
<PRE>
public static final int <B>ATTR_PAGER</B></PRE>
<DL>
<DD>Attribute classifying a data value as related to PAGER.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.microedition.pim.Contact.ATTR_PAGER">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="ATTR_PREFERRED"><!-- --></A><H3>
ATTR_PREFERRED</H3>
<PRE>
public static final int <B>ATTR_PREFERRED</B></PRE>
<DL>
<DD>Attribute classifying a data value with preferred status for
 retrieval or display purposes (platform specific).  Only one value in
 a field may be marked as preferred.  Subsequent assigning of preferred
 status to values in a field will override any previous preferred status
 indications.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.microedition.pim.Contact.ATTR_PREFERRED">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="ATTR_SMS"><!-- --></A><H3>
ATTR_SMS</H3>
<PRE>
public static final int <B>ATTR_SMS</B></PRE>
<DL>
<DD>Attribute classifying a data value as related to SMS.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.microedition.pim.Contact.ATTR_SMS">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="ATTR_WORK"><!-- --></A><H3>
ATTR_WORK</H3>
<PRE>
public static final int <B>ATTR_WORK</B></PRE>
<DL>
<DD>Attribute classifying a data value as related to WORK.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.microedition.pim.Contact.ATTR_WORK">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="ADDR_POBOX"><!-- --></A><H3>
ADDR_POBOX</H3>
<PRE>
public static final int <B>ADDR_POBOX</B></PRE>
<DL>
<DD>Index into the string array for an address field, where the data at
 this index represents the post office box of a particular address. Data
 for this field is of String type.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.microedition.pim.Contact.ADDR_POBOX">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="ADDR_EXTRA"><!-- --></A><H3>
ADDR_EXTRA</H3>
<PRE>
public static final int <B>ADDR_EXTRA</B></PRE>
<DL>
<DD>Index into the string array for an address field, where the data at
 this index represents any extra info of a particular address.  Data for
 this field is of String type.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.microedition.pim.Contact.ADDR_EXTRA">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="ADDR_STREET"><!-- --></A><H3>
ADDR_STREET</H3>
<PRE>
public static final int <B>ADDR_STREET</B></PRE>
<DL>
<DD>Index into the string array for an address field, where the data at
 this index represents the street information of a particular address.
 Data for this field is of String type.
<P>