https://github.com/bradsmith1985/managedtom
Managed wrapper for the Text Object Model (TOM/TOM2).
https://github.com/bradsmith1985/managedtom
itextdocument richedit richtextbox tom windows-forms
Last synced: 8 days ago
JSON representation
Managed wrapper for the Text Object Model (TOM/TOM2).
- Host: GitHub
- URL: https://github.com/bradsmith1985/managedtom
- Owner: BradSmith1985
- License: bsd-3-clause
- Created: 2025-06-03T12:54:53.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-06-03T14:19:08.000Z (10 months ago)
- Last Synced: 2025-06-15T22:18:03.653Z (9 months ago)
- Topics: itextdocument, richedit, richtextbox, tom, windows-forms
- Language: C++
- Homepage: https://www.brad-smith.info/blog/projects/textobjectmodel
- Size: 35.2 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ManagedTOM
*Previously known as **TOM Classes for .NET***
A managed wrapper for the Text Object Model (TOM/TOM2).
## About
**ManagedTOM** is a managed assembly, written in C++/CLI, that provides a set of wrapper classes for the Text Object Model (TOM) interfaces. This allows .NET developers to access the functionality of the native `ITextDocument` interface without the need to use dynamic programming or COM interop. The assembly includes the following classes:
- `TextDocument` (`ITextDocument`)
- `TextRange` (`ITextRange`)
- `TextSelection` (`ITextSelection`)
- `TextFont` (`ITextFont`)
- `TextPara` (`ITextPara`)
- `TextStoryRanges` (`ITextStoryRanges`)
## Why use TOM?
The Text Object Model exposes some additional features when compared to working directly with a `RichTextBox` control in Windows Forms, as well as offering better performance when manipulating documents.
## TOM 2 support
The latest version includes support for TOM 2 (available on Windows 8 and higher). Each of the above classes wraps both the TOM 1 and TOM 2 interfaces (e.g. `ITextDocument` and `ITextDocument2`), and will automatically select the best available version. In addition, TOM 2 adds the following classes:
- `TextStory` (`ITextStory`)
- `TextRow` (`ITextRow`)
- `TextStrings` (`ITextStrings`)
## Also included
- `RichTextBoxEx` – an extended version of the Windows Forms `RichTextBox` control which automatically loads the newest available version of the native RichEdit control (required for advanced functionality).
- `TextExtensions` – provides extension methods for working with ranges using a more familiar syntax, as well as conversion of math text to OMML and MathML.
## Requirements
- .NET Framework 4.8
- Windows Vista or higher
- Visual C++ Redistributable for Visual Studio v14
## Instructions
- If you don't want to build from source, download the binaries for the latest release.
- To use the TOM classes in your code, simply reference the `ManagedTOM2.dll` assembly (x86 or x64) in your project.
- IntelliSense documentation is included, as well as a compiled help (`.chm`) file for easy API reference.
## Frequently Asked Questions
- *What are the requirements for accessing the TOM2 functionality?*
You must obtain the `TextDocument` object from a RICHEDIT50W control. This control ships with Windows 8 and newer, however the Windows Forms `RichTextBox` control will only use RICHEDIT20W by default. Use the included `RichTextBoxEx` control to load the newer version.
- *Why does `TextRange.ToMathML()` throw a `NotSupportedException`?*
This method requires the `TextDocument` object to be obtained from the RICHEDIT60W control included with Microsoft Office.
- *Why is a `BadImageFormatException` thrown when trying to load the assembly?*
The processor architecture of the entry assembly must match that of the `ManagedTOM2.dll` assembly. You can build it for x86 or x64, but I advise against using 'Any CPU' as this could behave differently at run-time.