dhtmlx中文使用手册API指南.doc

DHTMLX 使用手冊版本 (Version)：2.0.01前言(Introduction)111.1目的(Purpose)111.2范围(Scope)111.3名词定义 (Definition)111.4参考文件(References)122 dhtmlxCalendar 指南与程序代码范例122.1 什么是 dhtmlxCalendar122.1.1 主要特点132.1.2 支持的浏览器132.2 初始化 dhtmlxCalendar132.2.1最小初始化132.2.2延展型初始化142.2.3日历连结输入栏152.2.4双日历152.3dhtmlxCalendar 设定162.3.1设定 Skin162.3.2日期格式182.3.3设定/ 取得日期192.3.4设定日期范围202.3.5设定年度范围212.3.6使日历多语系化212.3.7改变周启始日222.3.8隐藏/ 显示日历232.3.9假日设定232.3.10设定无效日期242.3.11对 Calendar 设定新容器242.3.12设定 Calendar 的位置242.4事件处理252.4.1外挂事件处理例程252.4.2onClick 事件262.4.3onChangeMonth 事件263 dhtmlxCombo 指南与程序代码范例273.1什么是 dhtmlxCombo273.1.1主要功能273.1.2支持的浏览器273.2使用 dhtmlxCombo273.2.1初始化对象273.2.2加入选项283.2.3与 FORM 标签结合293.2.4过滤303.2.5combobox 的操作303.2.6comobobox 选项数据的操作313.2.7群组扩充314dhtmlxEditor 指南与程序代码范例324.1什么是 dhtmlxEditor324.1.1主要功能324.1.2支持的浏览器324.2使用接口324.2.1工具列334.2.2编辑区334.3dhtmlxEditor 的运作334.3.1文字格式334.4初始化 dhtmlxEditor344.5可用 Skins354.6API 函式355dhtmlxLayout指南与程序代码范例365.1什么是 dhtmlxLayout365.1.1主要功能365.1.2支持浏览器375.2dhtmlxLayout 初始化375.2.1对象型初始化385.2.2窗口型初始化395.2.3全屏幕的初始化395.2.4版格型初始化395.3全域性项目405.3.1增加选单405.3.2增加工具列415.3.3增加状幠列415.4dhtmlxLayout 组幠425.4.1可使用的 Skin425.4.2设定样式435.4.3自动尓寸45启动/停用效果455.5项目操作465.5.1项目存取465.5.2Id-索尙的互相连结475.5.3迭代器（ Iterator）475.5.4表头操作475.5.5项目的扩展或折迭485.5.6窗口的停驻或项目的停驻495.5.7项目的尓寸495.5.8附加对象495.5.9附加 URL505.5.10固定格子尓寸505.6事件处理505.6.1附加事件处理函式515.6.2onDock 和 onUndock 事件515.6.3onResizeFinish 事件525.6.4onExpand 事件525.6.5onCollapse 事件525.7附加 DHTMLX 组件525.7.1附加组件到完整的版面525.7.2附加组件到版面项目535.7.3附加树535.7.4附近其它的 dhtmlx 组件536 dhtmlxMenu 2.0 指南与程序代码范例546.1什么是 dhtmlxMenu546.1.1主要功能546.1.2支持的浏览器556.2dhtmlxMenu 2.0 初始化556.2.1新选单对象的建立556.2.2设定图文件路径576.2.3设定 Skin576.2.4数据加载626.2.5全域性的参数646.3项目设定的操作666.3.1建立 Sibling 项目666.3.2建立新的子项目666.3.3建立新的分隔线676.3.4移除项目676.3.5取得 Parent Id676.3.6启用/停用项目686.3.7显示/隐藏项目686.3.8设定项目的文字686.3.9设定项目的位置696.3.10设定开发员的数据696.3.11设定项目的图片706.3.12设定项目的工具提示706.3.13设定项目的热键716.3.14建立选取方格716.3.15建立单选按钮726.4事件处理736.4.1可使用的事件736.4.2附加一个事件处理736.4.3onClick 和 onTouch 事件736.4.4 onCheckboxClick 事件746.4.5 onRadioClick 事件746.4.6 onXLS 事件756.4.7 onXLE 事件756.4.8 onBeforeContextMenu 事件766.4.9 onAfterContextMenu 事件766.5 XML 格式模板767 dhtmlxTabBar 指南与程序代码范例787.1什么是 dhtmlxTabBar787.1.1 主要功能787.1 支持浏览器787.2 dhtmlxTabBar 的运作797.2.1自 javascript 建构式初始 TabBar 对象797.2.2 依据 HTML 结构初始 TabBar 对象797.2.3 以 Javascript 建立 tabbar807.2.4 自 XML 建立 tabbar807.2.5 用 Javascript 指派页签的内容827.2.6 用 XML 指派页签的内容827.2.7 载入 IFrames 的内容837.2.8 以 AJAX 下载内容847.2.9 混合加载模式847.2.10 设定：位置、排列、位移、边界857.2.11 Skin：颜色、预定的 skin857.2.12 正规化867.2.13 管理 tabbar 和 tab 内容区域的大小867.2.14 以 API 管理每一个 tab878 dhtmlxToolbar 指南与程序代码范例888.1 什么是 dhtmlxToolbar888.1.1 主要特点888.1.2 支持的浏览器898.2 dhtmlxToolbar 的选项种类898.3 初始化 dhtmlxToolbar898.3.1 建立新网页曐幅对象898.3.2 设定影像路径908.4 加载数据908.4.1 由 XML 档案加载数据918.4.2 由 XML 字符串加载数据918.4.3 由 Script 加载数据918.4.4 onLoadFunction928.5 增加和删除选项928.5.1 增加按钮928.5.2 增加文字选项928.5.3 增加选择按钮938.5.4 增加双幠按钮948.5.5 增加分隔线948.5.6 增加滑动棒948.5.7 增加输入区958.5.8 删除选项958.6 设定选项968.6.1 迭代器968.6.2 适用任何选项968.6.3 按钮978.6.4 选择按钮998.6.5 双幠按钮1038.6.6 文字选项1048.6.7 分隔线1048.6.8 滑动棒1048.6.9 输入区选项1068.7 事件处理1078.7.1 可用的事件1078.7.2增添事件处理例程1078.7.3 onClick 事件1088.7.4 onStateChange 事件1088.7.5 onValueChange 事件1088.7.6 onXLS 事件1098.7.7 onXLE 事件1098.7.8 onEnter 事件1098.8 XML 格式模版1099 dhtmlxTree 指南与程序代码范例1119.1 什么是 dhtmlxTree1119.1.1 主要功能1119.1.2 支持浏览器1129.2 dhtmlxTree 的运作方式1129.2.1 网页初始化1129.2.2 事件处理1139.2.3 透过 Script 新增节点1139.2.4 使用 XML 加载数据1149.2.5 自订节点的图示1159.2.6 使用动幠加载的树状元件1169.2.7 节点的操作1169.2.8 序列化树状元件1179.2.9 节点提示1179.2.10 节点的移动1179.2.11 子节点的笔数1189.2.12 智能型 XML 解译1199.2.13 树的选取盒1199.2.14 树的单选按钮1199.2.16 增加效能1209.2.17 弹跳式选单1219.2.18 HTTPS 兼容性1219.2.19 整新载入节点1229.2.20 节点的排序1229.2.21 搜寻功能1229.2.22 多行显示项目1239.2.23 图示1239.2.24 按键的操作1239.2.25 分布式解译1249.2.26 错误处理1249.2.27 节点编辑1289.2.28 服务器端的同步更新1289.2.29 在网页中初始化1309.2.30 智能型呈现(Smart Rendering)13110 dhtmlxGrid指南与程序代码范例13310.1 什么是 dhtmlxGrid13310.1.1 主要功能13310.1.2 1.5 版提供的新功能13310.1.3支持浏览器13410.2 dhtmlXGrid 的运作方式13410.2.1按键操作13410.2.2 在网页上初始化组件13410.2.3 事件处理函式13510.2.4 使用 Script 新增数据列13610.2.5 使用 XML 加载数据13610.2.6 使用 Script 新增节点数据列 (TreeGrid)13810.2.7 序列化组件13810.2.8 卷动时的动幠载入13910.2.9 数据列的操作13910.2.10 数据列的移动13910.2.11 弹跳式选单13910.2.12 TreeGrid XML 结构14110.2.13 智能型 XML 解译 (只适用在 TreeGrid)14110.2.14 选取盒与单选按钮14110.2.15 增加效能14210.2.16 分布式解译14210.2.17 多行的资料列14210.2.18 多选模式14210.2.19 拖放功能14210.2.20 延伸的拖放模式14310.2.21 数学公式14310.2.22 TreeGrid 的公式设定14410.2.23 鼠标尙导模式14410.2.24 透过 XML 设定14410.2.25 与 dhtmlxTree 互动 (组件之间的拖放)14610.2.26 使用编辑器 (eXcell)14710.2.27 连结服务器端的数据处理14810.2.28 树状元件与数据方格组件的初始化及使用方式15210.2.29 定义新的编辑器 (eXcell)15310.2.30 分页输出15610.2.31 智能型呈现15710.2.32 合并储存格15810.2.33 分割模式与冻结字段15910.2.34 表头图示15910.2.35 treeGrid 的动幠载入16010.2.36 新增/删除/移动 字段16010.2.37 汇出/汇入 CSV16110.2.38 复制数据到 Excel (剪贴簿的操作)16110.2.39 设定储存格类型16210.2.40 多行表头表尾16210.2.41 储存还原字段的宽度16410.2.42 由网页表格初始化16510.2.43 dhtmlxTreeGrid 的智能型解译16610.2.44 Skins16610.2.45 筛选16610.2.46 一次筛选多值16710.2.47 在表头上加上筛选16710.2.48 群组16810.2.49 延伸应用16810.2.50 节点之间的线呈现方式16910.2.51 在巢状的数据方块新增子数据列16910.2.52 数据透视表16910.2.53 自动计算表头与表尾的值17010.2.54 FAST 模式的相关操作17011 hyProgressBar 指南与程序代码范例17111.1 什么是 hyProgressBar17111.1.1 主要功能17111.1.2 支持浏览器17111.1.3 初始化 hyProgressBar171ll.l.3.l. 自动产生 myProgressBarHandler 集合对象(预设)1711前言(Introduction)1.1目的(Purpose)本使用尝册目的是配合研考会共享服务组件开发项目，针对服 务开发者操作 DHTMLX 组件而撰写，DHTMLX 是一套网页开发 的函式库，他提供了树状元件、数据方格组件、工具列等组件供开发 人员使用；避免重复撰写组件，缩短开发时间，目的在让开发者充分 了解组件的每项功能，同时也让开发者能够迅速并容易地操作这些元 件。本文件系根据 DHTMLX 在线说明，开发人员也可直接使用组件 的在线说明功能。1.2范围(Scope)根据上述目标，本文件范围主要描述以 DHTMLX 公司所提供的开 源函式库，此函式库包含 dhtmlxCalendar、dhtmlxCombo、 dhtmlxEditor、dhtmlxLayout、dhtmlxMenu、dhtmlxTabBar、 dhtmlxToolbar、dhtmlxTree、dhtmlxGrid、共九个组件，并加入凌 网自行开发之 hyProgressBar 共十个组件，所代表的意义请见下一节 说明。1.3名词定义 (Definition)名词解释dhtmlxCombo窗体输入组件，提供自动完成，数据选取等整合表单功能。dhtmlxEditor网页编辑器，包含了一般桌面编辑器具备的功能提供使用者更丰富的编辑环境。dhtmlxLayout版型定义组件，提供将数个不同项目组合成单一版面的简易方式。此组件富弹性并容易使用，还有各种预先定义版面样式帮开发者节省设定的时间。dhtmlxMenu选单元件，提供下拉式、上下文或弹跳式选单，有助于网站的指尙、系统说明等等。dhtmlxTabBar页签组件，提供分页信息，分页浏览等功能，有助于网站信息的整合分类。dhtmlxToolbar工具列组件，提供多项工具列按钮，以及曐式与直式的显示，达到网站功能性分类的目的。dhtmlxTree树状元件，提供数据分类显示，数据延迟加载的功能以及数据选取的功能，提供开发者良好的数据显示方式以及对巨量资料的处理方法。dhtmlxGrid数据方格组件，提供开发者类似 MS EXCEL 的元件，可以显示数据与编辑数据，也可以让网站使用者有良好的使用者界面。HywebProgressBar透过进度列显示出操作的完成进度状幠，并且可以支持参数对象(JSON)定义其样式与显示的图标。进度的显示方式有完成百分比(%) 的文字显示。进度列组件并且支持通知，透过设定触发条件当进度达到触发条件，将会触发事件提供给网页应用程序开发人员对事件进行操作与处理。1.4参考文件(References)本文件系根据 DHTMLX 在线说明，经繁体中文化而成 项目工作计划书 V2.0.0软件需求规格书 V3.0.0DHTMLX 官方网站信息及在线说明文件( /docs/products/docsExplorer/index.shtml)2 dhtmlxCalendar 指南与程序代码范例呈现组件提供开发者一套相同的开发模式，对于组件的使用有 相同或类似的呼叫方式，以及易于客制呈现的画面，基于上述原 则，呈现组件应该具备下列条件：(1)呈现组件是一套 Javascript 函式库。(2)使用时需要复制相关档案于开发目录中，再依据各个组件的呼 叫方式使用。(3)各个呈现组件提供标准的 CSS 与图式集，开发人员亦可以自行 定义新的 CSS。(4)各个呈现组件在设定上皆使用 XML 标准格式设定文件。DHTMLX 开源的组件部分符合了这几个要点，开发者可以透过 JavaScript,XML 或 HTML 元素初始化的方式初始组件，也可以根 据 CSS 规格客制组件的呈现方式，并且不相依于其它开源函式库， 所以安装简易方便(只要复制到网站的目录即可开发)。除了这些共 通性质之外，每一个组件的特性功能并不一样，而这些详细的功能 特性会在往后的章节详述。2.1 什么是 dhtmlxCalendardhtmlxCalendar 是一个可以弹出日期选取器或是呈现平面日 历的组件。对于开发者的网站或应用程序而言，dhtmlxCalendar 确实是一个易于使用，并可充分客制适合不同需求的日期选取器方 案。这个日历支持在日期选择上的各种功能，如设定自订的日期格式、使用不同的语言和套版、以及其它不同的功能等。完整的JavaScript API 提供开发者节省时间的设定。dhtmlxCalendar 为开发者提供以下的可能性： 任一日期(如:周日或周一)都可为一周中的第一天;使用年份下拉列表; 设定日期格式 ; 启用日期范围选择; 支持多语系的日历功能; 设定假日。2.1.1 主要特点支持多浏览器 /支持跨平台; 可以 JavaScript API 完全控制; 设定无效的日期范围; 内建多语系支持; 易于连结至文字输入字段; 双日历。2.1.2 支持的浏览器IE 5.5 以上;Mac OS X Safari;Mozilla 1.4 以上;FireFox 0.9 以上。 Google Chrome。 Opera 8.5 以上。2.2 初始化 dhtmlxCalendar下列初始化方式可供 dhtmlxCalendar 开发者使用： 最小初始化;延展型初始化; 与输入连结的日历; 双日历。任一种 dhtmlxCalendar 初始化必须做的第一件事如下：从 Server 下载 dhtmlxCalendar 包，并放置在某一数据 夹;建立一份 HTML 文件;将 dhtmlxCalendar 的 CSS 文件和 JS 文件的完整路径放到建 立的 HTML 文件檔头。window.dhx_globalImgPath=目录的完整路径/codebase/imgs/; / 用来设定日历图文件所在目录之完整路径的 JS 全域变数2.2.1最小初始化首先，开发者必须建立一个放置 dhtmlxCalendar 的对象。 在这个例子中，这个对象是放置在 卷标（对象）中的 一个 元素：下一步将建立一个新的 dhtmlxCalendarObject ，并将其放 置在我们刚刚建立的 元素（对象）之后：mCal = new dhtmlxCalendarObject(objId,true);开发者应指定的参数如下：objId - 要建立 Calendar 之对象的 ID;true|false - 强制显示或不立刻显示日历。 还要再加上最后一个初始化 Calendar 的指令如下：mCal.draw();当网页被加载后，日历即会被显示在页面上，并标出目前日期。注意：当初始化 Calendar 时，开发者应决定是否透过建构式 的第二个参数（设为 true），或使用 draw() 方法来显示日历。2.2.2延展型初始化以延展型初始化建立 Calendar 时，开发者用的也是跟最小 初始化相同的指令来呼叫。延展型初始化的程序代码如下所示：mCal = new dhtmlxCalendarObject(objId, false,name_of_the_option: parameter);mCal.draw();建构式的第三个参数允许开发者启用 Calendar 的不同选项： isYearEditable:true|false - 允许开发员直接用键盘输入年 份；yearsRange:(from,to) - 提供年度范围的设定(数组from,to)；isMonthEditable:(true|false) - 允许开发员直接用键盘输 入月份；isWinHeader:(frue|false) - 将窗口标头显示成按钮 (关 郓，最大化/最小化，设定目前日期) 和“日历标题”标签；headerButtons: XMT - 使用哪些标头按钮：关闭(X)，最大化/最小化(M)，设置目前日期(T)；isWinDrag:(frue|false) - 若设其为 true(而且isWinHeader 也设为 true)，则允许日历可被拖拉。 如果开发者打算一次设置上述多个选项，可将相关指令以逗号分隔写在一起（作为建构式的第三个参数）。2.2.3日历连结输入栏还可以建立一个 Calendar 连结到页面的输入栏。首先，开 发者应先建立输入栏。例如：然后，用一行程序代码建立 Calendar 并连结到新建立的输入 栏：mCal = new dhtmlxCalendarObject(calInput1);mCal.draw();当选到此输入栏时即显示 Calendar。当开发员在 Calendar 上选了某个日期，选定的日期将被设为输入栏的值，然后 Calendar 立即被关闭。2.2.4双日历dhtmlxCalendar 也可被初始化成双日历型式，以便用于选 择日期范围。如同初始化简单型 Calendar 一样，开发者需在 页面上建立一个对象以放置此组件，然后再建立一个新的dhtmlxDblCalendarObject :mDCal = new dhtmlxDblCalendarObject(objId, true);mDCal.draw();日期范围可用 setDate() 方法加上下面的参数便很容易设 定：dateFrom - 指定范围开始的日期;dateTo - 范围的结束日期。mDCal.setDate(dateFrom,dateTo);日历左侧的日历会标示范围的开始日期，右侧则显示范围的 结束日期。另一种在 dthmlxCalendar 组件中设定日期范围的方式将在下面设定日期范围一节里说明。2.3dhtmlxCalendar 设定2.3.1设定 Skin开发者可以下述方式为 dthmlxCalendar 设定使用某个预先 定义的 Skin：mCal.setSkin(skin_name);注意：要设为使用预设 skin 时，开发者应使用空字符串作为setSkin()方法的参数。.可使用的 Skins以下的 Skins 可用于此组件：SilverLight (预设)yahoolikesimplecolordarksimplecolorsandclassicdhx_bluedhx_black2.3.2日期格式日历支持以下几种日期格式： 预设的日期格式; 指定的日期格式; 对特定日期用指定的日期格式。.预设的日期格式dhtmlxCalendar 里预设的日期格式为： %Y-%m-%d..指定的日期格式用 setDateFormat()方法可容易地对整个 Calendar 设定特 定的日期格式：mCal.setDateFormat(format_str);这种方法只需要一个参数-format_str-可包含以下选项：%e g- - 一个月的天数，不带前导的零 (1.31);%d gs - 一个月的天数，包含有前导零的 2 位数(01.31);%jg- - 一年的天数，包含有前导零的 3 位数(001.366);%ag- - 一周里星期的文字表示法，以两个字母表示(Mo.Su) ;%Wg- - 一周里星期的完整文字表式法;%cg- - 月份的数字表示法，不带前导的零(1.12) ;%mgs - 月份的数字表示法，包含有前导零(01.12) ;%b gs - 月份的简短文字表示法，以三个字母表示(Jan.Dec);%Mgs - 月份的完整文字表示法，例如 January 或March (January.December);%y g- - 年份的两位数表示法(93.03);%Y gs - 年份的完整数字表示法，以 4 位数表示(1993.2003);% gs - 将字符%包含在日期格式中举例而言，如果开发者要选用某种日期格式(与预设日期格 式不同)，其中日跟月都要含前导零，年则用完整数字表示法， 而日、月、年间以句点(.)分隔，则应用如下的程序代码：mCal.setDateFormat(%d.%m.%Y);.对特定日期指定日期格式当开发者想对 Calendar 中的某一特定日期设定指定格 式（与预设日期格式及 setDateFormat() 方法中设定的不 同）时，应以下列参数使用 setFormatedDate() 方法：format_str - 对持定日期指定的格式字符串;date - 特定日期。var mCal = new dhtmlxCalendarObject(objId,true);.mCal.setFormatedDate(format_str,date);利用 getFormatedDate() 方法可轻易用下面方式以指 定的格式取得日期字符串：mCal.getFormatedDate(format_str, date);上述方法使用下列参数：format_str - 设定要取得的日期格式;date - 指定的日期。如果省略此参数，将回传Calendar 里目前选取到的日期。2.3.3设定/ 取得日期要设定某个特定日期，使其在日历中如同当前日期般标示出 来，开发者应使用 setDate()方法，并指明该日期作为参数。此 日期应以预设日期格式，或是以 setDateFormat() 方法指定过 的格式来表达：mCal.setDate(date);有个取得 Calendar 目前选定之日期的简单做法：var date = mCal.getDate() / 回传 Calendar 中目前选定的日期2.3.4设定日期范围dhtmlxCalendar 有两种设定日期范围的方式： 对双月历(double Calendar); 对简单月历(simple Calendar)。.双日历(Double Calendar)请参阅 Double Calendar 章节里，关于 setDate()方法的相关信息。.简单日历(Simple Calendar)另一种不同于双日历的日期范围设定方式，是如下面 方式对简单 Calendar 使用 setSensitive()：mCal.setSensitive(dateFrom, dateTo);此方法分派了一段可供开发员选取的日期区间。其参 数为：dateFrom - 最小允许日期; dateTo - 最大允许日期。 当日历被建立时，唯一有效的日期范围是以setSensitive() 方法指定的区间，其它落在指定范围以外的日期都会显示为无效。setSensitive() 方法的另一种用法是将多个日期写成第 一个参数，并省略第二个参数。在这种情况下，开发员 就只能在这些被指定的日期中选取:mCal. setSensitive(array of dates or comma separatedstring list);例如:mCal.setSensitive(2008.20.09,09.30,2008.09.21,2008.09.22);2.3.5设定年度范围也可以用 setYearsRange() 方法设定年度范围：mDCal.setYearsRange(1980, 2020);参数包括:minYear- 范围中的第一年;maxYear - 范围中的最后一年。2.3.6使日历多语系化dhtmlxCalendar 允许开发者增加和使用不同的各国语言尟 援，并可在它们之间动幠地切换。首先，如果 Calendar 组件包 中没有提供该语言的定义，开发者需以程序定义必要的语言设 定。可以下列方法处理：dhtmlxCalendarLangModules = new Array(); /如数组未存在则先建立/为新语言 (Russian，俄语) 设定义dhtmlxCalendarLangModulesru = langname: ru, /新语言的 IDdateformat: %d.%m.%Y, / 日期格式monthesFNames: ?iaa?u, Oa*a?aeu, Ia?o,Ai?a*eu, Iae, E?iu, E?eu, Aaaono,Na*ioya?u, Ieoya?u, Iiya?u, Aa*eaa?u, / 月份的完整名称monthesSNames: ?ia, Oa*a, Ia?, Ai?, Iae, E?i,E?e, Aaa, Na*i, Ieo, Iiy, Aa*e, / 月份的简写daysFNames: Aine?a*na*iua*, Iiia*aa*euiee,Aoi?iee, N?a*aa, ?a*oaa*?a, Iyoieoa,Noaaioa, / 星期的完整名称daysSNames: An, Ii, Ao, N?, ?o, Io, Na,/星期的简写weekend: 0, 6, / 哪几天算是周末weekstart: 1, / 周起始日msgClose: C,ae?uou, / 关闭钮的提示字符串msgMinimize: Naa*?ioou, / 最小化钮的提示字符串msgToday: Na*aiaiy / 今日钮的提示字符串/为新语言 (German，德语) 设定义dhtmlxCalendarLangModulesde = langname: de,dateformat: %d.%m.%Y,monthesFNames: Januar, Februar, Marz, April, Mai,Juni, Juli, August, September, Oktober, November,Dezember,monthesSNames: Jan, Feb, Mar, Apr, Mai, Jun, Jul,Aug, Sep, Okt, Nov, Dez,daysFNames: Sonntag, Montag, Dienstag, Mittwoch,Donnerstag, Freitag, Samstag,daysSNames: So, Mn, Dn, Mt, Dn, Fr, Sa,weekend: 0, 6,weekstart: 1,msgClose: Schlie?en,msgMinimize: Drehen,msgToday: Heute在设好要用的语言设定之后，就可以用 loadUserLanguage()方法指定语言 ID，而在不同语言之间切换：mCal.loadUserLanguage(ru);2.3.7改变周启始日开发者可像下面这样用 weekstart 属性轻易地控制一周启 始日：mCal.options.weekstart=1;/每周从星期一开始起算/ormCal.options.weekstart=0; /每周从星期六开始起算周启始日也可以在整体语言定义(overal language settings)里被定义：/设定周日和周六为周末，以周一为周启始日.weekend: 0, 6, / 周末日weekstart: 1, / 周启始日2.3.8隐藏/ 显示日历Calendar 可用下列方式轻易地显示或隐藏 :mCal.show();mCal.hide();/ 或mCal.close();有个简单测试 Calendar 目前是否可见的方法：如果 isVisible() 方法回传值为 true，则日历就是可见的，反之亦然。var isVisible = mCal.isVisible(); / 回传 true | flase2.3.9假日设定在 dhtmlxCalendar 里有个选项，可让开发者在 Calendar中设定假期。日期应以下列格式之一设定：%m.%d or %m-%d - 在这种情况下，将对 Calendar 里 每年该指定日期设为假日;%Y-%m-%d or %Y.%m.%d - 这种日期格式意味着只对 指定的年月日设定假期，不会每年重复。Calendar 里假期的呈现方式是由 CSS 檔所控制。而设定假 日则是用 setHolidays()方法：mCal.setHolidays( 日期数组 或 以逗号区隔的日期字符串列); / 多个日期可用逗号区隔举例而言，如果开发者想将 2008 年 9 月 24 日，以及每年的5 月 8 日设为假日，可用如下的程序代码：mCal.setHolidays(2008-09-25, 05.08);2.3.10设定无效日期setInsesitiveDates() 方法可在 Calendar 中设定某些日期 为无效而不可选取。日期应以下列格式之一指定：%m.%d or %m-%d - 在这种情况下，表示对 Calendar 里每 年的指定日期都设定为无效;%Y-%m-%d or %Y.%m.%d - 这种日期格式意味着只对指 定的年月日设为无效，不会每年重复。mCal.setInsensitiveDates(日期 数组 或以逗号区隔的日期字符串列);2.3.11对 Calendar 设定新容器setParent() 让开发者能为 Calendar 指定一个新的父对象 或容器(container)mCal.setParent(parentObj);2.3.12设定 Calendar 的位置利用 setPosition() 方法可为 Calendar 设定其新的定位。如 果第一个参数不是一个对象，开发者应用如下的程序代码：mCal.setPosition(argA,argB);此方法的参数如下:argA - 指定 Calendar 的 y 轴位置 ;argB - 指定 Calendar 的 x 轴位置。例如:mCal.setPosition(100, 50);如果在上例加上一个对象作为第一个参数，Calendar 的新 坐标则将是：y - 坐标为 htmlObj 的 y 坐标 + 100 ;x - 坐标为 htmlObj 的 xi 坐标 + 50 。 此例子的程序代码就如下面这样：mCal.setPosition(argA,argB,argC);参数如以下所列：argA - 是个对象;argB - y 轴的增量;argC - x 轴的增量。 例如 :mCal.setPosition(htmlObj,100, 50);2.4事件处理dhtmlxCalendar 提供下列可用事件:onClick - 当开发员在 Calendar 里以鼠标左键点击了某个 日期;onChangeMonth - 当开发员在 Calendar 里按了往前(prev)或往后(next)钮而改变月份。2.4.1外挂事件处理例程开发者可对任何可用事件增加自订的处理例程。要做到这 点，开发者可用 attachEvent() 方法来设