IVsContainedLanguageCodeSupport.EnsureEventHandler-Methode

Artikel
05/16/2015

Stellt einen angegebenen Ereignishandler der Klassen Elementkontext, Name der Objektinstanz, und der Name des Ereignisses (eindeutiger Name des Ereignishandlers, falls kein temporäres Verzeichnis bereits vorhanden ist.

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

Syntax

'Declaration
Function EnsureEventHandler ( _
    pszClassName As String, _
    pszObjectTypeName As String, _
    pszNameOfEvent As String, _
    pszEventHandlerName As String, _
    itemidInsertionPoint As UInteger, _
    <OutAttribute> ByRef pbstrUniqueMemberID As String, _
    <OutAttribute> ByRef pbstrEventBody As String, _
    <OutAttribute> pSpanInsertionPoint As TextSpan() _
) As Integer

int EnsureEventHandler(
    string pszClassName,
    string pszObjectTypeName,
    string pszNameOfEvent,
    string pszEventHandlerName,
    uint itemidInsertionPoint,
    out string pbstrUniqueMemberID,
    out string pbstrEventBody,
    TextSpan[] pSpanInsertionPoint
)

int EnsureEventHandler(
    [InAttribute] String^ pszClassName, 
    [InAttribute] String^ pszObjectTypeName, 
    [InAttribute] String^ pszNameOfEvent, 
    [InAttribute] String^ pszEventHandlerName, 
    [InAttribute] unsigned int itemidInsertionPoint, 
    [OutAttribute] String^% pbstrUniqueMemberID, 
    [OutAttribute] String^% pbstrEventBody, 
    [OutAttribute] array<TextSpan>^ pSpanInsertionPoint
)

abstract EnsureEventHandler : 
        pszClassName:string * 
        pszObjectTypeName:string * 
        pszNameOfEvent:string * 
        pszEventHandlerName:string * 
        itemidInsertionPoint:uint32 * 
        pbstrUniqueMemberID:string byref * 
        pbstrEventBody:string byref * 
        pSpanInsertionPoint:TextSpan[] byref -> int

function EnsureEventHandler(
    pszClassName : String, 
    pszObjectTypeName : String, 
    pszNameOfEvent : String, 
    pszEventHandlerName : String, 
    itemidInsertionPoint : uint, 
    pbstrUniqueMemberID : String, 
    pbstrEventBody : String, 
    pSpanInsertionPoint : TextSpan[]
) : int

Parameter

pszClassName
Typ: String

[in] Name der Klasse.

pszObjectTypeName
Typ: String

[in] Name des Objekts.

pszNameOfEvent
Typ: String

[in] Der Name des Ereignisses.

pszEventHandlerName
Typ: String

[in] Name des Ereignishandlers.

itemidInsertionPoint
Typ: UInt32

[in] Die Datei oder der Puffer, in dem der Designer eine neue Methode setzen möchte. Dies ist ein eindeutiger Bezeichner, oder sie kann einer der folgenden Werte sein: VSITEMID_NIL, VSITEMID_ROOT oder VSITEMID_SELECTION.

pbstrUniqueMemberID
Typ: String%

[out] Gibt eine eindeutige ID für Member des Ereignishandlers zurück.

pbstrEventBody
Typ: String%

[out] Gibt den zurückgegebenen Ereignishandlers Text zurück.

pSpanInsertionPoint
Typ: array<Microsoft.VisualStudio.TextManager.Interop.TextSpan[]

[out] TextSpan Gibt ein Objekt zurück, das die Position im Quellcode beschreibt, in dem der Ereignishandler eingefügt wurde.

Rückgabewert

Typ: Int32
Bei Erfolg gibt S_OKzurück. andernfalls gibt einen Fehlercode zurück.

Hinweise

COM-Signatur

Von singlefileeditor.idl:

HRESULT EnsureEventHandler(
   [in]  LPCWSTR   pszClassName,
   [in]  LPCWSTR   pszObjectTypeName,
   [in]  LPCWSTR   pszNameOfEvent,
   [in]  LPCWSTR   pszEventHandlerName,
   [in]  VSITEMID  itemidInsertionPoint,
   [out] BSTR*     pbstrUniqueMemberID,
   [out] BSTR*     pbstrEventBody,
   [out] TextSpan* pSpanInsertionPoint
);

Diese Methode gibt den gesamten Text der Ereignishandler sowie eine Zeichenfolgendarstellung zurück, die eindeutig den Ereignismembern innerhalb des angegebenen Klassen kontexts identifiziert. Wenn der Ereignishandler bereits vorhanden ist, wird die eindeutige ID des Klassenmembers Member mit einer NULL-Zeichenfolge Ereignis für den Text und Member zurückgegeben.

Der itemidInsertionPoint-Parameter gibt die Datei bzw. den Puffer, in dem der Designer eine neue Methode setzen möchte. Wenn die Methode nicht vorhanden ist, wird die Einfügemarke, die im pSpanInsertionPoint-Parameter zurückgegeben wird, für den Puffer angeforderten itemid.

Beachten Sie, dass diese Methode den generierten Ereignishandler nicht in einen sekundären Puffer oder in der Teilausführungs eingefügt klassendatei nur in den primären Puffer.

.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

IVsContainedLanguageCodeSupport Schnittstelle

Microsoft.VisualStudio.TextManager.Interop-Namespace

Freigeben über