CuteEditor_for_NET6 使用详解

CuteEditor_for_NET6 使用详解
详细出处参考： http://www.pqshow.com/program/aspnet/200909/10196.html

一、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/"

      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>

二、基本属性：

      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 编辑器添加中文字体

可以修改文件CuteSoft_Client\CuteEditor\Configuration\Shared\Common.config来添加字体。
主要注意的地方是该文件是用XML编码

<item text="FangSong_GB2312" html="&lt;font size=3 face='FangSong_GB2312'&gt;仿宋&lt;/font&gt;">FangSong_GB2312</item>
   <item text="KaiTi_GB2312" html="&lt;font size=3 face='KaiTi_GB2312'&gt;楷体_GB2312&lt;/font&gt;">KaiTi_GB2312</item>

要在CuteEditor中显示中文字体，需要将中文字体名称进行“国际化”，即将汉字字体名称改为英文名称，
如将“宋体”改为“Simsun"，“黑体”改为"Simhei"等，下面是部分字体对照列表：
English Name    Localized Name  
SimSun                宋体  
SimHei                黑体  
FangSong_GB2312       仿宋_GB2312  
KaiTi_GB2312      楷体_GB2312  
YouYuan       幼圆  
STSong       华文宋体  
STZhongsong      华文中宋  
STKaiti    华文楷体  
STFangsong   华文仿宋  
STXihei    华文细黑  
STLiti    华文隶书  
STXingkai    华文行楷  
STXinwei    华文新魏  
STHupo    华文琥珀  
STCaiyun    华文彩云  
FZYaoTi    方正姚体简体  
FZShuTi    方正舒体简体  
NSimSun    新宋体  
LiSu     隶书