Share via


IncrementalSearch.SearchForward Method

Searches for the current pattern from the current position to the end of the document.

Namespace:  EnvDTE80
Assembly:  EnvDTE80 (in EnvDTE80.dll)

Syntax

'Declaration
Function SearchForward As vsIncrementalSearchResult
vsIncrementalSearchResult SearchForward()
vsIncrementalSearchResult SearchForward()
abstract SearchForward : unit -> vsIncrementalSearchResult
function SearchForward() : vsIncrementalSearchResult

Return Value

Type: EnvDTE80.vsIncrementalSearchResult
A vsIncrementalSearchResult enumeration.

Remarks

SearchForward searches forward regardless of the previous direction of the search. It does not modify the pattern.

If a match is found, the editor selection is moved to the new location. The selection is not moved if the search fails.

If the search pattern is empty, SearchForward simply sets the direction of the search.

Examples

Sub testIS2()
    ' Before running, open a document in Visual Studio.
    ' Set variables for text pane.
    Dim tp As EnvDTE80.TextPane2
    tp = CType(DTE.ActiveDocument.ActiveWindow.Object.ActivePane, _
    TextPane2)
    ' Start an incremental search backward from
    ' the current insertion point in the document.
    tp.IncrementalSearch.StartBackward()
    ' Add the character "a" to the search pattern.
    tp.IncrementalSearch.AppendCharAndSearch(Asc("a"))
    ' Display the parent name for IncrementalSearch object.
    MsgBox("IncrementalSearch parent: " & _
    tp.IncrementalSearch.DTE.FullName)
    MsgBox("Search pattern length: " & _
    tp.IncrementalSearch.Pattern.Length)
    ' Perform incremental search using the pattern ("a").
    tp.IncrementalSearch.SearchWithLastPattern()
    ' After the search, exit incremental search mode.
    MsgBox("DeleteCharAndBackup")
    tp.IncrementalSearch.DeleteCharAndBackup()
    MsgBox("SearchForward")
    tp.IncrementalSearch.SearchForward()
    MsgBox("SearchBackward")
    tp.IncrementalSearch.SearchBackward()
    MsgBox("Exit")
    tp.IncrementalSearch.Exit()
End Sub

.NET Framework Security

See Also

Reference

IncrementalSearch Interface

EnvDTE80 Namespace

Other Resources

How to: Search for Text Incrementally

How to: Search a Document Incrementally