SpiceLogic.HtmlEditor.WinForms
10.0.0
See the version list below for details.
dotnet add package SpiceLogic.HtmlEditor.WinForms --version 10.0.0
NuGet\Install-Package SpiceLogic.HtmlEditor.WinForms -Version 10.0.0
<PackageReference Include="SpiceLogic.HtmlEditor.WinForms" Version="10.0.0" />
<PackageVersion Include="SpiceLogic.HtmlEditor.WinForms" Version="10.0.0" />
<PackageReference Include="SpiceLogic.HtmlEditor.WinForms" />
paket add SpiceLogic.HtmlEditor.WinForms --version 10.0.0
#r "nuget: SpiceLogic.HtmlEditor.WinForms, 10.0.0"
#:package SpiceLogic.HtmlEditor.WinForms@10.0.0
#addin nuget:?package=SpiceLogic.HtmlEditor.WinForms&version=10.0.0
#tool nuget:?package=SpiceLogic.HtmlEditor.WinForms&version=10.0.0
SpiceLogic .NET WinForms HTML Editor Control
A drag-and-drop ready, feature-rich WYSIWYG HTML Editor control for Windows Forms applications.
Features
- WYSIWYG HTML Editing with clean HTML/XHTML output
- Three Editing Modes - Visual editing, HTML source, and preview with synchronized selection
- Built-in Spell Checker with inline and dialog modes (OpenOffice dictionaries)
- MS Word Paste with automatic cleanup and conversion
- Image Handling - insert from file, URL, or clipboard with Base64 embedding
- Table Editor - create, modify, and style HTML tables
- YouTube Embedding - insert YouTube videos directly
- FTP Image Upload - upload local images to remote server
- Customizable Toolbar with modern interface
- CSS Style Builder - visual CSS editing
- Data Binding support for bound scenarios
- Visual Studio Designer integration - drag and drop onto your form
- Comprehensive API - caret positioning, HTML change events, custom paste handling
Installation
NuGet Package Manager
Install-Package SpiceLogic.HtmlEditor.WinForms
.NET CLI
dotnet add package SpiceLogic.HtmlEditor.WinForms
Package Reference
<PackageReference Include="SpiceLogic.HtmlEditor.WinForms" />
Quick Start
Drag and Drop
After installing the NuGet package, the WinFormHtmlEditor control appears in the Visual Studio Toolbox. Simply drag it onto your form.
Programmatic Usage
C#
using SpiceLogic.HtmlEditor.WinForms;
public partial class MainForm : Form
{
public MainForm()
{
InitializeComponent();
// Set initial content
winFormHtmlEditor1.BodyHtml = "<p>Hello <strong>World</strong>!</p>";
// Handle HTML changes
winFormHtmlEditor1.HtmlChanged += (s, e) =>
{
Console.WriteLine("HTML changed!");
};
}
private void SaveDocument()
{
string html = winFormHtmlEditor1.DocumentHtml;
File.WriteAllText("output.html", html);
}
}
VB.NET
Imports SpiceLogic.HtmlEditor.WinForms
Public Class MainForm
Public Sub New()
InitializeComponent()
' Set initial content
winFormHtmlEditor1.BodyHtml = "<p>Hello <strong>World</strong>!</p>"
' Handle HTML changes
AddHandler winFormHtmlEditor1.HtmlChanged, Sub(s, e) Console.WriteLine("HTML changed!")
End Sub
Private Sub SaveDocument()
Dim html As String = winFormHtmlEditor1.DocumentHtml
File.WriteAllText("output.html", html)
End Sub
End Class
License Key
Set the license key once at application startup, before any WinFormHtmlEditor instance is created. The recommended location is Program.cs, inside Main and before Application.Run(...), so the key is in place for every form in the application:
C#
// Program.cs
[STAThread]
static void Main()
{
WinFormHtmlEditor.LicenseKey = "Your license key here";
ApplicationConfiguration.Initialize();
Application.Run(new MainForm());
}
VB.NET
' ApplicationEvents.vb -- Startup handler
Private Sub MyApplication_Startup(sender As Object, e As StartupEventArgs) _
Handles Me.Startup
WinFormHtmlEditor.LicenseKey = "Your license key here"
End Sub
If LicenseKey is not set, the control runs in a 14-day trial mode. A purchased key can be obtained from your SpiceLogic customer account.
HTML source editing
Source mode provides syntax colors, a monospace font, line numbers, indentation and synchronized selection. Options.FormatHtmlSource controls automatic formatting. Long source lines continue on visual rows without inserting those visual separators into saved HTML.
For advanced source editing, GetTheRawHtmlTextEditor() returns SpiceLogic.HtmlEditor.Core.SourceEditing.HtmlSourceEditor in both products. Use its Text, SelectedText, Select(start, length), SelectionStart, SelectionLength, ReplaceSelection, Undo, Redo and ReadOnly members. Positions count UTF-16 code units.
Large documents prepare in the background. Text remains the complete document while IsLoading is true; editing becomes available at SourceLoaded. Use the normal BodyHtml or DocumentHtml property for application content binding. SourceLoadFailed and SourceLoadError expose preparation failures while retaining the original complete text.
Upgrading to 10.0.0
The source accessor previously returned the framework's TextBox. This is a source and binary API change: recompile applications and replace explicit TextBox casts or framework-specific source-control customization with the shared source API. Applications using the editor's standard content properties and mode buttons do not need to access the source control.
The advanced SelectionSynchronizer API now transfers source through HarvestSource and GetSourceWithSelectionMarkers; code calling its former marker mutation methods must also migrate. Normal selection synchronization is handled by the editor. Direct users of the advanced EditorLimitedMembers constructor must pass the new source-control type. The former WinFormsTextBoxAdapter helper has been removed; use the shared source API.
For sources of at least 128 Ki UTF-16 code units, source change events can coalesce while a background worker prepares the current complete text. Subscribe to HtmlChanged for updates; do not assume one immediate notification per keystroke in large documents.
Deploy the complete NuGet or publish output, including the native source-editor runtime files. The package build targets copy these files for the selected platform. Native source initialization occurs on first source entry, so a missing native dependency leaves visual editing available and reports a failed mode switch.
Supported Frameworks
| Framework | Status |
|---|---|
| .NET Framework 4.5 | Supported |
| .NET Framework 4.7.2 | Supported |
| .NET Framework 4.8 | Supported |
| .NET 5 (Windows) | Supported |
| .NET 6 (Windows) | Supported |
| .NET 7 (Windows) | Supported |
| .NET 8 (Windows) | Supported |
| .NET 9 (Windows) | Supported |
| .NET 10 (Windows) | Supported |
Documentation
For full documentation, samples, and API reference, visit: https://spicelogic.com/docs/WinHTMLEditorControl
Product page (pricing, screenshots, change log): https://spicelogic.com/Products/NET-WinForms-HTML-Editor-Control-8
AI assistant integration (MCP server)
SpiceLogic publishes an official Model Context Protocol server for this control. Claude Code, GitHub Copilot, Cursor, OpenAI Codex, Google Antigravity, and many other MCP-compatible AI coding tools can use it to look up real method signatures, documentation pages, and current samples instead of guessing from stale training data.
Give this short prompt to your AI coding tool:
Add the MCP server at https://mcp.spicelogic.com/html-editor/winforms. Then create a
small WinForms app, install SpiceLogic.HtmlEditor.WinForms, add the HTML editor to
the main form, load a heading and a short bulleted list, add a button that inserts
today's date, build it, and run it.
The endpoint is scoped to WinForms, so a WinForms question cannot be answered with the WPF API. See the WinForms MCP server guide for tested setup instructions for each major client, including Google Antigravity's required serverUrl configuration.
License
Commercial license with 14-day free trial. View EULA - SpiceLogic Inc.
Support
- Website: spicelogic.com
- Email: support@spicelogic.com
Third-party notices
The source editor uses Scintilla.NET and the Scintilla and Lexilla native libraries. Their licenses apply to those components, independently of the SpiceLogic license.
Scintilla and Lexilla
Source: https://www.scintilla.org/License.txt
Copyright 1998-2021 by Neil Hodgson neilh@scintilla.org
All rights reserved.
Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation.
Neil Hodgson disclaims all warranties with regard to this software, including all implied warranties of merchantability and fitness, in no event shall Neil Hodgson be liable for any special, indirect or consequential damages or any damages whatsoever resulting from loss of use, data or profits, whether in an action of contract, negligence or other tortious action, arising out of or in connection with the use or performance of this software.
Scintilla.NET
Source: https://github.com/desjarlais/Scintilla.NET/blob/6ce2f2db095a9e5f9b0c3d4601f8df4af51c117c/LICENSE
The MIT license (MIT)
Copyright (c) 2017, Jacob Slusser, https://github.com/jacobslusser Copyright (c) 2020-2022 VPKSoft Copyright (c) 2023 desjarlais Additional package attribution: Jacob Slusser 2018, VPKSoft, cyber960 2022, desjarlais 2023, Ahmet Sait 2025.
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
The software is provided "as is", without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose and noninfringement. In no event shall the authors or copyright holders be liable for any claim, damages or other liability, whether in an action of contract, tort or otherwise, arising from, out of or in connection with the software or the use or other dealings in the software.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net5.0-windows7.0 is compatible. net6.0-windows was computed. net6.0-windows7.0 is compatible. net7.0-windows was computed. net7.0-windows7.0 is compatible. net8.0-windows was computed. net8.0-windows7.0 is compatible. net9.0-windows was computed. net9.0-windows7.0 is compatible. net10.0-windows was computed. net10.0-windows7.0 is compatible. |
| .NET Framework | net45 is compatible. net451 was computed. net452 was computed. net46 was computed. net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 is compatible. net48 is compatible. net481 was computed. |
-
.NETFramework 4.5
- Scintilla5.NET (>= 5.3.3.18)
- System.ValueTuple (>= 4.5.0)
- Unofficial.Microsoft.mshtml.NetStandard (>= 7.0.3300.2)
-
.NETFramework 4.7.2
- Scintilla5.NET (>= 7.0.0)
- System.Memory (>= 4.5.5)
- System.Resources.Extensions (>= 4.6.0)
- System.Runtime.CompilerServices.Unsafe (>= 6.1.2)
- System.ValueTuple (>= 4.5.0)
- Unofficial.Microsoft.mshtml.NetStandard (>= 7.0.3300.2)
-
.NETFramework 4.8
- Scintilla5.NET (>= 7.0.0)
- System.Memory (>= 4.5.5)
- System.Resources.Extensions (>= 4.6.0)
- System.Runtime.CompilerServices.Unsafe (>= 6.1.2)
- System.ValueTuple (>= 4.5.0)
- Unofficial.Microsoft.mshtml.NetStandard (>= 7.0.3300.2)
-
net10.0-windows7.0
- Scintilla5.NET (>= 7.0.0)
- Unofficial.Microsoft.mshtml.NetStandard (>= 7.0.3300.2)
-
net5.0-windows7.0
- Scintilla.NET (>= 5.3.2.9)
- Unofficial.Microsoft.mshtml.NetStandard (>= 7.0.3300.2)
-
net6.0-windows7.0
- Scintilla5.NET (>= 5.3.3.18)
- Unofficial.Microsoft.mshtml.NetStandard (>= 7.0.3300.2)
-
net7.0-windows7.0
- Scintilla5.NET (>= 5.3.3.18)
- Unofficial.Microsoft.mshtml.NetStandard (>= 7.0.3300.2)
-
net8.0-windows7.0
- Scintilla5.NET (>= 7.0.0)
- Unofficial.Microsoft.mshtml.NetStandard (>= 7.0.3300.2)
-
net9.0-windows7.0
- Scintilla5.NET (>= 7.0.0)
- Unofficial.Microsoft.mshtml.NetStandard (>= 7.0.3300.2)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 10.0.2 | 0 | 9/18/2026 |
| 10.0.1 | 37 | 9/17/2026 |
| 10.0.0 | 81 | 9/15/2026 |
| 9.7.7 | 186 | 8/26/2026 |
| 9.7.6 | 100 | 8/26/2026 |
| 9.7.5 | 105 | 8/26/2026 |
| 9.7.4 | 90 | 8/26/2026 |
| 9.7.3 | 99 | 8/26/2026 |
| 9.7.2 | 104 | 8/25/2026 |
| 9.7.1 | 112 | 8/21/2026 |
| 9.7.0 | 107 | 8/21/2026 |
| 9.6.1 | 135 | 8/21/2026 |
| 9.6.0 | 204 | 8/13/2026 |
| 9.5.7 | 102 | 8/11/2026 |
| 9.5.6 | 123 | 8/11/2026 |
| 9.5.5 | 96 | 8/11/2026 |
| 9.5.4 | 105 | 8/10/2026 |
| 9.5.3 | 120 | 8/9/2026 |
| 9.5.2 | 125 | 8/2/2026 |
| 9.5.1 | 116 | 8/2/2026 |
Modern HTML source editing with syntax highlighting, line numbers, indentation and synchronized selection. Large sources prepare in the background with a bounded viewport. Major-version upgrade: recompile integrations that use GetTheRawHtmlTextEditor and migrate TextBox-specific code to HtmlSourceEditor. See the package README for migration details. ALM feature #660.