IVsExpansion.InsertNamedExpansion (Método)

Insertar el fragmento de código con el nombre especificado en la posición especificada en el búfer de texto.

Espacio de nombres:  Microsoft.VisualStudio.TextManager.Interop
Ensamblado:  Microsoft.VisualStudio.TextManager.Interop.8.0 (en Microsoft.VisualStudio.TextManager.Interop.8.0.dll)

Sintaxis

'Declaración
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] El nombre completo del fragmento de código.

• bstrPath
  Tipo: String

  [en la ruta de acceso completa al archivo de fragmentos de código.

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

  [in] Especifica la ubicación en el búfer de texto para insertar el fragmento.

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

  [in] Recibe notificaciones sobre el proceso de inserción. esto puede ser un valor de nullreferencia null (Nothing en Visual Basic) .

• guidLang
  Tipo: Guid

  [in] GUID del servicio de lenguaje. Puede ser nullreferencia null (Nothing en Visual Basic). El valor predeterminado es el servicio de lenguaje del archivo.

• fShowDisambiguationUI
  Tipo: Int32

  [in] Esto es distinto de cero (true) si una “interfaz de usuario de (UI) la desambiguación” se puede mostrar en caso de que los fragmentos varios con el mismo nombre se encuentran. Si este valor es cero (false) y el primer fragmento de código se inserta que coincide con el nombre.

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

  [out] Devuelve un objeto de IVsExpansionSession que se utilice mientras el fragmento se edita en contexto.

Valor devuelto

Tipo: Int32
si el método tiene éxito, devuelve S_OK.Si se produce un error, devuelve un código de error.

Comentarios

Prototipo COM

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
);

Este método se utiliza para incrustar un fragmento de código cuando el nombre y la ruta de acceso del fragmento de código se conoce. El nombre y la ruta de acceso pueden obtener acceso directo del fragmento de código llamando al método 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@) en la interfaz de IVsExpansionManager .

Este método se llama normalmente de una implementación del método de OnItemChosen en la interfaz de IVsExpansionClient mientras que el método de OnItemChosen recibe el nombre y la ruta de acceso del fragmento de código.

Si se proporciona un objeto de IVsExpansionClient , recibe antes (método deOnBeforeInsertion ) y después (de notificaciones del método deOnAfterInsertion ) durante la inserción. El cliente se utiliza de extensión también para validar la clase de fragmento (método deIsValidKind ) para asegurarse de fragmentos de código puede incrustar realmente en la ubicación especificada.

Seguridad de .NET Framework

• Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.

Vea también

Referencia

IVsExpansion Interfaz

Microsoft.VisualStudio.TextManager.Interop (Espacio de nombres)