com.zhuozhengsoft.pageoffice
类 HtmlSignCtrl

java.lang.Object
  com.zhuozhengsoft.pageoffice.HtmlSignCtrl

public class HtmlSignCtrl
extends java.lang.Object

PHtmlSignCtrl 类是PageOffice开发平台中的网页手写签章类。

版本：

2.0

作者：

北京卓正志远软件有限公司

构造方法摘要

HtmlSignCtrl(HttpServletRequest request)
初始化 HtmlSignCtrl 类的新实例。

方法摘要

void	loadToPage(java.lang.String pageID, HtmlSignMode signMode, java.lang.String userName) 为当前页面加载手写及签章。
void	setServerPage(java.lang.String serverPage) 设置 HtmlSignCtrl 控件的运行服务页面。
void	setTagId(java.lang.String id) 此方法非常重要，在HtmlSignCtrl的后台Java调用代码末尾处必须调用。
void	setZoomSealServer(java.lang.String serverPage)

从类 java.lang.Object 继承的方法

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造方法详细信息

HtmlSignCtrl

public HtmlSignCtrl(HttpServletRequest request)

初始化 HtmlSignCtrl 类的新实例。

方法详细信息

setTagId

public void setTagId(java.lang.String id)
              throws java.lang.Exception,
                     java.io.IOException

此方法非常重要，在HtmlSignCtrl的后台Java调用代码末尾处必须调用。

下面的示例展示如何为当前页面加载网页手写及签章。

 String strPageID = request.getParameter("ZSHTMLSIGN_PageID");
 if ((strPageID != null) && (!strPageID.equals(""))){
                //将当前页面提交得到的PageID保存到与当前页面对应的数据库字段里。
 }
 HtmlSignCtrl hsCtrl1 = new HtmlSignCtrl(request);
 //设置 HtmlSignCtrl 的运行服务页面
 hsCtrl1.setServerPage("poserver.do"); // 必须
 //加载网页手写及签章。读取与当前页面对应的数据库字段里保存的PageID，放到这里加载签章。如果当前页面是新建页面，这里PageID设为空字符串即可。
 hsCtrl1.loadToPage("2013012221584774BF", HtmlSignMode.Signer, "张三");
 hsCtrl1.setTagId("HtmlSignCtrl1");
 

参数：

id - 前台HTML代码中放置 HtmlSignCtrl 标签处开发者自定义的控件ID。

抛出：

java.lang.Exception

java.io.IOException

setServerPage

public void setServerPage(java.lang.String serverPage)

设置 HtmlSignCtrl 控件的运行服务页面。

此属性是 HtmlSignCtrl 控件的重要属性。ServerPage 页面为 HtmlSignCtrl 控件提供必须的运行服务。 在调用 loadToPage 方法之前，您必须为 HtmlSignCtrl 控件设置 ServerPage 属性。

下面的示例展示如何使用 ServerPage 属性。

 hsCtrl1.setServerPage("poserver.do"); // 此行必须
 hsCtrl1.loadToPage("2013012221584774BF", HtmlSignMode.Signer, "张三");
 hsCtrl1.setTagId("HtmlSignCtrl1"); // 此行必须
 

参数：

serverPage - 无默认值。ServerPage 属性的值是HtmlSignCtrl的服务页面的URL。

这里的URL可以是相对于当前页面的相对地址，也可以是http开头的绝对地址。相对URL可以是相对于当前页面的地址，也可以是以"/"开头的相对于整个Web应用程序根的地址。

注意：如果URL采用http开头的绝对地址，您必须确保这个地址和当前页面同属于一个网站。

setZoomSealServer

public void setZoomSealServer(java.lang.String serverPage)

loadToPage

public void loadToPage(java.lang.String pageID,
                       HtmlSignMode signMode,
                       java.lang.String userName)
                throws java.lang.Exception,
                       java.io.IOException

为当前页面加载手写及签章。

签章页面的PageID，由HtmlSignCtrl控件保存时自动生成。盖章或手写完毕后，页面提交时，通过request.getParameter("ZSHTMLSIGN_PageID")获取PageID。将此18位长的PageID保存到与当前页面 记录对应的数据字段，作为加载时LoadtoPage方法的参数。

如果PageID为空字符串，则HtmlSignCtrl会自动把当前页面作为无任何签章的新建签章页面。用户添加签章或手写后，调用document.getElementById("HtmlSignCtrl1").SaveSeal()保存，开发者可以获得HtmlSignCtrl为 当前页面生成的唯一标识ID，开发者应该把这个PageID保存到当前页面对应的数据库记录里。待下次打开此网页时，HtmlSignCtrl加载这个PageID即可调入显示此网页上的所有手写及签章。

示例：为当前页面加载手写及签章。

 hsCtrl1.loadToPage("2013012221584774BF", HtmlSignMode.Signer, "张三");
 

参数：

pageID - HtmlSignCtrl保存时生成的唯一标识当前页面的ID。

signMode - HtmlSignCtrl 加载时必须指定的权限模式。

userName - 操作当前网页手写签章的用户名。一般来说，UserName 应该采用登录到您的Web应用程序的当前用户的名称。

抛出：

java.lang.Exception

java.io.IOException

另请参见：

HtmlSignCtrl.setTagId()方法中的示例代码。, HtmlSignSaver.getSignCollection()方法中的示例代码，学习如何在提交页面时获取手写的图片及其他签章信息。