Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

IVsFinder Interface

Finds a text image.

Namespace:  Microsoft.VisualStudio.TextManager.Interop
Assembly:  Microsoft.VisualStudio.TextManager.Interop (in Microsoft.VisualStudio.TextManager.Interop.dll)
[GuidAttribute("D0C79C30-C06A-11D2-936C-D714766E8B50")]
[InterfaceTypeAttribute()]
public interface IVsFinder

The IVsFinder type exposes the following members.

  NameDescription
Public methodAttachTextImageAttaches a text image.
Public methodDetachDetaches a text image.
Public methodFindFinds a text image within a text span.
Public methodGetMatchGets a textspan match.
Public methodGetMatchedSpansGets matched textspans.
Public methodGetStateGets state.
Public methodGetTaggedSpansReturns tagged textspans.
Public methodInitSets the find string.
Public methodSetPositionSets search positions
Public methodSetScopeRestricts search to the span set.
Top

To acquire a text image:

  • QueryInterface a shell's text buffer for an IVsTextImage.

  • Use the text image implementations available through TxFactory.h.

To search an image using the finder:

  • AttachTextImage the image to search.

  • Init with the search pattern and options.

  • SetScope (optional) to limit the search to a subset of the image. This can be a number of non-contiguous regions of the image.

  • SetPosition to set the starting and/or current positions and the wrapped state of search.

  • Find.

The finder has no knowledge of hidden text (FR_Hidden). Searching only non-hidden text must be implemented by setting a span set of the visible regions. "Try match" means to test for a match at the specified position without scanning. To get a match set or a regex tag set after a find, you must pass VSFH_SetMatch. If you do not need a match set or tag set, it is more efficient to NOT pass VSFH_SetMatch.

Notes to Implementers

Implemented by the environment. Instances available through the environment's global service provider.

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.