CuteEditor使用详解,ASP.NET编辑器

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 ></CE:EDITOR>

或者

<CE:Editor 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> 节全部注释

上面两种方法都可以解决 "文本内容中出现无效字符" 提示框的问题,但不确定之后会出现什么其他问题。