HTML Renderer 技术文档

HTML Renderer 技术文档

HTML-Renderer Cross framework (WinForms/WPF/PDF/Metro/Mono/etc.), Multipurpose (UI Controls / Image generation / PDF generation / etc.), 100% managed (C#), High performance HTML Rendering library. 项目地址: https://gitcode.com/gh_mirrors/ht/HTML-Renderer

1. 安装指南

1.1 系统要求

• .NET 2.0 或更高版本，包括 Client Profile。
• 无外部依赖，仅需要 .NET 框架。

1.2 安装方式

HTML Renderer 可以通过 NuGet 包管理器进行安装。以下是各个平台的 NuGet 包：

• WinForms: HtmlRenderer.WinForms
• WPF: HtmlRenderer.WPF
• Mono: HtmlRenderer.Mono
• PDF 生成: HtmlRenderer.PdfSharp
• 核心库: HtmlRenderer.Core

在 Visual Studio 中，打开“工具” -> “NuGet 包管理器” -> “管理解决方案的 NuGet 包”，搜索并安装相应的包。

2. 项目使用说明

2.1 概述

HTML Renderer 是一个跨框架的 HTML 渲染库，支持 WinForms、WPF、PDF 生成等多种用途。它完全由 C# 编写，无外部依赖，性能高且内存占用低。

2.2 主要功能

• HTML 4.01 和 CSS 2 规范支持：支持广泛的 HTML 和 CSS 规范。
• CSS 分离：支持将 CSS 样式表与 HTML 分离加载。
• 文本选择与复制粘贴：支持文本选择、复制和粘贴功能。
• WinForms 控件：包括 HtmlPanel、HtmlLabel 和 HtmlToolTip。
• WPF 控件：包括 HtmlPanel 和 HtmlLabel。
• Mono 支持：可以在 Mono 环境下运行。
• 图像和 PDF 生成：可以从 HTML 代码片段生成图像和 PDF 文档。
• 处理不规范 HTML：能够处理实际应用中的不规范 HTML。

2.3 示例应用

• 渲染富文本编辑器生成的 HTML：如论坛、博客等。
• 渲染 Office 文档转换的 HTML。
• 创建支持文本选择的 WinForms UI。
• 从 HTML 代码片段生成图像。
• 从 HTML 代码片段生成 PDF 文档。

3. 项目 API 使用文档

3.1 WinForms 控件

• HtmlPanel：功能强大的 HTML 控件，替代 WebBrowser 控件，支持 HTML 渲染、文本选择、滚动条、链接点击拦截等。
• HtmlLabel：类似 WinForms 的 Label 控件，但支持 HTML、文本选择、自动调整大小、透明背景等。
• HtmlToolTip：类似 WinForms 的 ToolTip 控件，但支持 HTML 和链接处理。

3.2 WPF 控件

• HtmlPanel：WPF 中的 HtmlPanel 控件，支持 HTML 渲染。
• HtmlLabel：WPF 中的 HtmlLabel 控件，支持 HTML 渲染。

3.3 图像和 PDF 生成

• 图像生成：通过 API 从 HTML 代码片段生成图像。
• PDF 生成：通过 API 从 HTML 代码片段生成 PDF 文档。

4. 项目安装方式

4.1 通过 NuGet 安装

在 Visual Studio 中，使用 NuGet 包管理器安装相应的包：

• WinForms: Install-Package HtmlRenderer.WinForms
• WPF: Install-Package HtmlRenderer.WPF
• Mono: Install-Package HtmlRenderer.Mono
• PDF 生成: Install-Package HtmlRenderer.PdfSharp
• 核心库: Install-Package HtmlRenderer.Core

4.2 手动下载

可以从 CodePlex 下载 Demo 应用程序，探索 HTML Renderer 的功能。

通过以上步骤，您可以轻松安装并使用 HTML Renderer 项目，享受其强大的 HTML 渲染功能。

HTML-Renderer Cross framework (WinForms/WPF/PDF/Metro/Mono/etc.), Multipurpose (UI Controls / Image generation / PDF generation / etc.), 100% managed (C#), High performance HTML Rendering library. 项目地址: https://gitcode.com/gh_mirrors/ht/HTML-Renderer