public final class CalendarContract
extends Object
java.lang.Object | |
↳ | android.provider.CalendarContract |
日历提供程序与应用程序之间的合同。 包含支持的URI和数据列的定义。
CalendarContract定义日历和事件相关信息的数据模型。 这些数据存储在多个表中:
CalendarContract.Calendars
table holds the calendar specific information. Each row in this table contains the details for a single calendar, such as the name, color, sync info, etc.CalendarContract.Events
table holds the event specific information. Each row in this table has the info for a single event. It contains information such as event title, location, start time, end time, etc. The event can occur one-time or can recur multiple times. Attendees, reminders, and extended properties are stored on separate tables and reference the _ID
to link them with the event.CalendarContract.Instances
table holds the start and end time for occurrences of an event. Each row in this table represents a single occurrence. For one-time events there will be a 1:1 mapping of instances to events. For recurring events, multiple rows will automatically be generated which correspond to multiple occurrences of that event.CalendarContract.Attendees
table holds the event attendee or guest information. Each row represents a single guest of an event. It specifies the type of guest they are and their attendance response for the event.CalendarContract.Reminders
table holds the alert/notification data. Each row represents a single alert for an event. An event can have multiple reminders. The number of reminders per event is specified in MAX_REMINDERS
which is set by the Sync Adapter that owns the given calendar. Reminders are specified in minutes before the event and have a type.CalendarContract.ExtendedProperties
table holds opaque data fields used by the sync adapter. The provider takes no action with items in this table except to delete them when their related events are deleted.其他表格包括:
CalendarContract.SyncState
, which contains free-form data maintained by the sync adaptersConstants |
|
---|---|
String |
ACCOUNT_TYPE_LOCAL 日历的特殊帐户类型,不与任何帐户关联。 |
String |
ACTION_EVENT_REMINDER 广播动作:这是当需要发布提醒通知时发出的意图。 |
String |
ACTION_HANDLE_CUSTOM_EVENT 活动操作:按照 |
String |
AUTHORITY 此权限用于写入日历提供程序或从日历提供程序查询。 |
String |
CALLER_IS_SYNCADAPTER 一个可选的插入,更新或删除URI参数,允许调用者指定它是一个同步适配器。 |
String |
EXTRA_CUSTOM_APP_URI 意图附加键: |
String |
EXTRA_EVENT_ALL_DAY 意图附加键:创建事件时,将其设置为true以默认创建全天事件 |
String |
EXTRA_EVENT_BEGIN_TIME 意图附加键:事件的开始时间或周期性事件的实例。 |
String |
EXTRA_EVENT_END_TIME 意图附加键:事件结束时间或重复事件的实例。 |
Fields |
|
---|---|
public static final Uri |
CONTENT_URI 顶级日历管理机构的内容://样式网址 |
Inherited methods |
|
---|---|
From class java.lang.Object
|
String ACCOUNT_TYPE_LOCAL
日历的特殊帐户类型,不与任何帐户关联。 通常,与设备上的帐户不匹配的日历将被删除。 将日历中的account_type设置为此将防止它与现有帐户不匹配时被擦除。
也可以看看:
常量值:“LOCAL”
String ACTION_EVENT_REMINDER
广播动作:这是当需要发布提醒通知时发出的意图。
常量值:“android.intent.action.EVENT_REMINDER”
String ACTION_HANDLE_CUSTOM_EVENT
活动操作:按照CUSTOM_APP_PACKAGE
指定将事件显示给自定义应用程序中的CUSTOM_APP_PACKAGE
。 自定义应用程序将通过启动startActivityForResult(Intent, int)
,它应该叫setResult(int)
与RESULT_OK
或者RESULT_CANCELED
确认操作是否处理或没有。 自定义应用应该具有如下的意图过滤器:
<intent-filter> <action android:name="android.provider.calendar.action.HANDLE_CUSTOM_EVENT" /> <category android:name="android.intent.category.DEFAULT" /> <data android:mimeType="vnd.android.cursor.item/event" /> </intent-filter>
输入: getData()
有事件URI。 额外的EXTRA_EVENT_BEGIN_TIME
具有实例的开始时间。 额外的EXTRA_CUSTOM_APP_URI
将有CUSTOM_APP_URI
。
输出: RESULT_OK
如果处理完成; 否则RESULT_CANCELED
。
常量值:“android.provider.calendar.action.HANDLE_CUSTOM_EVENT”
String AUTHORITY
此权限用于写入日历提供程序或从日历提供程序查询。 注意:这是在第一次运行时设置的,不能在不中断访问提供程序的应用程序的情况下进行更改。
常量值:“com.android.calendar”
String CALLER_IS_SYNCADAPTER
一个可选的插入,更新或删除URI参数,允许调用者指定它是一个同步适配器。 默认值是false。 如果设置为true,则修改的行未标记为“脏”(需要同步),并且当提供程序调用notifyChange(android.net.Uri, android.database.ContentObserver, boolean)
,第三个参数“syncToNetwork”设置为false。 此外,如果设置为true,则调用者还必须包含ACCOUNT_NAME
和ACCOUNT_TYPE
作为查询参数。
常量值:“caller_is_syncadapter”
String EXTRA_CUSTOM_APP_URI
意图附加键: CUSTOM_APP_URI
意图中的事件 ACTION_HANDLE_CUSTOM_EVENT
常量值:“customAppUri”
String EXTRA_EVENT_ALL_DAY
意图附加键:创建事件时,将其设置为true以默认创建全天事件
常数值:“allDay”
String EXTRA_EVENT_BEGIN_TIME
意图附加键:事件的开始时间或周期性事件的实例。 (自纪元以来的毫秒数)
常量值:“beginTime”
String EXTRA_EVENT_END_TIME
意图附加键:事件结束时间或重复事件的实例。 (自纪元以来的毫秒数)
常量值:“endTime”