CuteEditor使用详解

CuteEditor是一款功能非常强大，支持图片上传、文件下载和word类似的文字编辑器。对于新闻发布系统和博客之类的系统，是非常的方便的。

一、CuteEditor的配置

      1、将以下文件考贝到你站点根目录下的bin内(这些在CuteEditor6.0/bin下都可以找到）
      CuteEditor.dll，
      CuteEditor.ImageEditor.dll（6.0增加的EditorImage功能），
      CuteEditor.lic（解密文件），
      NetSpell.SpellChecker.dll（拼写检查功能）
      注：（“.dic”为扩展名的文件是词典保存为纯文本文件的格式。将CuteEditor6.0/bin文件夹里的都拷到站点根目录下的bin内也可以）

      2、将CuteSoft_Client文件夹拷贝到项目的根目录
      CuteSoft_Client包含CuteEditor文件夹和example.css,放了控件图片,文件之类的数据example.css它指定了编辑器的样式。（在2.0下可能要把dialog文件夹里面的getfilethub.aspx删除）
      注:FilesPath用来设置所对应的目录,如：FilesPath="~/admin/CuteSoft_Client/CuteEditor/"

          把example.css文件拷贝到相应目录，并设置EditorWysiwygModeCss属性。如：EditorWysiwygModeCss="/admin/CuteSoft_Client/CuteEditor/themes/example.css     

      3、在根目录下建立Uploads的文件夹作为上传图片及附件的根目录

      4、将CuteEditor.dll添加到工具箱
      先在工具箱空白处右击选择“添加选择项”，给选项卡添加一外名称为：CuteEditor。再在该选项卡中右击，选择“选择项 ”，在弹出的对话框的“.NET Frameword组件”标签中选择要添加的DLL文件即可。

      5、CuteEditor属性设置(假设当前页在根目录下)
      1)AutoConfigure设为simple，即选择最简单的界面显示方式
     2)EditorWysiwygModecss设为：CuteSoft_Client/example.cs，需要把example.css文件放到该目录下。
     3)FilesPath设为：CuteSoft_Client/CuteEditor，设置CuteEditor目录的路径

      6、控件的调用代码如下：
      <%@ Register TagPrefix="CE" Namespace="CuteEditor" Assembly="CuteEditor" %> 如果是按照第4步从工具箱中拖放到页面的话，则此代码会自动生成，不需要要手动添加。
      <CE:EDITOR id="Editor1" runat="server" Width="700px" FilesPath="~/CuteSoft_Client/CuteEditor/"   EditorWysiwygModeCss="../example.css"    ThemeType="Office2003_BlueTheme"></CE:EDITOR>

       或者

      <CE:Editor ID="ce1" runat="server" FilesPath="~/admin/CuteSoft_Client/CuteEditor/" EditorWysiwygModeCss="~/Admin/CuteSoft_Client/CuteEditor/Themes/example.css"     ThemeType="Office2003_BlueTheme" ></CE:Editor>

      注：

          可修改CuteSoft_Client/CuteEditor/Configuration/AutoConfigure文件夹下的文件，改便CuteEditor工具栏按钮的显示或排列。

          可修改文件CuteSoft_Client/CuteEditor/Configuration/Shared/Common.config来添加字体。

      7、修改Web.config文件

     <appSettings>

         <add key="DictionaryFolder" value="bin" />

     </appSettings>

     <system.web>//注本节代码在.net2.0下是否需要设置，本人未验证。

         <browserCaps>

          tagwriter=System.Web.UI.HtmlTextWriter

         </browserCaps>

     </system.web>

二、基本属性：

      EditorWysiwygModeCss :设置样式
      ThemeType :设置风格
      AutoConfigure :选择功能是简单还是复杂的
      Text :设置加载时候默认内容
      MaxHTMLLength :设置最大长度
      BreakElement :默认“回车”产生什么HTML
      URLType :没发现有什么区别
      ResizeMode :自动长度（长度设置的几中形式）
      ReadOnly :是否为只读
      CustomCulture :设置语言类型 china 为zh-cn
      EditCompleteDocument :设置是否完整的HTML页面代码（也就是说是不是包括html头）
      AllowPasteHtml :是否允许粘帖HTML代码
      EnableContextMenu :在文本里是否显示右键菜单

三、CuteEditor文件夹里的配置

      1）控制工具拦显示：在CuteSoft_Client/CuteEditor/Configuration/AutoConfigure 里设置
      2）控制右键显示：CuteSoft_Client/CuteEditor/Configuration/ContextMenuMode里设置
      3）设置权限：CuteSoft_Client/CuteEditor/Configuration/Security里设置

       例如要设置各种组件的大小等属性限制，如控制上传文件的大小等，可在CuteSoft_Client/CuteEditor/Configuration/Security修改“Security”文件夹中的“Default.config”文件即可
      ==========================
      <?xml version="1.0" encoding="utf-8" ?>
      <configuration>
      <security name="RestrictUploadedImageDimension">true</security>   //是否限制上传图象尺寸
      <security name="OverWriteExistingUploadedFile">false</security>   //如果上传的文件已经存在，是否将其覆盖
      <security name="UseTimeStampRenameUploadedFiles">true</security> //重命名为时间
      <security name="AutoResizeUploadedImages">true</security>   //是否自动调整上传图象
      <security name="MaxImageWidth">1024</security>   //上传图象的最大宽度
      <security name="MaxImageHeight">768</security>   //上传图象的最小宽度
      <security name="MaxImageSize">1000</security>   //上传图象文件的最大值
      <security name="MaxMediaSize">100</security>   //上传媒体文件的最大值
      <security name="MaxFlashSize">100</security>   //上传Flash文件的最大值
      <security name="MaxDocumentSize">10000</security>   //文档最大值
      <security name="MaxTemplateSize">1000</security>   //模板最大值
      <security name="ImageGalleryPath">~/uploads</security>   //图象文件上传路径
      <security name="MediaGalleryPath">~/uploads</security>   //媒体文件上传路径
      <security name="FlashGalleryPath">~/uploads</security>   //Flash文件上传路径
      <security name="TemplateGalleryPath">~/templates</security>   //模板路径
      <security name="FilesGalleryPath">~/uploads</security>   //文件库路径
      <security name="MaxImageFolderSize">102400</security>   //图象文件夹最大值
      <security name="MaxMediaFolderSize">102400</security>   //媒体文件夹最大值
      <security name="MaxFlashFolderSize">102400</security>   //Flash文件夹最大值
      <security name="MaxDocumentFolderSize">102400</security>   //文档文件夹最大值
      <security name="MaxTemplateFolderSize">102400</security>   //模板文件夹最大值
      <security name="ThumbnailWidth">80</security>   //最小宽度
      <security name="ThumbnailHeight">80</security>   //最小高度
      <security name="ThumbnailColumns">5</security>   //最小列数
      <security name="ThumbnailRows">3</security>   //最小行数
      <security name="AllowUpload">true</security>   //是否允许上传
      <security name="AllowModify">true</security>   //是否允许修改
      <security name="AllowRename">true</security>   //是否允许重命名
      <security name="AllowDelete">true</security>   //是否允许删除
      <security name="AllowCopy">true</security>   //是否允许复制
      <security name="AllowMove">true</security> <!-- this is rename too -->   //是否允许移动
      <security name="AllowCreateFolder">true</security>   //是否允许创建文件夹
      <security name="AllowDeleteFolder">true</security>   //是否允许删除文件夹
      <security name="ImageFilters">   //这里过滤(设置)图象文件格式
            <item>.jpg</item>
            <item>.jpeg</item>
            <item>.gif</item>
            <item>.png</item>
      </security>
      <security name="MediaFilters">   //这里过滤(设置)媒体文件格式
            <item>.avi</item>
            <item>.mpg</item>
            <item>.mpeg</item>
            <item>.mp3</item>
      </security>
      <security name="DocumentFilters">   //这里过滤(设置)文档文件格式
            <item>.txt</item>
            <item>.doc</item>
            <item>.pdf</item>
            <item>.zip</item>
            <item>.rar</item>
            <item>.avi</item>
            <item>.mpg</item>
            <item>.mpeg</item>
            <item>.swf</item>
            <item>.jpg</item>
            <item>.jpeg</item>
            <item>.gif</item>
            <item>.png</item>
            <item>.htm</item>
      </security>
      </configuration>
      ========================

      4）设置工具拦按钮具体功能：CuteSoft_Client/CuteEditor/Configuration/Shared 里设置
      5）设置工具拦按钮具体功能：CuteSoft_Client/CuteEditor/Configuration/Shared 里设置
      6）设置语言：CuteSoft_Client/CuteEditor/Configuration/Languages里设置
      7）添加字体：CuteSoft_Client/CuteEditor/Configuration/Shared/Common.config里设置
      感觉 CuteEditor 每处都可以 改变，因为它整体思路都是用摸板，具体体现形式写在配置文件里面。用户修改配置文件或是它提供的属性就可以实现自己的功能！

四、CuteEditor的服务器端控制

      1）设置编辑器的默认文本：
            Editor1.Text = "Default Text";              //服务器端方法
            var editor = document.getElementById('<%=Editor1.ClientID %>');    //JavaScript方法
            var editorText = editor.getHTML();
      2）修改文件的上传目录：Editor1.SetSecurityGalleryPath("~/uploads/jpg");
            修改上传文件的总大小(以Flash为例)：Editor1.SetSecurityMaxFlashFolderSize(1000);
            修改单个上传文件的大小(以Flash为例)：Editor1.SetSecurityMaxFlashSize(kb);   //默认KB为单位

      3）多用户文件夹
            由于上传的文件统一被放置到uploads文件夹中，可以通过程序控制为每个用户建立一个上传的文件 夹。代码如下：
            using System.IO;
            string username = Session["username"].ToString() ;
            fullPath = Server.MapPath("uploads//") + username;
            if (!Directory.Exists(fullPath))
            {
                  Directory.CreateDirectory(fullPath);
            }
            Editor1.SetSecurityGalleryPath("~/uploads/" + username);

五、动态分配CuteEditor上传路径

      就是 SetSecurityGalleryPath这个方法可以设置上传路径，这样就可以实现每个用户独立一个文件，甚至可以分配空间大小等。
      Editor1.SetSecurityGalleryPath("~/uploads/" + username);
      以图片为例
      Editor1.SetSecurityImageBrowserPath(path);//设置浏览图片路径
      Editor1.SetSecurityImageGalleryPath(path);//设置图片上传路径
      Editor1.SetSecurityMaxImageDimension(width,height);//设置图片上传尺寸
      Editor1.SetSecurityMaxImageSize(kb);//设置图片上传文件大小
      其他还有类似的方法，可以慢慢研究。
六、使cuteeditor支持中文上传
      CuteEditor是个非常强大的编辑器，不过也有不尽任意的地方，例如上传不支持中文，不过也有方法解决。
      打开CuteSoft_Client/CuteEditor/Configuration/Security/Default.config文件
      找到
      <security name="filenamePattern" />
      把他改成
      <security name="filenamePattern">^[a-zA-Z0-9/._/s-/u4e00-/u9fa5]+$</security>
 
 
补充:
使用CuteEditor时有时会出现  "文本内容中出现无效字符"   的提示框 ,虽然不影响使用,但也不好看!
解决方法:
一>.
只需在web.config中将编码改为"utf-8"就可以:
<system.web>节点下加入
      <globalization requestEncoding="UTF-8" responseEncoding="UTF-8"/>
二>.
将 CuteSoft_Client/CuteEditor/Configuration/Shared/Common.config 文件中的  <contextmenus>...</contextmenus>  节全部注释
上面两种方法都可以解决  "文本内容中出现无效字符"  提示框的问题，但不确定之后会出现什么其他问题。

本文来自CSDN博客，转载请标明出处：http://blog.csdn.net/sgivee/archive/2010/03/04/5345476.aspx