CalendarContract.Events

public static final class CalendarContract.Events
extends Object implements BaseColumns, CalendarContract.SyncColumns, CalendarContract.EventsColumns, CalendarContract.CalendarColumns

Events表的常量和帮助器，其中包含各个事件的详细信息。

Operations

Insert

When inserting a new event the following fields must be included:

• dtstart
• dtend if the event is non-recurring
• duration if the event is recurring
• rrule or rdate if the event is recurring
• eventTimezone
• a calendar_id

There are also further requirements when inserting or updating an event. See the section on Writing to Events.

Update

To perform an update of an Event the _ID of the event should be provided either as an appended id to the Uri ( withAppendedId(Uri, long)) or as the first selection item--the selection should start with "_id=?" and the first selectionArg should be the _id of the event. Updates may also be done using a selection and no id. Updating an event must respect the same rules as inserting and is further restricted in the fields that can be written. See the section on Writing to Events.

Delete

Events can be deleted either by the _ID as an appended id on the Uri or using any standard selection. If an appended id is used a selection is not allowed. There are two versions of delete: as an app and as a sync adapter. An app delete will set the deleted column on an event and remove all instances of that event. A sync adapter delete will remove the event from the database and all associated data.

Query

Querying the Events table will get you all information about a set of events except their reminders, attendees, and extended properties. There will be one row returned for each event that matches the query selection, or at most a single row if the _ID is appended to the Uri. Recurring events will only return a single row regardless of the number of times that event repeats.

Writing to Events

• If allDay is set to 1 eventTimezone must be TIMEZONE_UTC and the time must correspond to a midnight boundary.
• Exceptions are not allowed to recur. If rrule or rdate is not empty, original_id and original_sync_id must be empty.
• In general a calendar_id should not be modified after insertion. This is not explicitly forbidden but many sync adapters will not behave in an expected way if the calendar_id is modified.

• CALENDAR_ID
• ORGANIZER
• TITLE
• EVENT_LOCATION
• DESCRIPTION
• EVENT_COLOR
• DTSTART
• DTEND
• EVENT_TIMEZONE
• EVENT_END_TIMEZONE
• DURATION
• ALL_DAY
• RRULE
• RDATE
• EXRULE
• EXDATE
• ORIGINAL_ID
• ORIGINAL_SYNC_ID
• ORIGINAL_INSTANCE_TIME
• ORIGINAL_ALL_DAY
• ACCESS_LEVEL
• AVAILABILITY
• GUESTS_CAN_MODIFY
• GUESTS_CAN_INVITE_OTHERS
• GUESTS_CAN_SEE_GUESTS
• CUSTOM_APP_PACKAGE
• CUSTOM_APP_URI
• UID_2445

• DIRTY
• MUTATORS
• _SYNC_ID
• SYNC_DATA1
• SYNC_DATA2
• SYNC_DATA3
• SYNC_DATA4
• SYNC_DATA5
• SYNC_DATA6
• SYNC_DATA7
• SYNC_DATA8
• SYNC_DATA9
• SYNC_DATA10

摘要(Summary)

Inherited constants
From interface android.provider.BaseColumns String _COUNT 目录中的行数。 String _ID 一行的唯一ID。
From interface android.provider.CalendarContract.SyncColumns String ACCOUNT_NAME 用于将条目同步到设备的帐户。 String ACCOUNT_TYPE 用于将条目同步到设备的帐户的类型。 String CAN_PARTIALLY_UPDATE 如果设置为1， LAST_SYNCED每当事件从非肮脏变为肮脏时，此日历上的事件将与 LAST_SYNCED重复设置为1。 String DELETED 该行是否已被删除但未同步到服务器。 String DIRTY 用于表明存在本地未确认的更改。 String MUTATORS 与 DIRTY一起使用以指示哪些程序包编写了本地更改。 String _SYNC_ID 由同步源分配的行的唯一ID。
From interface android.provider.CalendarContract.EventsColumns int ACCESS_CONFIDENTIAL 机密不被应用程序使用。 int ACCESS_DEFAULT 默认访问由服务器控制，并在设备上视为公共。 String ACCESS_LEVEL 定义日历共享时事件如何显示给其他人。 int ACCESS_PRIVATE 私人分享事件作为空闲/忙时隙，没有任何细节。 int ACCESS_PUBLIC 公开使任何有权访问日历的人都可以看到内容。 String ALL_DAY 整天是事件（时区独立）。 String AVAILABILITY 如果此事件计为忙碌时间或仍然可以安排空闲时间。 int AVAILABILITY_BUSY 表示此事件需要时间并与其他事件发生冲突。 int AVAILABILITY_FREE 表示此事件是空闲时间，不会与其他事件冲突。 int AVAILABILITY_TENTATIVE 表示所有者的可用性可能会发生变化，但应该被视为会发生冲突的繁忙时间。 String CALENDAR_ID 事件所属日历的 _ID 。 String CAN_INVITE_OTHERS 用户是否可以邀请其他人参加活动。 String CUSTOM_APP_PACKAGE 自定义应用的软件包名称，可以为活动提供更丰富的体验。 String CUSTOM_APP_URI 自定义应用程序用于事件的URI。 String DESCRIPTION 事件的描述。 String DISPLAY_COLOR 如果它不为空，它将是EVENT_COLOR ; 否则，这将是CALENDAR_COLOR 。 String DTEND 从时代开始，事件以UTC毫秒结束。 String DTSTART 从时代开始，事件以UTC毫秒开始。 String DURATION 事件的持续时间采用RFC2445格式。 String EVENT_COLOR 个别事件的次要颜色。 String EVENT_COLOR_KEY 个别事件的辅助颜色键。 String EVENT_END_TIMEZONE 事件结束时间的时区。 String EVENT_LOCATION 事件发生的地方。 String EVENT_TIMEZONE 活动的时区。 String EXDATE 该事件的重复例外日期。 String EXRULE 事件的重复例外规则。 String GUESTS_CAN_INVITE_OTHERS 无论客人是否能邀请其他客人。 String GUESTS_CAN_MODIFY 无论客人是否可以修改活动。 String GUESTS_CAN_SEE_GUESTS 无论客人是否可以看到与会者名单。 String HAS_ALARM 事件是否有报警。 String HAS_ATTENDEE_DATA 活动是否有参加者信息。 String HAS_EXTENDED_PROPERTIES 事件是否具有扩展属性。 String IS_ORGANIZER 我们是这次活动的组织者吗？ String LAST_DATE 该事件重复的最后日期，如果它永不结束，则返回NULL。 String LAST_SYNCED 用于指示行不是真实事件，而是本地修改事件的原始副本。 String ORGANIZER 活动组织者（所有者）的电子邮件。 String ORIGINAL_ALL_DAY 此事件为例外的原始重复事件的allDay状态（true或false）。 String ORIGINAL_ID 此事件发生异常的原始重复事件的 _ID 。 String ORIGINAL_INSTANCE_TIME 此事件发生异常的重复事件的原始实例时间。 String ORIGINAL_SYNC_ID 此事件发生异常的原始定期事件的_sync_id。 String RDATE 事件的重现日期。 String RRULE 事件的重复规则。 String SELF_ATTENDEE_STATUS 这是此活动所有者的与会者状态的副本。 String STATUS 活动状态。 int STATUS_CANCELED int STATUS_CONFIRMED int STATUS_TENTATIVE String SYNC_DATA1 此列可供同步适配器使用。 String SYNC_DATA10 此列可供同步适配器使用。 String SYNC_DATA2 此列可供同步适配器使用。 String SYNC_DATA3 此列可供同步适配器使用。 String SYNC_DATA4 此列可供同步适配器使用。 String SYNC_DATA5 此列可供同步适配器使用。 String SYNC_DATA6 此列可供同步适配器使用。 String SYNC_DATA7 此列可供同步适配器使用。 String SYNC_DATA8 此列可供同步适配器使用。 String SYNC_DATA9 此列可供同步适配器使用。 String TITLE 活动的标题。 String UID_2445 从RFC 2445 iCalendar格式添加的事件的UID。
From interface android.provider.CalendarContract.CalendarColumns String ALLOWED_ATTENDEE_TYPES 格式为“＃，＃，＃”格式的此日历支持的逗号分隔的与会者类型列表。 String ALLOWED_AVAILABILITY 以“＃，＃，＃”格式支持此日历的逗号分隔的可用性类型列表。 String ALLOWED_REMINDERS 格式为“＃，＃，＃”格式的此日历支持的提醒方法列表以逗号分隔。 String CALENDAR_ACCESS_LEVEL 用户对日历的访问级别 类型：INTEGER（下面的值之一） String CALENDAR_COLOR 日历的颜色。 String CALENDAR_COLOR_KEY 从 CalendarContract.Colors表中查找颜色的 CalendarContract.Colors 。 String CALENDAR_DISPLAY_NAME 日历的显示名称。 String CALENDAR_TIME_ZONE 日历所关联的时区。 int CAL_ACCESS_CONTRIBUTOR 完全访问修改日历，但不能访问控制设置 int CAL_ACCESS_EDITOR 完全访问修改日历，但不能访问控制设置 int CAL_ACCESS_FREEBUSY 只能查看有关日历的空闲/忙碌信息 int CAL_ACCESS_NONE 无法访问日历 int CAL_ACCESS_OVERRIDE 不曾用过 int CAL_ACCESS_OWNER 完全访问日历 int CAL_ACCESS_READ 可以阅读所有活动详情 int CAL_ACCESS_RESPOND 可以回复是/否/也许是一个事件 int CAL_ACCESS_ROOT 域管理员 String CAN_MODIFY_TIME_ZONE 组织者是否可以修改事件的时区？ 列名称。 String CAN_ORGANIZER_RESPOND 组织者可以对事件做出回应吗？ 如果否，组织者的状态不应该由UI显示。 String IS_PRIMARY 这是此帐户的主日历吗？ String MAX_REMINDERS 一个事件允许的最大提醒数量。 String OWNER_ACCOUNT 此日历的所有者帐户基于日历Feed。 String SYNC_EVENTS 这个日历是否同步并且是其设备上存储的事件？ 0 - 不要同步此日历或存储此日历的事件。 String VISIBLE 是否选择要显示的日历？ 0 - 不显示与此日历相关的事件。
From interface android.provider.CalendarContract.CalendarSyncColumns String CAL_SYNC1 同步适配器使用的通用列。 String CAL_SYNC10 同步适配器使用的通用列。 String CAL_SYNC2 同步适配器使用的通用列。 String CAL_SYNC3 同步适配器使用的通用列。 String CAL_SYNC4 同步适配器使用的通用列。 String CAL_SYNC5 同步适配器使用的通用列。 String CAL_SYNC6 同步适配器使用的通用列。 String CAL_SYNC7 同步适配器使用的通用列。 String CAL_SYNC8 同步适配器使用的通用列。 String CAL_SYNC9 同步适配器使用的通用列。

继承方法(Inherited methods)

From class java.lang.Object Object clone() 创建并返回此对象的副本。 boolean equals(Object obj) 指示其他某个对象是否“等于”这一个。 void finalize() 当垃圾收集确定没有更多对该对象的引用时，由对象上的垃圾回收器调用。 final Class<?> getClass() 返回此 Object的运行时类。 int hashCode() 返回对象的哈希码值。 final void notify() 唤醒正在等待该对象监视器的单个线程。 final void notifyAll() 唤醒在该对象监视器上等待的所有线程。 String toString() 返回对象的字符串表示形式。 final void wait(long millis, int nanos) 导致当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法，或者某个其他线程中断当前线程，或经过一定的实时时间。 final void wait(long millis) 导致当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法或经过了指定的时间量。 final void wait() 导致当前线程等待，直到另一个线程调用此对象的方法 notify()或方法 notifyAll() 。

Fields

Uri CONTENT_EXCEPTION_URI

Uri CONTENT_URI