IVsExpansion.InsertNamedExpansion-Methode

Artikel
05/16/2015

Fügt der Ausschnitt mit dem angegebenen Namen in der angegebenen Position im Textpuffer ein.

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

Syntax

'Declaration
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

Parameter

bstrTitle
Typ: String

[in] Der vollständige Name des Codeausschnitts.

bstrPath
Typ: String

[im vollständigen Pfad zur Datei des Codeausschnitts.

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

[in] Gibt die Position im Textpuffer an, um den Codeausschnitt einzufügen.

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

[in] Empfängt Benachrichtigungen zum Einfügen. Dies kann ein nullein Nullverweis (Nothing in Visual Basic)-Wert sein.

guidLang
Typ: Guid

[in] Die GUID des Sprachdiensts. Kann nullein Nullverweis (Nothing in Visual Basic) sein. Der Standardwert ist der Sprachdienst der Datei.

fShowDisambiguationUI
Typ: Int32

[in] Dies ist ungleich 0 (true) Disambigusierungs „wenn eine Benutzeroberfläche für“ im Fall dargestellt werden kann, in dem mehrere Ausschnitte mit demselben Namen vorhanden sind. Wenn dieser Wertfalse(null) ist der erste Codeausschnitt eingefügt wird, die den Namen übereinstimmt.

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

[out] Gibt ein Objekt zurück, mit dem IVsExpansionSession während der Ausschnitt derzeit in einer anderen Anwendung bearbeitet wird.

Rückgabewert

Typ: Int32
Wenn die Methode erfolgreich ausgeführt, gibt sie S_OKzurück.Bei einem Fehler wird ein Fehlercode zurückgegeben.

Hinweise

COM-Signatur

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

Diese Methode verwendet, um einen Codeausschnitt eingefügt werden soll, wenn der Name und Pfad des Codeausschnitts bekannt ist. Der Name und der Pfad können von der Verknüpfung des Codeausschnitts abgerufen werden, indem die 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@)-Methode in der IVsExpansionManager-Schnittstelle aufruft.

Diese Methode wird in der Regel von einer Implementierung der OnItemChosen-Methode in der IVsExpansionClient-Schnittstelle aufgerufen, da die OnItemChosen-Methode der Name und Pfad des Codeausschnitts angegeben ist.

Wenn ein IVsExpansionClient-Objekt angegeben ist, empfängt es vorOnBeforeInsertion (Methode) und nachOnAfterInsertion () - Methode zum Einfügen von Benachrichtigungen während des Prozesses. Der Add-in client wird auch verwendet, um die Art des Ausschnitts () - MethodeIsValidKind des Ausschnitts zu überprüfende um sich zu vergewissern kann am angegebenen Speicherort tatsächlich eingefügt werden.

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

IVsExpansion Schnittstelle

Microsoft.VisualStudio.TextManager.Interop-Namespace

Freigeben über