示例开启javascript

8.
3.
3.
3JavaScriptAPI在业务应用系统的网页中使用HTML5报表查看器时,可以调用葡萄城报表提供的JavaScriptAPI以控制报表查看页面的行为.
(1)初始化选项在使用HTML5查看器时,可以在初始化期间或运行时设置以下选项.
uiType说明:设置HTML5Viewer的界面模式.
类型:字符串可接受值:'Custom','Mobile'或者'Desktop'示例:viewer.
option('uiType','Mobile');element说明:JQuery选择器,指定承载HTML5Viewer控件的元素.
注意:此选项仅在初始化期间使用.
类型:字符串示例:varviewer=GrapeCity.
ActiveReports.
Viewer({element:'#viewerContainer2',reportService:{url:'/ActiveReports.
ReportService.
asmx'},});reportService说明:可以使用葡萄城报表服务.
类型:具有url和可选securityToken属性的对象示例:reportService:{url:'http://remote-ar-server.
com/api',securityToken:'42A9CD80A4F3445A9BB60A221D042FCC',resourceHandler:'http://remote-ar-server.
com/cache'};reportService.
url说明:提供报表相关信息和输出的葡萄城报表服务的URL.
类型:字符串示例:reportService:{url:'http://remote-ar-server.
com/api'};reportService.
securityToken说明:登录葡萄城报表服务器所需的安全密钥.
类型:字符串示例:reportService:{securityToken:'42A9CD80A4F3445A9BB60A221D042FCC'};reportService.
resourceHandler说明:葡萄城报表服务器资源处理程序的URL.
类型:字符串示例:reportService:{resourceHandler:'http://remote-ar-server.
com/cache'};reportidreport:{id:'CustomersList',parameters:[{name:'CustomerID',value:'ALFKI'}]};reportIDHTML5IDreport:{id:'CustomersList',parameters:[{name:'CustomerID',value:'ALFKI'}]};reportParameters{namevalue}report:{id:'CustomersList',parameters:[{name:'CustomerID',value:'ALFKI'},{name:'productIDs',value:[10248,10249],multivalue:true}]};reportLoaded说明:当HTML5查看器获取有关请求的报表的信息时调用的回调.
reportInfo对象在回调中传递,包括目录信息,参数信息以及指向呈现的报表结果的链接.
类型:function(reportInfo)示例:varreportLoaded=functionreportLoaded(reportInfo){console.
log(reportInfo.
parameters);};viewer.
option('reportLoaded',reportLoaded);action说明:在HTML5查看器之前调用的回调打开超链接,书签链接,向下钻取报表或切换报表控件的可见性.
类型:function(actionType,actionParams)示例:functiononAction(actionType,actionParams){if(actionType===0){window.
open(params.
url,"Linkedfromreport","height=200,width=200");}}viewer.
option('action',onAction);availableExportsHTML5PDFWordMhtExcelviewer.
option("availableExports",['Pdf']);maxSearchResults说明:单次查找收到的查找结果数量调用.
类型:数字示例:maxSearchResults:10error说明:在显示报表的过程中发生错误时调用的回调.
如果回调返回true,则不显示默认错误面板.
错误参数是一个具有消息属性的对象,允许用户自定义错误消息.
类型:function(error)示例:隐藏默认错误面板varoptions={error:function(error){if(error.
message){showerrormessage.
alert("Internalerror!
Pleaseaskadministrator.
");returntrue;//donotshowdefaulterrormessage.
}},//otherproperties.
};varviewer=GrapeCity.
ActiveReports.
Viewer(options);示例:自定义错误消息varoptions={error:function(error){error.
message="Myerrormessage";},//otherproperties};varviewer=GrapeCity.
ActiveReports.
Viewer(options);documentLoaded说明:当文档完全加载到服务器时调用的回调.
类型:function()示例:vardocumentLoaded=functiondocumentLoaded(){setPaginator();};viewer.
option('documentLoaded',documentLoaded);localeUri说明:包含本地化字符串的文件的URL.
注意:此选项仅在初始化期间使用.
类型:字符串示例:varviewer=GrapeCity.
ActiveReports.
Viewer({localeUri:'Scripts/i18n/ru.
txt'});showOnlyLastError说明:删除错误面板中的显示详细信息按钮,仅显示最后一个错误.
类型:字符串示例:隐藏"显示详细信息"按钮varviewer=GrapeCity.
ActiveReports.
Viewer({showOnlyLastError:true});(2)公共的方法和属性初始化HTML5Viewer后,可以使用以下API方法和属性.
方法optionvalueoption(name,[value])Objectnamevalueviewer.
option('uiType','mobile');viewer.
option('renderMode','Galley');//viewer.
option('report',{id:'myreport'});refreshoption(name,[value])Objectviewer.
refresh()voidprint说明:打印当前显示的报表.
语法:print()void示例:viewer.
print()返回值:voidgoToPage说明:使查看器显示特定页面,滚动到特定的offset(可选),并在调用完成后调用回调.
语法:goToPage(number,offset,callback)void参数:number:要去的页数.
offset:对象,如{left:12.
2,top:15}.
callback:执行动作后调用的函数.
示例:viewer.
goToPage(1,{2,3},function(){});返回值:voidbackToParent说明:使查看器显示向下钻取报表的父报表.
语法:backToParent()void示例:viewer.
backToParent()返回值:voiddestroy说明:从HTML元素中删除查看器示例.
语法:destroy()void示例:viewer.
destroy()返回值:voidexport说明:导出当前显示的报表.
语法:export(exportType,callback,saveAsDialog,settings)void参数:exportType:指定导出格式.
callback:导出结果可用时调用的函数(其Url在回调中传递).
saveAsDialog:指示导出结果准备就绪后是否立即显示另存为对话框.
settings:导出设置适用于RenderingExtensions.
注意:在区域报表中,导出设置不会启用.
在页面报表和RDL报表中,导出设置在使用导出过滤器(ExportFilter)将文件导出为PDF时不启用.
示例:functionexportToExcel(){viewer.
export('Xls',downloadReport,true,{FileName:"DefaultName.
xls"functionfetchesthereportfromuri(callbackfunction)vardownloadReport=function(uri){varnewWin=null;//openuriinnewwindowtry{newWin=window.
open(uri);}catch(e){}//ifbrowserrejectsopeningnewwindow,openuriincurrentwindowif(!
newWin){window.
location=uri;}};返回值:voidsearch说明:使用特定的查找选项(匹配大小写,全字)执行查找,并在查找的完成时执行回调.
语法:search(searchTerm,searchOptions,callback)void参数:searchTerm:要查找的字符串.
searchOptions:设置查找选项:matchCase:是否大小写敏感.
wholePhrase:是否全字匹配.
callback:执行搜索后调用的功能.
示例:viewer.
search('a',{matchCase:true,wholePhrase:false},function(results){console.
log(results);});返回值:voidgetToc说明:获取报表的目录信息,并调用将结果作为参数传递的回调函数.
语法:getToc(callback)void参数:callback:回调处理目录树.
示例:viewer.
getToc(function(toc){console.
log(toc);})返回值:void属性pageCount说明:获取当前显示的报表的页数.
语法:viewer.
pageCount示例:console.
log(viewer.
pageCount)返回值:表示页数的整数.
currentPage说明:获取当前显示的页码.
语法:viewer.
currentPage示例:console.
log(viewer.
currentPage)返回值:表示当前显示的页码的整数.
Toolbar说明:返回在桌面界面模式下显示工具栏的HTML元素.
语法:viewer.
Toolbar示例://Toolbar,MobileToolbarTop,MobileToolbarBottom$(viewer.
toolbar).
hide();$(viewer.
toolbarTop).
hide();$(viewer.
toolbarBottom).
hide();ToolbarTop说明:返回在移动界面模式下显示顶部工具栏的HTML元素.
语法:viewer.
ToolbarTop示例://Toolbar,MobileToolbarTop,MobileToolbarBottom$(viewer.
toolbar).
hide();$(viewer.
toolbarTop).
hide();$(viewer.
toolbarBottom).
hide();ToolbarBottom说明:返回以移动界面模式显示底部工具栏的HTML元素.
语法:viewer.
ToolbarBottom示例://Toolbar,MobileToolbarTop,MobileToolbarBottom$(viewer.
toolbar).
hide();$(viewer.
toolbarTop).
hide();$(viewer.
toolbarBottom).
hide();有关葡萄城报表JavaScriptAPI更详细的说明,参见:http://help.
grapecity.
com/activereports/webhelp/AR11/index.
html#HTML5WorkingwithViewerUsingJavascript.
html