ICAHtmlPlugin 接口

// {9F5EDF05-1E8E-4efd-B832-6B5F018A78CD}
const GUID IID_ICAHtmlPlugin = 
{ 0x9f5edf05, 0x1e8e, 0x4efd, { 0xb8, 0x32, 0x6b, 0x5f, 0x1, 0x8a, 0x78, 0xcd } };

interface ICAHtmlPlugin: public IUnknown
{
    virtual HRESULT STDMETHODCALLTYPE Init(ICAHtmlTool* pTool) = 0;
    virtual HRESULT STDMETHODCALLTYPE Exit() = 0;
    virtual HRESULT STDMETHODCALLTYPE get_PluginFlags(long* pnFlags) = 0;
    virtual HRESULT STDMETHODCALLTYPE put_HtmlFlags(long nFlags) = 0;
    virtual HRESULT STDMETHODCALLTYPE Config() = 0;
    virtual HRESULT STDMETHODCALLTYPE OnTag(BSTR bstrTag, BSTR* pbstrResult, VARIANT* pvAdditionalResourceURLs) = 0;
    virtual HRESULT STDMETHODCALLTYPE OnText(BSTR bstrText, BSTR* pbstrResult) = 0;
    virtual HRESULT STDMETHODCALLTYPE OnProgress(long nProgress) = 0;
    virtual HRESULT STDMETHODCALLTYPE OnBeforeProcessNode(ICANode* pNode) = 0;
    virtual HRESULT STDMETHODCALLTYPE OnAfterProcessNode() = 0;
    virtual HRESULT STDMETHODCALLTYPE OnBeforeProcessHtml(BSTR bstrURL, BSTR bstrHtml, BSTR* pbstrResult) = 0;
    virtual HRESULT STDMETHODCALLTYPE OnAfterProcessHtml(BSTR bstrHtml, BSTR* pbstrResult) = 0;
    virtual HRESULT STDMETHODCALLTYPE get_Order(long* pnOrder) = 0;
};

Init(ICAHtmlTool* pTool)

说明

参数

• ICAHtmlTool：[in]，ICAHtmlTool对象。插件可以使用这个对象，用来从HTML Tag里面获得一些信息。具体请查看ICAHtmlTool接口。

返回

• S_OK：如果插件初始化成功，应该返回S_OK。
• E_FAIL：如果插件初始化成功，应该返回E_FAIL。

Exit()

说明

参数

返回

get_PluginFlags(long* pnFlags)

说明

参数

• pnFlags：[out]。可能的值：
  

  HPF_PROCESS_HTML_TOOL	0x00000001	该插件可以用于文章批量处理功能。
  HPF_CONFIG	0x00010000	该插件支持用户进行设置

返回

put_HtmlFlags(long nFlags)

说明

参数

• nFlags：保留，HTML处理插件应该忽略该参数。

返回

Config()

说明

参数

返回

OnTag(BSTR bstrTag, BSTR* pbstrResult, VARIANT* pvAdditionalResourceURLs)

说明

参数

• bstrTag：[in]。HTML Tag内容。通常应该是<a href="abc.html">这种形式。
• pbstrResult：[out]。插件处理之后的HTML Tag内容。
• pvAdditionalResourceURLs：[out]。这是一个安全数组。数组元素是VARIANT。插件处理该HTML Tag之后，认为CyberArticle应该同时保存某些资源。例如插件在处理<img src="http://www.wizissoft.com/images/logo.gif">之后，认为CyberArticle应该同时保存http://www.wizissoft.com/images/logo.gif，才可以完整保存网页。那么，就需要通过该参数，返回图片的URL（或者本地的文件名）。
  
  
  在WizHelper.h文件中，提供了一个辅助函数WizStringArrayToVariant，用来将一个CString数组，转换成一个VARIANT。下面是一个例子：
  
  

  #include "C:/Program Files/Wizissoft/CyberArticle/developers/interface/include/WizHelper.h"
  
  virtual HRESULT STDMETHODCALLTYPE CProcessImagePlugin::OnTag(BSTR bstrTag, BSTR* pbstrResult, VARIANT* pvAdditionalResourceURLs)
  {
      ...
      CWizStdStringArray arrayFiles; 
      arrayFiles.push_back(_T("e:\\1.gif"));
      arrayFiles.push_back(_T("http://www.wizissoft.com/images/logo.gif"));
      // 
      CComVariant vFiles; 
      WizStringArrayToVariant(arrayFiles, vFiles); 
      // 
      VariantCopy(pvAdditionalResourceURLs, &vFiles); 
      //
      return S_OK;
  }

返回

OnText(BSTR bstrText, BSTR* pbstrResult)

说明

参数

• nProgress：[in]，当前进度。总进度是100。

返回

OnBeforeProcessNode(ICANode* pNode)

说明

参数

• pNode：[in]。进行处理的文章。

返回

OnAfterProcessNode()

说明

参数

返回

OnBeforeProcessHtml(BSTR bstrURL, BSTR bstrHtml, BSTR* pbstrResult)

说明

参数

• bstrURL：[in]。即将处理的文章URL。
• bstrHtml：[in]。即将处理的文章内容(HTML格式)。
• pbstrResult：[out]。如果插件处理了该文章内容，通过这个参数返回处理后的结果。

返回

OnAfterProcessHtml(BSTR bstrHtml, BSTR* pbstrResult)

说明

参数

返回

get_Order(long* pnOrder)