CalendarContract.Calendars

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

日历表的常量和助手，其中包含各个日历的详细信息。

Operations

Insert

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

• ACCOUNT_NAME
• ACCOUNT_TYPE
• NAME
• CALENDAR_DISPLAY_NAME
• CALENDAR_COLOR
• CALENDAR_ACCESS_LEVEL
• OWNER_ACCOUNT

The following fields are not required when inserting a Calendar but are generally a good idea to include:

• SYNC_EVENTS set to 1
• CALENDAR_TIME_ZONE
• ALLOWED_REMINDERS
• ALLOWED_AVAILABILITY
• ALLOWED_ATTENDEE_TYPES

Update

To perform an update on a calendar the _ID of the calendar 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 calendar. Calendars may also be updated using a selection without the id. In general, the ACCOUNT_NAME and ACCOUNT_TYPE should not be changed after a calendar is created as this can cause issues for sync adapters.

Delete

Calendars can be deleted either by the _ID as an appended id on the Uri or using any standard selection. Deleting a calendar should generally be handled by a sync adapter as it will remove the calendar from the database and all associated data (aka events).

Query

Querying the Calendars table will get you all information about a set of calendars. There will be one row returned for each calendar that matches the query selection, or at most a single row if the _ID is appended to the Uri.

Calendar Columns

• NAME
• CALENDAR_DISPLAY_NAME
• VISIBLE
• SYNC_EVENTS

• ACCOUNT_NAME
• ACCOUNT_TYPE
• CALENDAR_COLOR
• _SYNC_ID
• DIRTY
• MUTATORS
• OWNER_ACCOUNT
• MAX_REMINDERS
• ALLOWED_REMINDERS
• ALLOWED_AVAILABILITY
• ALLOWED_ATTENDEE_TYPES
• CAN_MODIFY_TIME_ZONE
• CAN_ORGANIZER_RESPOND
• CAN_PARTIALLY_UPDATE
• CALENDAR_LOCATION
• CALENDAR_TIME_ZONE
• CALENDAR_ACCESS_LEVEL
• DELETED
• CAL_SYNC1
• CAL_SYNC2
• CAL_SYNC3
• CAL_SYNC4
• CAL_SYNC5
• CAL_SYNC6
• CAL_SYNC7
• CAL_SYNC8
• CAL_SYNC9
• CAL_SYNC10

摘要(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重复设置为1，只要事件从非脏变为肮脏即可。 String DELETED 该行是否已被删除但未同步到服务器。 String DIRTY 用于表明存在本地未确认的更改。 String MUTATORS 与 DIRTY一起用于指示哪些软件包写入了本地更改。 String _SYNC_ID 由同步源分配的行的唯一ID。
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()方法。

常量(Constants)

String CALENDAR_LOCATION

String DEFAULT_SORT_ORDER

String NAME

Fields

Uri CONTENT_URI