# Deprecated APIs

> Obsolete engine and mail merge members a WPF app can still call, with their replacements: TextAfterNumber, TextField.HighlightMode, LoadEmbeddedData and Merge.

- **Product:** TX Text Control .NET for WPF
- **Section:** Documentation
- **Kind:** Topic
- **Path:** TX Text Control .NET for WPF > What's New > Deprecated APIs
- **1163 words**
- **Web URL:** https://docs.textcontrol.com/tx-text-control-dotnet-wpf/whats-new/deprecated-apis/
- **LLMs URL:** https://docs.textcontrol.com/tx-text-control-dotnet-wpf/whats-new/deprecated-apis/llms.txt
- **LLMs-Full URL:** https://docs.textcontrol.com/tx-text-control-dotnet-wpf/whats-new/deprecated-apis/llms-full.txt

---

Code written for an older version of TX Text Control .NET for WPF can still call members that the reference now marks obsolete. They remain part of the API, but Text Control will remove them in a future version, so replace them before an upgrade or whenever you work on the code that uses them. Each obsolete member below is listed with the member that takes over its job.

### What Obsolete Means

- **Still available.** An obsolete member is still in the API and in the reference. Its reference page says that it will be removed in a future version, or that it is only available for compatibility. No source names the version that removes it.
- **Marked in the reference.** The description of an obsolete member starts with "Obsolete".
- **Not for new code.** Use the replacement in new code, and change existing code when you work on it.
- **Only shared members.** Every obsolete member belongs to the document engine and mail merge, which TX Text Control .NET for WPF shares with the other .NET products. No member of the `TXTextControl.WPF` namespace, such as the `TextControl`, the ribbon tabs, the button bar, the ruler bar or the status bar, is marked obsolete.
- **One removal since 30.0.** Version 33.0 removed the `SerializationFormat` overloads of the WPF barcode control's `Load` and `Save` methods without marking them obsolete first. [Breaking Changes](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/whats-new/breaking-changes/llms-full.txt) describes the change.

### Obsolete Members

| Obsolete | Use instead | Obsolete since |
|---|---|---|
| [ListFormat.CharAfterNumber](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol/listformat/charafternumber-property/llms-full.txt) | [ListFormat.TextAfterNumber](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol/listformat/textafternumber-property/llms-full.txt) | 15.0 |
| [ListFormat.CharBeforeNumber](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol/listformat/charbeforenumber-property/llms-full.txt) | [ListFormat.TextBeforeNumber](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol/listformat/textbeforenumber-property/llms-full.txt) | 15.0 |
| The values `CharAfterNumber` and `CharBeforeNumber` of [ListFormat.Attribute](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol/listformat/attribute-enumeration/llms-full.txt) | The values `TextAfterNumber` and `TextBeforeNumber` | Not stated |
| [TextField.ShowActivated](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol/textfield/showactivated-property/llms-full.txt) | [TextField.HighlightMode](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol/textfield/highlightmode-property/llms-full.txt) and [TextField.HighlightColor](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol/textfield/highlightcolor-property/llms-full.txt) | Not stated |
| The value `GenerateXML` of [PDFImportSettings](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol/pdfimportsettings/enumeration/llms-full.txt) | The value `LoadEmbeddedData` | Not stated |
| [MailMerge.MergeBlocks](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol-documentserver/mailmerge/mergeblocks-method/llms-full.txt) | [MailMerge.Merge](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol-documentserver/mailmerge/merge-method/llms-full.txt) | 20.0 |

### What Changes With Each Replacement

- **Numbered lists.** `CharAfterNumber` and `CharBeforeNumber` hold a single character behind or in front of the number of a list item. `TextAfterNumber` and `TextBeforeNumber`, introduced in version 15.0, hold a string, so the text around the number can be longer than one character. [Bullets and Numbered Lists](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/document-editor/lists/llms-full.txt) shows how lists are formatted.
- **Highlighted text fields.** `ShowActivated` turned the background of a text field gray while the input position was in the field. `HighlightMode` sets when a field is highlighted, and `HighlightColor` sets the color of the highlight. [Fields, Hyperlinks, and Bookmarks](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/document-editor/fields/llms-full.txt) describes the fields of a document.
- **PDF import.** `PDFImportSettings` values are passed with [LoadSettings.PDFImportSettings](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol/loadsettings/pdfimportsettings-property/llms-full.txt) when a PDF document is loaded. With `LoadEmbeddedData`, [LoadSettings.EmbeddedData](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/reference/txtextcontrol/loadsettings/embeddeddata-property/llms-full.txt) provides the metadata, the form fields and the text coordinates of the document after loading. See [PDF Import and Its Limitations](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/pdf/import/llms-full.txt).
- **Merge blocks.** Since version 20.0, `Merge` processes the merge blocks of a template, sections that are repeated for each record, from the related tables of a data set. `MergeBlocks` needed an additional merge block around the whole document for the same result. The reference page of `MergeBlocks` doesn't mark it obsolete; the What's New documentation of version 20.0 does. [Merge Blocks](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/mail-merge/blocks/llms-full.txt) explains the blocks and their data.

### When You Upgrade

Obsolete members keep working in version 34.0, so they don't block an upgrade. The changes that do require work are listed on [Breaking Changes](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/whats-new/breaking-changes/llms-full.txt).

### Related Pages

- [Breaking Changes](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/whats-new/breaking-changes/llms-full.txt): the changes of each version that can require work when you upgrade.
- [Service Packs](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/whats-new/service-packs/llms-full.txt): what changed between the major versions.
- [Upgrading from Previous Versions](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/installation/upgrading/previous-versions/llms-full.txt): the steps to move a project to version 34.0.

---

## Nearby

- **Previous:** [Breaking Changes](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/whats-new/breaking-changes/llms-full.txt)
- **Next:** [Older Versions](https://docs.textcontrol.com/tx-text-control-dotnet-wpf/whats-new/older-versions/llms-full.txt)
