📄 eventlist.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN""http://www.w3.org/TR/REC-html40/loose.dtd">
<!--NewPage-->
<HTML>
<HEAD>
<TITLE>EventList (PIM Optional Package 1.0 Spec, Final Release) </TITLE>
<!-- Generated by javadoc on Wed Oct 29 13:13:40 PST 2003 -->
<META NAME="keywords" CONTENT="javax.microedition.pim.EventList,EventList interface">
<LINK REL="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style">
<SCRIPT>
function asd()
{
parent.document.title="EventList (PIM Optional Package 1.0 Spec, Final Release)";
}
</SCRIPT>
</HEAD>
<BODY BGCOLOR="white" onload="asd();">
<!-- ========== START OF NAVBAR ========== -->
<A NAME="navbar_top"><!-- --></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
<TR>
<TD COLSPAN="3" BGCOLOR="#eeeeff" CLASS="NavBarCell1">
<A NAME="navbar_top_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> </TD>
<TD BGCOLOR="#eeeeff" CLASS="NavBarCell1">
<A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
<TD BGCOLOR="#ffffff" CLASS="NavBarCell1Rev">
<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
<TD BGCOLOR="#eeeeff" CLASS="NavBarCell1">
<A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
<TD BGCOLOR="#eeeeff" CLASS="NavBarCell1">
<A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
<TD BGCOLOR="#eeeeff" CLASS="NavBarCell1">
<A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
<TD BGCOLOR="#eeeeff" CLASS="NavBarCell1">
<A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
</TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN="3"><EM> PIM Optional Package 1.0<br>
Final Release</EM>
</TD>
</TR>
<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="../../../javax/microedition/pim/Event.html"><B>PREV
CLASS</B></A> <A HREF="../../../javax/microedition/pim/PIMItem.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> <A HREF="EventList.html" TARGET="_top"><B>NO FRAMES</B></A>
<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: NESTED | <A HREF="#field_summary">FIELD</A> | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> DETAIL: <A HREF="#field_detail">FIELD</A> | CONSTR | <A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<!-- =========== END OF NAVBAR =========== -->
<HR>
<!-- ======== START OF CLASS DATA ======== -->
<H2>
<FONT SIZE="-1">javax.microedition.pim</FONT>
<BR>
Interface EventList</H2>
<DL>
<DT><B>All Superinterfaces:</B>
<DD>
<A HREF="../../../javax/microedition/pim/PIMList.html">PIMList</A></DD>
</DL>
<HR>
<DL>
<DT>public interface <B>EventList</B><DT>extends <A HREF="../../../javax/microedition/pim/PIMList.html">
PIMList</A></DT></DL>
<P>
Represents an Event list containing Event items.
<P>
An Event List is responsible for determining which of the fields from an Event
are retained when an Event is persisted into the List. An Event List does not
have to retain all of the fields in an Event when the Event is persisted into
the List. See the Event interface for a description of the fields available for
a specific Event. The fields that are supported by a particular Event List can
be queried through the method <A HREF="../../../javax/microedition/pim/PIMList.html#isSupportedField(int)">
<CODE>PIMList.isSupportedField(int)</CODE></A>. If a field ID that is not
in the Event interface is provided as the parameter to the <A HREF="../../../javax/microedition/pim/PIMList.html#isSupportedField(int)">
<CODE>PIMList.isSupportedField(int)</CODE></A> method, a <code>java.lang.IllegalArgumentException</code>
is thrown.
</P>
<h3>Inherited Method Behavior</h3>
<P>
An EventList only accepts objects implementing the Event interface as a
parameter to <A HREF="../../../javax/microedition/pim/PIMList.html#items(javax.microedition.pim.PIMItem)">
<CODE>PIMList.items(PIMItem)</CODE></A>). A <code>java.lang.IllegalArgumentException</code>
is thrown by this method if the input parameter does not implement the Event
interface.
</P>
<P>
Enumerations returned by <A HREF="../../../javax/microedition/pim/PIMList.html#items()">
<CODE>PIMList.items()</CODE></A>, <A HREF="../../../javax/microedition/pim/PIMList.html#items(javax.microedition.pim.PIMItem)">
<CODE>PIMList.items(PIMItem)</CODE></A>, and <A HREF="../../../javax/microedition/pim/EventList.html#items(int, long, long, boolean)">
<CODE>items(int, long, long, boolean)</CODE></A> contain only objects
implementing an Event interface.</P>
<P>
<P>
<DL>
<DT><B>Since:</B>
<DD>
PIM 1.0 <DT><B>See Also:</B><DD><A HREF="../../../javax/microedition/pim/Event.html"><CODE>Event</CODE></A></DD></DL>
<HR>
<P>
<!-- ======== NESTED CLASS SUMMARY ======== -->
<!-- =========== FIELD SUMMARY =========== -->
<A NAME="field_summary"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#ccccff" CLASS="TableHeadingColor">
<TD COLSPAN="2"><FONT SIZE="+2"> <B>Field Summary</B></FONT></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE>static int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/microedition/pim/EventList.html#ENDING">ENDING</A></B></CODE>
<BR>
Constant
representing a search type for Events based on the event occurrence's specific
end date/time.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE>static int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/microedition/pim/EventList.html#OCCURRING">OCCURRING</A></B></CODE>
<BR>
Constant
representing a search type for Events based on any occurrence of an event
during a time period.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE>static int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/microedition/pim/EventList.html#STARTING">STARTING</A></B></CODE>
<BR>
Constant
representing a search type for Events based on the event occurrence's specific
start date/time.</TD>
</TR>
</TABLE>
<A NAME="fields_inherited_from_class_javax.microedition.pim.PIMList"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#eeeeff" CLASS="TableSubHeadingColor">
<TD><B>Fields 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#UNCATEGORIZED">UNCATEGORIZED</A></CODE></TD>
</TR>
</TABLE>
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
<!-- ========== METHOD SUMMARY =========== -->
<A NAME="method_summary"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#ccccff" CLASS="TableHeadingColor">
<TD COLSPAN="2"><FONT SIZE="+2"> <B>Method Summary</B></FONT></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="../../../javax/microedition/pim/Event.html">Event</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/microedition/pim/EventList.html#createEvent()">createEvent</A></B>()</CODE>
<BR>
Factory method to
create an Event for this event list.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> int[]</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/microedition/pim/EventList.html#getSupportedRepeatRuleFields(int)">getSupportedRepeatRuleFields</A></B>(int frequency)</CODE>
<BR>
Returns the Repeat
Rule fields that are settable by the class user and supported by this EventList
for the provided Repeat Rule frequency.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="../../../javax/microedition/pim/Event.html">Event</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/microedition/pim/EventList.html#importEvent(javax.microedition.pim.Event)">importEvent</A></B>(<A HREF="../../../javax/microedition/pim/Event.html">Event</A> item)</CODE>
<BR>
Imports the given
Event into this list by making a new Event for the list and filling its
information with as much information as it can from the provided Event.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> java.util.Enumeration</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/microedition/pim/EventList.html#items(int, long, long, boolean)">items</A></B>(int searchType,
long startDate, long endDate, boolean initialEventOnly)</CODE>
<BR>
Return an
enumeration of all the Events where at least one of the Event's occurrences
falls in the specified range from startDate to endDate inclusive.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/microedition/pim/EventList.html#removeEvent(javax.microedition.pim.Event)">removeEvent</A></B>(<A HREF="../../../javax/microedition/pim/Event.html">Event</A> item)</CODE>
<BR>
Removes a specific
Event from the list.</TD>
</TR>
</TABLE>
<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>, <A HREF="../../../javax/microedition/pim/PIMList.html#stringArraySize(int)">
stringArraySize</A></CODE></TD>
</TR>
</TABLE>
<P>
<!-- ============ FIELD DETAIL =========== -->
<A NAME="field_detail"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#ccccff" CLASS="TableHeadingColor">
<TD COLSPAN="1"><FONT SIZE="+2"> <B>Field Detail</B></FONT></TD>
</TR>
</TABLE>
<A NAME="STARTING"><!-- --></A><H3>
STARTING</H3>
<PRE>
public static final int <B>STARTING</B></PRE>
<DL>
<DD>
Constant representing a search type for Events based on the event occurrence's
specific start date/time.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.microedition.pim.EventList.STARTING">Constant
Field Values</A></DD></DL>
</DD>
</DL>
<HR>
<A NAME="ENDING"><!-- --></A><H3>
ENDING</H3>
<PRE>
public static final int <B>ENDING</B></PRE>
<DL>
<DD>
Constant representing a search type for Events based on the event occurrence's
specific end date/time.
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -