---
product: Chilkat
product_version: 11.7.0
language: delphidll
language_label: Delphi DLL
class: HtmlToText
license: bundle
deprecated: false
reference_html: https://www.chilkatsoft.com/refdoc/dd_CkHtmlToTextRef.html
---
# Chilkat HtmlToText — Delphi DLL — v11.7.0

> Chilkat 11.7.0 · language=delphidll · class=HtmlToText
> Other versions: replace `11.7.0` in this URL. Other languages: `https://www.chilkatsoft.com/ai-docs/v/11.7.0/<lang>/classes/HtmlToText.md`.
> Language-wide rules (install, unlock, error model, strings/bytes): `https://www.chilkatsoft.com/ai-docs/v/11.7.0/delphidll/guide.md`.

## Purpose

**Convert HTML into readable plain text with control over links, wrapping, and encoding.**

`Chilkat.HtmlToText` converts HTML content into readable plain text. It can decode HTML entities, wrap output at a configurable right margin, optionally include or suppress hyperlink URLs, convert HTML supplied as a string or `StringBuilder`, and read or write files using an explicit character encoding.

**HTML to plain text**

Convert HTML markup into readable text suitable for display, logging, indexing, email alternatives, or text-only output.

**Entity decoding**

Decode HTML entities so text such as named entities and numeric character references becomes normal readable output.

**Line wrapping**

Use `RightMargin` to wrap text at a chosen width, or set it to `0` when no right-margin wrapping is wanted.

**Link handling**

Suppress hyperlink URLs for cleaner text, or emit URLs when the output needs to preserve the destination of HTML links.

**StringBuilder support**

Convert HTML directly from a `StringBuilder` when working with larger or incrementally built HTML content.

**File and charset helpers**

Read HTML from files and write text output using a specified character encoding.

**Common pattern:** Provide the HTML as a string, file, or `StringBuilder`, choose whether to decode entities and include link URLs, set the desired right margin, then convert the result to plain text. Use `HtmlToText` when the goal is readable text, not structured XML or DOM-style parsing.

For an extended overview, see [HtmlToText Class Overview](https://www.chilkatsoft.com/htmltotext_class_overview.asp).

## Object creation, unlocking and error handling

**Create/Dispose**

```pascal
var
myObject: HCkHtmlToText;

begin
myObject := CkHtmlToText_Create();

// ...

CkHtmlToText_Dispose(myObject);
end;
```

`function CkHtmlToText_Create: HCkHtmlToText; stdcall;`

Creates an instance of the HCkHtmlToText object and returns a handle (i.e. a Pointer). The handle is passed in the 1st argument for the functions listed on this page.

`procedure CkHtmlToText_Dispose(handle: HCkHtmlToText); stdcall;`

Objects created by calling CkHtmlToText_Create must be freed by calling this method. A memory leak occurs if a handle is not disposed by calling this function.

Call `Global.UnlockBundle` once at the start of the program, before using this or any other Chilkat class. Any string unlocks a fully functional 30-day trial; a purchased unlock code is used in production. See `guide.md` for the exact code in Delphi DLL.

## Members common to every Chilkat class

Documented once per language in `common-members.md`; listed here so this page is self-contained.

| Property | Signature | Access | Meaning |
|---|---|---|---|
| `DebugLogFilePath` | `procedure CkHtmlToText_getDebugLogFilePath(objHandle: HCkHtmlToText; outPropVal: HCkString); stdcall; procedure CkHtmlToText_putDebugLogFilePath(objHandle: HCkHtmlToText; newPropVal: PWideChar); stdcall; function CkHtmlToText__debugLogFilePath(objHandle: HCkHtmlToText): PWideChar; stdcall;` | read/write | If set to a file path, this property logs the LastErrorText of each Chilkat method or property call to the specified file. |
| `LastErrorHtml` | `procedure CkHtmlToText_getLastErrorHtml(objHandle: HCkHtmlToText; outPropVal: HCkString); stdcall; function CkHtmlToText__lastErrorHtml(objHandle: HCkHtmlToText): PWideChar; stdcall;` | read-only | Provides HTML-formatted information about the last called method or property. |
| `LastErrorText` | `procedure CkHtmlToText_getLastErrorText(objHandle: HCkHtmlToText; outPropVal: HCkString); stdcall; function CkHtmlToText__lastErrorText(objHandle: HCkHtmlToText): PWideChar; stdcall;` | read-only | Provides plain text information about the last called method or property. |
| `LastErrorXml` | `procedure CkHtmlToText_getLastErrorXml(objHandle: HCkHtmlToText; outPropVal: HCkString); stdcall; function CkHtmlToText__lastErrorXml(objHandle: HCkHtmlToText): PWideChar; stdcall;` | read-only | Provides XML-formatted information about the last called method or property. |
| `LastMethodSuccess` | `function CkHtmlToText_getLastMethodSuccess(objHandle: HCkHtmlToText): wordbool; stdcall; procedure CkHtmlToText_putLastMethodSuccess(objHandle: HCkHtmlToText; newPropVal: wordbool); stdcall;` | read/write | Indicates the success or failure of the most recent method call: `True` means success, `False` means failure. |
| `VerboseLogging` | `function CkHtmlToText_getVerboseLogging(objHandle: HCkHtmlToText): wordbool; stdcall; procedure CkHtmlToText_putVerboseLogging(objHandle: HCkHtmlToText; newPropVal: wordbool); stdcall;` | read/write | If set to `True`, then the contents of LastErrorText (or LastErrorXml, or LastErrorHtml) may contain more verbose information. |
| `Version` | `procedure CkHtmlToText_getVersion(objHandle: HCkHtmlToText; outPropVal: HCkString); stdcall; function CkHtmlToText__version(objHandle: HCkHtmlToText): PWideChar; stdcall;` | read-only | Version of the component/library, such as "10.1.0" |

## Member index

| Member | Kind | Signature |
|---|---|---|
| `DecodeHtmlEntities` | property, read/write | `function CkHtmlToText_getDecodeHtmlEntities(objHandle: HCkHtmlToText): wordbool; stdcall; procedure CkHtmlToText_putDecodeHtmlEntities(objHandle: HCkHtmlToText; newPropVal: wordbool); stdcall;` |
| `RightMargin` | property, read/write | `function CkHtmlToText_getRightMargin(objHandle: HCkHtmlToText): Integer; stdcall; procedure CkHtmlToText_putRightMargin(objHandle: HCkHtmlToText; newPropVal: Integer); stdcall;` |
| `SuppressLinks` | property, read/write | `function CkHtmlToText_getSuppressLinks(objHandle: HCkHtmlToText): wordbool; stdcall; procedure CkHtmlToText_putSuppressLinks(objHandle: HCkHtmlToText; newPropVal: wordbool); stdcall;` |
| `UncommonOptions` | property, read/write | `procedure CkHtmlToText_getUncommonOptions(objHandle: HCkHtmlToText; outPropVal: HCkString); stdcall; procedure CkHtmlToText_putUncommonOptions(objHandle: HCkHtmlToText; newPropVal: PWideChar); stdcall; function CkHtmlToText__uncommonOptions(objHandle: HCkHtmlToText): PWideChar; stdcall;` |
| `ToText` | method | `function CkHtmlToText_ToText(objHandle: HCkHtmlToText;     html: PWideChar;     outStr: HCkString): wordbool; stdcall; function CkHtmlToText__toText(objHandle: HCkHtmlToText;     html: PWideChar): PWideChar; stdcall;` |
| `ToTextSb` | method | `function CkHtmlToText_ToTextSb(objHandle: HCkHtmlToText;     sb: HCkStringBuilder): wordbool; stdcall;` |

Deprecated members are listed at the end of this file with their replacements; do not use them in new code.

## Properties

### HtmlToText.DecodeHtmlEntities

`Chilkat 11.7.0 · delphidll · HtmlToText · DecodeHtmlEntities · property · read/write`

```pascal
function CkHtmlToText_getDecodeHtmlEntities(objHandle: HCkHtmlToText): wordbool; stdcall;
procedure CkHtmlToText_putDecodeHtmlEntities(objHandle: HCkHtmlToText; newPropVal: wordbool); stdcall;
```

Controls whether HTML character references are decoded when converting HTML to plain text. The default value is `True`.

| Value | Behavior |
| :--- | :--- |
| `True` | HTML entities and numeric character references are decoded to their corresponding characters. For example, `&amp;` becomes `&`. |
| `False` | Character references are left encoded in the plain-text output. |

**Typical use:** Leave this property set to `True` when the goal is human-readable text. Set it to `False` when the original entity notation itself must be preserved.

### HtmlToText.RightMargin

`Chilkat 11.7.0 · delphidll · HtmlToText · RightMargin · property · read/write`

```pascal
function CkHtmlToText_getRightMargin(objHandle: HCkHtmlToText): Integer; stdcall;
procedure CkHtmlToText_putRightMargin(objHandle: HCkHtmlToText; newPropVal: Integer); stdcall;
```

Controls line wrapping in the generated plain text. The default value is `80`. As a line approaches the configured margin, Chilkat attempts to wrap at a SPACE character. Set this property to `0` to disable right-margin wrapping.

**Soft margin:** The right margin is a preferred wrapping point, not a guaranteed maximum line length. A long sequence with no suitable SPACE character may extend beyond the configured margin.

### HtmlToText.SuppressLinks

`Chilkat 11.7.0 · delphidll · HtmlToText · SuppressLinks · property · read/write`

```pascal
function CkHtmlToText_getSuppressLinks(objHandle: HCkHtmlToText): wordbool; stdcall;
procedure CkHtmlToText_putSuppressLinks(objHandle: HCkHtmlToText; newPropVal: wordbool); stdcall;
```

Controls whether hyperlink destination URLs are included in the generated plain text. The default value is `True`.

| Value | Behavior |
| :--- | :--- |
| `True` | The visible anchor text is retained, but hyperlink destination URLs are omitted. |
| `False` | Hyperlink URLs are included. By default, they are collected in a `References:` section at the end of the plain text. |

For example, with `SuppressLinks` set to `False`, an HTML link whose visible text is `chilkat` and whose URL is `https://www.chilkatsoft.com/` produces the visible text and a numbered reference at the end of the output.

**Related options:** When link URLs are enabled, `UncommonOptions` can be used to suppress the trailing references list with `NoReferencesList` or emit URLs inline with `EmitUrls`.

### HtmlToText.UncommonOptions

`Chilkat 11.7.0 · delphidll · HtmlToText · UncommonOptions · property · read/write · since 11.0.0`

```pascal
procedure CkHtmlToText_getUncommonOptions(objHandle: HCkHtmlToText; outPropVal: HCkString); stdcall;
procedure CkHtmlToText_putUncommonOptions(objHandle: HCkHtmlToText; newPropVal: PWideChar); stdcall;
function CkHtmlToText__uncommonOptions(objHandle: HCkHtmlToText): PWideChar; stdcall;
```

Specifies uncommon HTML-to-text conversion options as a comma-separated list of keywords. The default is the empty string, which is appropriate for normal use.

| Keyword | Effect |
| :--- | :--- |
| `NoReferencesList` | Does not generate the hyperlink-reference list at the end of the plain-text output. |
| `EmitUrls` | Emits hyperlink URLs inline in the plain-text output instead of relying on the default trailing reference list. |

**Interaction with SuppressLinks:** These options control the presentation of hyperlink URLs when URL output is enabled. If `SuppressLinks` is `True`, hyperlink URLs are suppressed.

## Methods

### HtmlToText.ToText

`Chilkat 11.7.0 · delphidll · HtmlToText · ToText · method`

```pascal
function CkHtmlToText_ToText(objHandle: HCkHtmlToText;
    html: PWideChar;
    outStr: HCkString): wordbool; stdcall;
function CkHtmlToText__toText(objHandle: HCkHtmlToText;
    html: PWideChar): PWideChar; stdcall;
```

**Full documentation for this method (same in every language):** [HTML Tables to Plain Text Conversion Gallery](https://www.chilkatsoft.com/ai-docs/v/11.7.0/articles/html_table_to_text.md)

Converts the HTML in `html` to readable plain text and returns the result. The conversion honors `DecodeHtmlEntities`, `RightMargin`, `SuppressLinks`, and `UncommonOptions`. HTML markup is interpreted to produce readable text rather than simply being removed with a tag-stripping operation.

**Plain-text conversion:** The output is intended for reading, indexing, logging, email text alternatives, and similar text-oriented uses. It is not intended to preserve the original HTML markup or visual layout exactly.

Returns True for success, False for failure.

See the notes about [PWideChar memory ownership and validity](https://www.chilkatsoft.com/delphi_pwidechar.asp).

### HtmlToText.ToTextSb

`Chilkat 11.7.0 · delphidll · HtmlToText · ToTextSb · method · since 9.5.0.97`

```pascal
function CkHtmlToText_ToTextSb(objHandle: HCkHtmlToText;
    sb: HCkStringBuilder): wordbool; stdcall;
```

Converts the HTML currently contained in `sb` to plain text in place. On success, the same `StringBuilder` contains the converted plain-text result. The conversion honors `DecodeHtmlEntities`, `RightMargin`, `SuppressLinks`, and `UncommonOptions`.

**StringBuilder workflow:** Use this method when the HTML is already held in a `StringBuilder` and you want the conversion result returned through that same object rather than as a separate string.

Returns True for success, False for failure.

## Deprecated members — do not use in new code

| Member | Kind | Deprecated in | Use instead |
|---|---|---|---|
| `ReadFileToString` | method | before 11.6.1 | — |
| `WriteStringToFile` | method | before 11.6.1 | — |

## Related classes

[`StringBuilder`](https://www.chilkatsoft.com/ai-docs/v/11.7.0/delphidll/classes/StringBuilder.md)

