IVsFindScope Interface

Defines a custom scope that can be chosen in the Find in Files, Look in combo box.

Namespace:  Microsoft.VisualStudio.TextManager.Interop
Assembly:  Microsoft.VisualStudio.TextManager.Interop (in Microsoft.VisualStudio.TextManager.Interop.dll)

Syntax

声明
<GuidAttribute("0FE9496A-129C-40EE-99D8-7705A6283518")> _
<InterfaceTypeAttribute()> _
Public Interface IVsFindScope
[GuidAttribute("0FE9496A-129C-40EE-99D8-7705A6283518")]
[InterfaceTypeAttribute()]
public interface IVsFindScope
[GuidAttribute(L"0FE9496A-129C-40EE-99D8-7705A6283518")]
[InterfaceTypeAttribute()]
public interface class IVsFindScope
[<GuidAttribute("0FE9496A-129C-40EE-99D8-7705A6283518")>]
[<InterfaceTypeAttribute()>]
type IVsFindScope =  interface end
public interface IVsFindScope

The IVsFindScope type exposes the following members.

Methods

  Name Description
Public method EnumFilenames Enumerate filenames (full path only).
Public method GetQuery Returns a query string
Public method GetUIName Returns the name displayed in Find UI

Top

Remarks

Implemented by packages that want to extend the scopes available for Find in Files. Your custom scope must be registered with the environment using the shell's IVsRegisterFindScope service. A scope can be either a simple find-in-files query string or a filename enumerator. A query string is what the user can type in the 'Look in' combo:

  • It takes the form of a semicolon-delimited list of folders and filenames.

  • Individual items on the list may be quoted.

  • The 'Look in subfolders' check box applies to the query.

  • The filters selected in the 'File types' combo box apply to the query.

There is no mechanism to override the user's subfolders selection. If you need greater control over recursive file enumeration, you must provide a filename enumerator.

To execute a Find, the Find manager asks first for a query string, and if that fails, it asks for a string enumerator that is expected to return a sequence of filenames. A scope should implement GetQuery or EnumFilenames; never both. The user's 'File types' extension filters are applied to all types of scopes.

See Also

Reference

Microsoft.VisualStudio.TextManager.Interop Namespace