Método IVsExpansion.InsertNamedExpansion

Artigo
05/17/2015

Insere o trecho de código com o nome especificado na posição especificada no buffer de texto.

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

Sintaxe

'Declaração
Function InsertNamedExpansion ( _
    bstrTitle As String, _
    bstrPath As String, _
    tsInsertPos As TextSpan, _
    pExpansionClient As IVsExpansionClient, _
    guidLang As Guid, _
    fShowDisambiguationUI As Integer, _
    <OutAttribute> ByRef pSession As IVsExpansionSession _
) As Integer

int InsertNamedExpansion(
    string bstrTitle,
    string bstrPath,
    TextSpan tsInsertPos,
    IVsExpansionClient pExpansionClient,
    Guid guidLang,
    int fShowDisambiguationUI,
    out IVsExpansionSession pSession
)

int InsertNamedExpansion(
    [InAttribute] String^ bstrTitle, 
    [InAttribute] String^ bstrPath, 
    [InAttribute] TextSpan tsInsertPos, 
    [InAttribute] IVsExpansionClient^ pExpansionClient, 
    [InAttribute] Guid guidLang, 
    [InAttribute] int fShowDisambiguationUI, 
    [OutAttribute] IVsExpansionSession^% pSession
)

abstract InsertNamedExpansion : 
        bstrTitle:string * 
        bstrPath:string * 
        tsInsertPos:TextSpan * 
        pExpansionClient:IVsExpansionClient * 
        guidLang:Guid * 
        fShowDisambiguationUI:int * 
        pSession:IVsExpansionSession byref -> int

function InsertNamedExpansion(
    bstrTitle : String, 
    bstrPath : String, 
    tsInsertPos : TextSpan, 
    pExpansionClient : IVsExpansionClient, 
    guidLang : Guid, 
    fShowDisambiguationUI : int, 
    pSession : IVsExpansionSession
) : int

Parâmetros

bstrTitle
Tipo: String

[in] O nome completo do trecho de código.

bstrPath
Tipo: String

[inThe o caminho completo para o arquivo de trecho de código.

tsInsertPos
Tipo: Microsoft.VisualStudio.TextManager.Interop.TextSpan

[in] Especifica o local no buffer de texto para inserir o trecho de código.

pExpansionClient
Tipo: Microsoft.VisualStudio.TextManager.Interop.IVsExpansionClient

[in] Recebe notificações sobre o processo de inserção. Isso pode ser um nulluma referência nula (Nothing no Visual Basic) valor.

guidLang
Tipo: Guid

[in] O GUID do serviço de linguagem. Can be nulluma referência nula (Nothing no Visual Basic). O padrão é o serviço de idioma do arquivo.

fShowDisambiguationUI
Tipo: Int32

[in] Isso é diferente de zero (true) se um "Desambigüidade interface do usuário (UI)" pode ser mostrada no caso onde vários trechos com o mesmo nome são encontrados. Se esse valor for zero (false), em seguida, o primeiro trecho que corresponde ao nome é inserido.

pSession
Tipo: Microsoft.VisualStudio.TextManager.Interop.IVsExpansionSession%

[out] Retorna um IVsExpansionSession objeto que é usado enquanto o trecho está sendo editado no lugar.

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 textmgr2.idl:

HRESULT IVsExpansion::InsertNamedExpansion(
   [in]BSTR bstrTitle,
   [in] BSTR bstrPath,
   [in] TextSpan tsInsertPos,
   [in]IVsExpansionClient *pExpansionClient,
   [in]GUID guidLang,
   [in] bool fShowDisambiguationUI,
   [out] IVsExpansionSession **pSession
);

Esse método usado para inserir um trecho de código quando o nome e o caminho do trecho de código é conhecido. O nome e o caminho podem ser obtidos a partir do atalho do trecho de código, chamando o M:Microsoft.VisualStudio.TextManager.Interop.IVsExpansionManager.GetExpansionByShortcut(Microsoft.VisualStudio.TextManager.Interop.IVsExpansionClient,System.Guid,System.String,Microsoft.VisualStudio.TextManager.Interop.IVsTextView,Microsoft.VisualStudio.TextManager.Interop.TextSpan[],System.Int32,System.String@,System.String@) método na IVsExpansionManager interface.

Este método geralmente é chamado de uma implementação da OnItemChosen método na IVsExpansionClient interface como o OnItemChosen método recebe o nome e o caminho do trecho de código.

Se um IVsExpansionClient objeto for fornecido, ele recebe antes (OnBeforeInsertion método) e depois (OnAfterInsertion método) notificações durante o processo de inserção. O cliente de expansão também é usado para validar o tipo de trecho de código (IsValidKind método) para certificar-se de que o trecho, na verdade, pode ser inserido no local especificado.

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

IVsExpansion Interface

Namespace Microsoft.VisualStudio.TextManager.Interop

Partilhar via