Recursive Property

Indicates whether to cycle through the text and pages till a match is found or the original location is reached.

Syntax

C#
Visual Basic
Objective-C
Java
C++

public bool Recursive {get; set;}

'Declaration

Public Property Recursive As Boolean

'Usage

Dim instance As DocumentViewerFindText
Dim value As Boolean
 
instance.Recursive = value
 
value = instance.Recursive

public:
property bool Recursive {
   bool get();
   void set (    bool value);
}

Property Value

true to cycle through the text and pages till a match is found or the original location is reached; otherwise, false. Default value is false.

Remarks

When Recursive is false (the default), then a find next operation will search from current location saved in this DocumentViewerFindText till the end of the page (or if GotoNextPage is true, last page in the document) before it stops trying to find a match. Similarly, a find previous operation will search from current location till beginning of the page (or first page in the document).

When Recursive is true, then find next operation will continue past the end of the page (or document) by going back to the page beginning (or first page) till the whole page or document is exhausted. Similarly with find previous cycling through the page or the document backward.

DocumentViewerFindText saves the location of the last match found internally to prevent infinite recursion and will never go past the last found location.

Example

For an example, refer to Find.

Requirements

Target Platforms

Reference

DocumentViewerFindText Class
DocumentViewerFindText Members