contact.html

J2ME PDA开发PIM的技术规范,可使应用程序查看手机本地联系人列表, 本地文件

			<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></DD></DL>
				</DD>
			</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></DD></DL>
				</DD>
			</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></DD></DL>
				</DD>
			</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>
						<DL>
							<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.microedition.pim.Contact.ADDR_STREET">Constant 
										Field Values</A></DD></DL>
				</DD>
			</DL>
			<HR>
			<A NAME="ADDR_LOCALITY"><!-- --></A><H3>
				ADDR_LOCALITY</H3>
			<PRE>
public static final int <B>ADDR_LOCALITY</B></PRE>
			<DL>
				<DD>
					Index into the string array for an address field, where the data at this index 
					represents the locality (for example, a city) 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_LOCALITY">Constant 
										Field Values</A></DD></DL>
				</DD>
			</DL>
			<HR>
			<A NAME="ADDR_REGION"><!-- --></A><H3>
				ADDR_REGION</H3>
			<PRE>
public static final int <B>ADDR_REGION</B></PRE>
			<DL>
				<DD>
					Index into the string array for an address field, where the data at this index 
					represents the region (for example, a province, state, or territory) 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_REGION">Constant 
										Field Values</A></DD></DL>
				</DD>
			</DL>
			<HR>
			<A NAME="ADDR_POSTALCODE"><!-- --></A><H3>
				ADDR_POSTALCODE</H3>
			<PRE>
public static final int <B>ADDR_POSTALCODE</B></PRE>
			<DL>
				<DD>
					Index into the string array for an address field, where the data at this index 
					represents the postal code (for example, a zip code) 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_POSTALCODE">Constant 
										Field Values</A></DD></DL>
				</DD>
			</DL>
			<HR>
			<A NAME="ADDR_COUNTRY"><!-- --></A><H3>
				ADDR_COUNTRY</H3>
			<PRE>
public static final int <B>ADDR_COUNTRY</B></PRE>
			<DL>
				<DD>
					Index into the string array for an address field, where the data at this index 
					represents the country 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_COUNTRY">Constant 
										Field Values</A></DD></DL>
				</DD>
			</DL>
			<HR>
			<A NAME="NAME_FAMILY"><!-- --></A><H3>
				NAME_FAMILY</H3>
			<PRE>
public static final int <B>NAME_FAMILY</B></PRE>
			<DL>
				<DD>
					Index into the string array for a name field, where the data at this index 
					represents the family name. For example:
					<BR>
					"Stevenson"
					<P>
						<DL>
							<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.microedition.pim.Contact.NAME_FAMILY">Constant 
										Field Values</A></DD></DL>
				</DD>
			</DL>
			<HR>
			<A NAME="NAME_GIVEN"><!-- --></A><H3>
				NAME_GIVEN</H3>
			<PRE>
public static final int <B>NAME_GIVEN</B></PRE>
			<DL>
				<DD>
					Index into the string array for a name field, where the data at this index 
					represents the given name. For example:
					<BR>
					"Johnathan"
					<P>
						<DL>
							<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.microedition.pim.Contact.NAME_GIVEN">Constant 
										Field Values</A></DD></DL>
				</DD>
			</DL>
			<HR>
			<A NAME="NAME_OTHER"><!-- --></A><H3>
				NAME_OTHER</H3>
			<PRE>
public static final int <B>NAME_OTHER</B></PRE>
			<DL>
				<DD>
					Index into the string array for a name field, where the data at this index 
					represents other alternate name or names. For example:
					<BR>
					"John, Johnny"
					<P>
						<DL>
							<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.microedition.pim.Contact.NAME_OTHER">Constant 
										Field Values</A></DD></DL>
				</DD>
			</DL>
			<HR>
			<A NAME="NAME_PREFIX"><!-- --></A><H3>
				NAME_PREFIX</H3>
			<PRE>
public static final int <B>NAME_PREFIX</B></PRE>
			<DL>
				<DD>
					Index into the string array for a name field, where the data at this index 
					represents a prefix to a name. For example:
					<BR>
					"Dr."
					<P>
						<DL>
							<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.microedition.pim.Contact.NAME_PREFIX">Constant 
										Field Values</A></DD></DL>
				</DD>
			</DL>
			<HR>
			<A NAME="NAME_SUFFIX"><!-- --></A><H3>
				NAME_SUFFIX</H3>
			<PRE>
public static final int <B>NAME_SUFFIX</B></PRE>
			<DL>
				<DD>
					Index into the string array for a name field, where the data at this index 
					represents a suffix to a name. For example:
					<BR>
					"M.D., A.C.P."
					<P>
						<DL>
							<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.microedition.pim.Contact.NAME_SUFFIX">Constant 
										Field Values</A></DD></DL>
				</DD>
			</DL>
			<HR>
			<A NAME="CLASS_CONFIDENTIAL"><!-- --></A><H3>
				CLASS_CONFIDENTIAL</H3>
			<PRE>
public static final int <B>CLASS_CONFIDENTIAL</B></PRE>
			<DL>
				<DD>
					Constant indicating this contact's class of access is confidential.
					<P>
						<DL>
							<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.microedition.pim.Contact.CLASS_CONFIDENTIAL">Constant 
										Field Values</A></DD></DL>
				</DD>
			</DL>
			<HR>
			<A NAME="CLASS_PRIVATE"><!-- --></A><H3>
				CLASS_PRIVATE</H3>
			<PRE>
public static final int <B>CLASS_PRIVATE</B></PRE>
			<DL>
				<DD>
					Constant indicating this contact's class of access is private.
					<P>
						<DL>
							<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.microedition.pim.Contact.CLASS_PRIVATE">Constant 
										Field Values</A></DD></DL>
				</DD>
			</DL>
			<HR>
			<A NAME="CLASS_PUBLIC"><!-- --></A><H3>
				CLASS_PUBLIC</H3>
			<PRE>
public static final int <B>CLASS_PUBLIC</B></PRE>
			<DL>
				<DD>
					Constant indicating this contact's class of access is public.
					<P>
						<DL>
							<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.microedition.pim.Contact.CLASS_PUBLIC">Constant 
										Field Values</A></DD></DL>
				</DD>
			</DL>
			<!-- ========= 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="getPreferredIndex(int)"><!-- --></A><H3>
				getPreferredIndex</H3>
			<PRE>
public int <B>getPreferredIndex</B>(int&nbsp;field)</PRE>
			<DL>
				<DD>
					Returns the index of the value marked with the attribute ATTR_PREFERRED for the 
					given field. Only one value per field may be marked as preferred. <A HREF="../../../javax/microedition/pim/PIMList.html#isSupportedField(int)">
						<CODE>PIMList.isSupportedField(int)</CODE></A> should be used to verify the 
					field validity for this item prior to invoking this method. <A HREF="../../../javax/microedition/pim/PIMList.html#isSupportedAttribute(int, int)">
						<CODE>PIMList.isSupportedAttribute(int, int)</CODE></A> should be used to 
					verify the attribute validity for this item prior to invoking this method.
					<P></P>
					<DD>
						<DL>
						</DL>
						<DD>
							<DL>
								<DT><B>Parameters:</B><DD><CODE>field</CODE> - the field to look for a preferred value <DT><B>Returns:</B><DD>an 
												integer representing the index of the value that is marked as preferred. -1 is 
												returned if no values within the field are marked as preferred. <DT><B>Throws:</B>
													<DD>
														<CODE>java.lang.IllegalArgumentException</CODE> - if field is not a valid field 
														for a Contact.
														<DD>
															<CODE><A HREF="../../../javax/microedition/pim/UnsupportedFieldException.html">UnsupportedFieldException</A></CODE>
															- if the field is not supported by the impl