ProcessText Event

In This Topic

This event is called whenever text is printed. Use it for preprocessing, e.g. hyphenation.

Syntax

Visual Basic
C#
C++/CLI

'Declaration
 
Public Event ProcessText As EventHandler(Of ProcessTextEventArgs)

public event EventHandler<ProcessTextEventArgs> ProcessText

public:
event EventHandler<ProcessTextEventArgs^>^ ProcessText

Event Data

The event handler receives an argument of type ProcessTextEventArgs containing data related to this event. The following ProcessTextEventArgs properties provide information specific to this event.

Property	Description
ObjectName	The name of the object currently printing.
ObjectSubType	The subtype of the object e.g. for extension objects.
ObjectType	The type of the object.
Text	The actual text that may be modified.
TextType	The text type.

Example

The following sample shows the use of hyphenation with the external component NHunspell which exists as NuGet package.

C#
VB.NET

NHunspell.Hyphen _hyphen = new NHunspell.Hyphen(@"c:\users\public\hyph_en_us.dic");
char _conditionalSeperator = (char)173;

private void LL_ProcessText(object sender, ProcessTextEventArgs e)
{
    NHunspell.HyphenResult hyphenated = _hyphen.Hyphenate(e.Text);
   
    if (hyphenated != null)
        e.Text = hyphenated.HyphenatedWord.Replace('=', _conditionalSeperator);
}

Private _hyphen As NHunspell.Hyphen = New NHunspell.Hyphen("c:\users\public\hyph_en_us.dic")
Private _conditionalSeperator As Char = ChrW(173)

Private Sub LL_ProcessText(ByVal sender As Object, ByVal e As ProcessTextEventArgs)

    Dim hyphenated As NHunspell.HyphenResult = _hyphen.Hyphenate(e.Text)

    If hyphenated IsNot Nothing Then
        e.Text = hyphenated.HyphenatedWord.Replace("="c, _conditionalSeperator)
    
End Sub

Requirements

Platforms: Windows 10 (Version 21H2 - 22H2), Windows 11 (22H2 - 25H2), Windows Server 2016 - 2025
.NET: .NET Framework 4.8, .NET 8, .NET 9, .NET 10

Reference

ListLabel Class
ListLabel Members

Send Feedback