IVsFindTarget.GetCapabilities Method

Article
11/19/2013

Specifies your supported capabilities.

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

Syntax

'Declaration
Function GetCapabilities ( _
    <OutAttribute> pfImage As Boolean(), _
    <OutAttribute> pgrfOptions As UInteger() _
) As Integer

int GetCapabilities(
    bool[] pfImage,
    uint[] pgrfOptions
)

int GetCapabilities(
    [OutAttribute] array<bool>^ pfImage, 
    [OutAttribute] array<unsigned int>^ pgrfOptions
)

abstract GetCapabilities : 
        pfImage:bool[] byref * 
        pgrfOptions:uint32[] byref -> int

function GetCapabilities(
    pfImage : boolean[], 
    pgrfOptions : uint[]
) : int

Parameters

pfImage
Type: array<System.Boolean[]

[out] Set to true if you support GetSearchImage.

pgrfOptions
Type: array<System.UInt32[]

[out] Specifies supported options, syntax, and actions. Values are taken from the __VSFINDOPTIONS enumeration.

Return Value

Type: System.Int32
If the method succeeds, it returns S_OK. If it fails, it returns an error code.

Remarks

COM Signature

From textmgr.idl:

HRESULT IVsFindTarget::GetCapabilities(
   [out, custom(DE89D360-C06A-11d2-936C-D714766E8B50,"optional")] BOOL * pfImage
);

You must explicitly set all options, syntax, and actions that are supported.

To force Find in Selection on, return both FR_Selection and FR_SelectionDefault. FR_SelectionDefault should be set for large or line-spanning selections, and not set for small selections.

Targets that do not have the notion of hidden text should always claim support for FR_Hidden and simply ignore the flag if it is passed to other methods. This allows Find in open documents to work uniformly. In other words, Hidden text is an ignorable or "don't care" case for targets that do not have the notion of hidden text, or are unable to support it.

If you claim support for FR_Wildcard or FR_RegExpr, you should implement the same syntax and semantics as the environment. This can be achieved by using IVsFindHelper, or the Visual Studio internal libraries to perform the matching. If you do not support the same syntax, the helper menus on the dialogs won't be usable for your target.

.NET Framework Security

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

Share via