Método IVsFindTarget.GetCapabilities

Artigo
05/17/2015

Especifica os recursos suportados.

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

Sintaxe

'Declaração
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

Parâmetros

pfImage
Tipo: array<Boolean[]

[out] Definido como true se você oferecer suporte GetSearchImage.

pgrfOptions
Tipo: array<UInt32[]

[out] Especifica as opções com suporte, sintaxe e ações. Valores são obtidas a partir do __VSFINDOPTIONS enumeração.

Valor de retorno

Tipo: Int32
Se o método for bem-sucedido, ele retorna S_OK.Se ele falhar, ele retorna um código de erro.

Comentários

COM assinatura

De textmgr.idl:

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

Você deve definir explicitamente todas as ações que são suportadas, sintaxe e opções.

Para forçar a Localizar na seleção na, retornar ambos FR_Selection e FR_SelectionDefault. FR_SelectionDefaultdeve ser definido para seleções de grandes ou linha de abrangência e não definidas para seleções pequenas.

Os destinos que não possuem a noção de texto oculto sempre devem declarar o suporte para FR_Hidden e simplesmente ignorar o sinalizador se ele é passado para outros métodos. Isso permite que Localizar em abrir documentos para trabalhar de maneira uniforme. Em outras palavras, Hidden o texto é um ignoráveis ou "não importa" caso para que não se destina não possuem a noção de texto oculto ou não oferecem suporte a ela.

Se você solicitar suporte para FR_Wildcard ou FR_RegExpr, você deve implementar a mesma sintaxe e semântica como o ambiente. Isso pode ser conseguido por meio de IVsFindHelper, ou as bibliotecas de Visual Studio internas para executar a correspondência. Se você não tiver suporte para a mesma sintaxe, os menus de auxiliar nas caixas de diálogo não será utilizáveis para o seu destino.

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.

Consulte também

Referência

IVsFindTarget Interface

Namespace Microsoft.VisualStudio.TextManager.Interop

Partilhar via