日程表详细设计说明

一、    功能分解<?xml:namespace prefix = o ns = "urn:schemas-microsoft-com:office:office" />

1.         日程管理

1.1新建：

       功能详解：新建日程安排。日程安排项目包括：描述、地点、开始日期、开始时间、结束日期、结束时间、是否闹铃、闹铃提前时间、是否重复、重复类型、备注。

 

1.2查看：

       功能详解：查看某一日程安排，显示该日程详细信息，供用户查看。

 

1.3编辑：

       功能详解：编辑某一日程，改变原有日程信息，可供修改的项目包括：描述、地点、开始日期、开始时间、结束日期、结束时间、是否闹铃、闹铃提前时间、是否重复、重复类型、备注。

 

1.4删除：

       功能详解：删除某一日程，若是循环日程，则删除之；若该日程属于循环日程则让用户选择是删除全部循环实例还是仅删除当前日期的日程。删除之前提示用户确认，一旦删除不可恢复。

 

1.5浏览：

       功能详解：提供多种模式供用户快速浏览日程安排，主要的模式有：月视图、天视图、列表视图。

<?xml:namespace prefix = st1 ns = "urn:schemas-microsoft-com:office:smarttags" />1.5.1天视图：

       功能详解：按天组织日程显示，显示一天24小时的日程安排状况，包括的信息有：

Ø        该天日程安排的数量

Ø        每项日程安排的起止时间

Ø   
4000
     提供接口可以快速查看某一日程的详细信息

 

1.5.2月视图：

       功能详解：按月组织日程显示，显示一个月所有日期的日程安排情况。

 

1.5.3列表视图：

       功能详解：按照不同的设置条件，列表显示符合条件的日程，在此可以查看、编辑、删除某一具体日程。

Ø        按时间查询

²       当天

²       当月

²       今天以前

²       今题以后

²       自定义日期范围

Ø        按地点查询

Ø        按描述查询

Ø        查询重复日程

Ø        查询含闹钟日程

2.         历法显示

2.1公历显示

       功能详解：显示公历年、月、日、星期。显示范围：1970年1月1日——2036年12月31日。

2.2农历显示

              功能详解：显示农历的年、月、日、闰月、天干地支信息。

2.3节日节气显示

       功能详解：显示主要的公历、农历、中国传统二十四节气信息。

二、    实现设计

1.     日程管理

日程管理主要由enable库来做的，实现了日程的创建、保存、更新、查询、删除功能。主要有两大部分组成。

1.1    数据库相关部分

Ø        数据库连接句柄

Ø        连接数据库

Ø        断开数据库连接

Ø        向数据库中添加事件

Ø        更新数据库中的事件

Ø        按照查询条件查询数据库中的事件

1.2    事件相关部分

Ø        事件结构体的定义

Ø        创建一个事件

Ø        设置事件的各个域的值

Ø        取得各个事件域的值

       在日程管理中，除了enable库以外，还有一部分用于实现应用层和enable的沟通，主要包括了

Ø        enable库的初始化

Ø        enable库的链接销毁

Ø        接受应用层的请求，通过enable库向数据库中添加事件，更新事件信息、删除时间、按照查询条件查询事件。

Ø        天视图中日期和日程管理，维护天视图中的日期信息，日程信息。

Ø        月视图中的日期和日程管理，维护月视图中的日期信息，日程信息。

2.     时间管理

时间管理主要维护一个全局性的时间点，在各个视图之间共享，各个视图之间通过时间管理提供的接口来实现日期同步。包括的功能有：

Ø        设置当前时间

Ø        取得当期时间

Ø        各种和日期时间相关的计算  

      3. 农历显示

              这部分实现公历转农历。

Ø        给定公历日期转换为农历日期，得出日期的天干地支信息，闰月信息

Ø        给定公历日期，得出农历节日和公历节日

Ø        给定公历日期，得出二十四节气信息

4．界面管理

界面显示部分主要有天视图、月视图、列表视图、日程编辑、日程查看、不同视图之间的相互切换等几部分组成。

4.1天视图

Ø        当天的日期信息

Ø        随意切换到另外一天

Ø        当天24小时的日程安排状况

          4.2月视图

Ø        公历、农历的显示，公历节日节气、农历节日的显示

Ø        日程信息的显示

4.3列表视图

      按照不同的条件列表显示符合条件的事件。

Ø        按时间查询

²       当天日程

²       当月日程

²       今天以前的日程

²       今天以后的日程

²       自定义日期范围的日程

Ø        按地点查询，支持模糊查询

Ø        按主题查询，支持模糊查询

Ø        查询重复日程

Ø        查询包含闹钟的日程

Ø        显示全部日程

4.4.日程的编辑

       日程新建和日程更新都会用到日程编辑界面，日程编辑界面提供界面收集用户输入的日程信息，包括：

Ø        主题

Ø        地点

Ø        开始日期

Ø        开始时间

Ø        结束日期

Ø        结束时间

Ø        是否闹铃

Ø        闹铃提前时间

Ø        事件是否重复

Ø        事件重复类型

 4.5 日程的查看。

日程的查看界面，用于显示某个日程的详细信息，先取得该日程的信息，然后将信息显示用户。