ParseLinks Method

public IList<DocumentLink> ParseLinks( 
   IList<Regex> linkPatterns
)

'Declaration
 

Public Function ParseLinks( _
   ByVal linkPatterns As IList(Of Regex) _
) As IList(Of DocumentLink)

'Usage
 

Dim instance As DocumentPageText
Dim linkPatterns As IList(Of Regex)
Dim value As IList(Of DocumentLink)
 
value = instance.ParseLinks(linkPatterns)

public List<DocumentLink> parseLinks(List<Pattern> linkPatterns)
            

public:
IList<DocumentLink>^ ParseLinks( 
   IList<Regex^>^ linkPatterns
) 

Parameters

linkPatterns

A list of Regex objects to use for parsing the links.

Return Value

If the value of DocumentText.AutoParseLinks is true, then the document will call ParseLinks for each page after the first time the text is obtained using DocumentPage.GetText.

The value of DocumentText.LinkPatterns is used as the parameter of linkPatterns. The result links (if any) will be merged with any existing links found in the page (for example, internal page links parsed through DocumentStructure or user defined-links and can be accessed through DocumentPage.GetLinks.

This method will run the regular expressions passed and adds any matches found as a value of type DocumentLink with DocumentLink.LinkType equals to DocumentLinkType.Value, DocumentLink.Value set to the matching text, and DocumentLink.Bounds set to the bounding rectangle of the match in page units.

If more than one match occurs for a regular expression, then this method will use the match that has the longest length. For example, if the text contains the string mailto:name@domain.com, and the regular expression list found a match for the whole string (from a URL regular expression matcher) and the email part only (from an email regular expression matcher), then the first match is used since it contains a longer value and the second one is discarded.

Refer to AutoParseLinks for more information.

Target Platforms

Reference

DocumentPageText Class
DocumentPageText Members