# ZEditor

**Repository Path**: zhwily_wang/zeditor

## Basic Information

- **Project Name**: ZEditor
- **Description**: ZEditor 是基于.Net6下 winform控件 RichTextBox 开发的所见即所得富文本编辑器
- **Primary Language**: C#
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 3
- **Created**: 2023-03-22
- **Last Updated**: 2025-11-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ZEditor


#### 介绍

ZEditor 是基于.Net6下 winform 控件 RichTextBox 开发的所见即所得富文本编辑器


#### 前言

日常工作中常有 winform 下实现简单的富文本编辑功能的需求。  

目前网络上实现 winform 富文本编辑器一般有2种方式：  
1. 使用 WebBrowser 控件嵌套 html编辑器使用，这种方式在.NetFramework下使用的比较多，而且需要依赖 IE 浏览器（或引入CEF浏览器）。
到了 .net core 下面，WebBrowser 控件不再默认，给使用带来了不少麻烦。（.net core 下可以使用 WebView）  

2. 使用 winform RichTextBox 控件实现，但是目前基于 .net core 的比较少。  

于是综合了网上大部分写法，采用复合组件的方式，写了一个基于 .net6 的富文本编辑器用户控件  


#### 软件架构

本软件是基于 .Net6 下 winform 控件 RichTextBox 开发的所见即所得富文本 Winform 编辑器。  

实现原理是使用 ToolStrip + RichTextBox 组成复合用户控件，实现富文本编辑器功能。
然后通过把输入的内容转成  byte 数组保存到数据库。  

所以 **<font color=#ff0000 size=14>本软件没有使用到特殊技能及算法</font>** ，谨防上当受骗！  


#### 安装教程

引用下载的ZEditor控件到项目中，在Visual Studio工具箱中添加工具项，选择ZEditor.dll后，直接拖控件到项目中即可使用。
![拖拽控件到窗体中](doc/%E5%9B%BE%E7%89%87.png)


#### 使用说明

1.  工具栏一共有4种配置：Default/Simple/Full/Customer 来开启哪些按钮显示，哪些不显示。
    选择Customer时，需要设置 “ToolBarCustomer”属性来控制工具栏按钮
2.  可以设置工具栏背景色、文本框背景色
3.  提交数据时，通过 RichText 属性获取文本框输入的值

| Customer配置 | ![Customer配置](doc/Customer.png) |
|----|----|
| Default配置 | ![Default配置](doc/Default.png) |
| Full配置 | ![Full配置](doc/Full.png) |
| Simple配置 | ![Simple配置](doc/Simple.png) |

#### 示例

示例提供了保存输入内容到Sqlite数据库，**请将DB文件夹下面 demo.db 放到 bin 文件夹下查看效果**


#### 多端兼容问题

目前使用 RTF 格式保存的输入内容，如果需要同时兼容PC浏览器、手机端， **这不是一个好的选择。** 


#### 计划

后期将在 .Net6 下使用 WebView 实现嵌套 HTML 方式实现编辑器功能。


#### 感谢

该用户控件借鉴了网上 RichTextBox 写入RFT文档格式的思路。目前这个软件只是一个非常小众的需求，刚刚成型还有很多不完善的地方希望大家多多包涵，如果喜欢的话也希望大家给个star. 该文档也是这几天不停修改赶出来，希望更多的人关注，也希望更多的人可以交流。

感谢各位优秀开源的前辈代码和思路才有的这个用户控件，希望可以为 .Net 生态提供一份微薄之力。


#### 捐赠

winform 早已日薄西山，除了工控行业，基本没用武之地。
而这个用户控件更是非常小众的需求。你的支持，是我继续前进的动力。

|  ![支付宝](doc/alipay.jpg) |  ![微信](doc/webchat.jpg) |
|---|---|