PdfText Class

Namespace:
GemBox.Pdf.Content
Assembly:
GemBox.Pdf.dll

Represents a snapshot mapping from a sequence of Unicode characters to a sequence of complete, partial or none PdfContentElements and provides various text related functionalities.

public sealed class PdfText
Public NotInheritable Class PdfText
Inheritance:
PdfText
Remarks

The PdfText is a snapshot and if the underlying PDF content is changed, that change won't be visible in the PdfText, instead PdfText should be retrieved again to get the actual snapshot.

Properties

Bounds

Gets the bounds of the PdfText.

public PdfQuad Bounds { get; }
Public ReadOnly Property Bounds As PdfQuad
Property Value
PdfQuad

The bounds of the PdfText.

Length

Gets the number of Unicode characters in the current PdfText object.

public int Length { get; }
Public ReadOnly Property Length As Integer
Property Value
Int32

The number of Unicode characters in the current PdfText object.

Methods

Find(String, StringComparison)

Finds all occurrences of the specified text in this PdfText instance.

public IEnumerable<PdfText> Find(string text, StringComparison comparisonType = StringComparison.InvariantCulture)
Public Function Find(text As String, comparisonType As StringComparison = StringComparison.InvariantCulture) As IEnumerable(Of PdfText)
Parameters
text
String

The searched text.

comparisonType
StringComparison

One of the enumeration values that specifies the rules for the search.

Returns
IEnumerable<PdfText>

All occurrences of the specified text in this PdfText instance.

Exceptions
ArgumentNullException

text is null.

Find(Regex)

Finds all matches of the specified regular expression in this PdfText instance.

public IEnumerable<PdfText> Find(Regex regex)
Public Function Find(regex As Regex) As IEnumerable(Of PdfText)
Parameters
regex
Regex

The regular expression used to find the matches.

Returns
IEnumerable<PdfText>

All matches of the specified regular expression in this PdfText instance.

Exceptions
ArgumentNullException

regex is null.

Highlight()

Highlights the PDF content associated with the current PdfText.

public PdfContentFormat Highlight()
Public Function Highlight As PdfContentFormat
Returns
PdfContentFormat

The PdfContentFormat used to customize the highlight.

Redact()

Removes the PDF content associated with the current PdfText.

public void Redact()
Public Sub Redact

Subtext(Int32)

Retrieves a subtext from this instance. The subtext starts at a specified character position and continues to the end of the text.

public PdfText Subtext(int startIndex)
Public Function Subtext(startIndex As Integer) As PdfText
Parameters
startIndex
Int32

The zero-based starting character position of a subtext in this instance.

Returns
PdfText

A PdfText that is equivalent to the subtext that begins at startIndex in this instance.

Exceptions
ArgumentOutOfRangeException

startIndex is less than zero or greater than the length of this instance.

Subtext(Int32, Int32)

Retrieves a subtext from this instance. The subtext starts at a specified character position and has a specified length.

public PdfText Subtext(int startIndex, int length)
Public Function Subtext(startIndex As Integer, length As Integer) As PdfText
Parameters
startIndex
Int32

The zero-based starting character position of a subtext in this instance.

length
Int32

The number of characters in the subtext.

Returns
PdfText

A PdfText that is equivalent to the subtext of length length that begins at startIndex in this instance.

Exceptions
ArgumentOutOfRangeException

startIndex plus length indicates a position not within this instance or startIndex or length is less than zero.

ToString()

Returns a Unicode text contained in this PdfText.

public override string ToString()
Public Overrides Function ToString As String
Returns
String

A Unicode text contained in this PdfText.

Overrides

See Also