IVsContainedLanguageStaticEventBinding.EnsureStaticEventHandler-Methode

Artikel
05/16/2015

Stellt einen angegebenen Ereignishandler der Klassen Elementkontext, Name des Objekttyps und der Instanz, den Namen des Ereignisses und der (eindeutiger Name des Ereignishandlers.

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

Syntax

'Declaration
Function EnsureStaticEventHandler ( _
    pszClassName As String, _
    pszObjectTypeName As String, _
    pszObjectName 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 EnsureStaticEventHandler(
    string pszClassName,
    string pszObjectTypeName,
    string pszObjectName,
    string pszNameOfEvent,
    string pszEventHandlerName,
    uint itemidInsertionPoint,
    out string pbstrUniqueMemberID,
    out string pbstrEventBody,
    TextSpan[] pSpanInsertionPoint
)

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

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

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

Parameter

pszClassName
Typ: String

[in] Der vollqualifizierte Name der Klasse.

pszObjectTypeName
Typ: String

[in] Der vollqualifizierte Name des Objekttyps.

pszObjectName
Typ: String

[in] Der Name des Objekts.

pszNameOfEvent
Typ: String

[in] Der Name des Ereignisses.

pszEventHandlerName
Typ: String

[in] Der Name des Ereignishandlers.

itemidInsertionPoint
Typ: UInt32

[in] Die Datei in eingefügt werden soll. Dies ist ein eindeutiger Bezeichner der Hierarchie oder der folgenden Werte: VSITEMID_NIL, VSITEMID_ROOT oder VSITEMID_SELECTION.

pbstrUniqueMemberID
Typ: String%

[out] Gibt eine Zeichenfolge zurück, die die Member-ID des Ereignisses beinhaltet. Gibt einen NULL-Wert zurück, wenn der Ereignishandler bereits vorhanden ist.

pbstrEventBody
Typ: String%

[out] Gibt eine Zeichenfolge zurück, die den Text des Ereignishandlers enthält. Gibt einen NULL-Wert zurück, wenn der Ereignishandler bereits vorhanden ist.

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

[in, out] Füllt ein TextSpan-Objekt mit der Position aus, an der der Text in den primären Ereignishandler Puffer eingefügt wurde. Die Einfügemarke befindet sich in der Datei vom itemidInsertionPoint-Parameter angegeben wird. Dies ist nur gültig, wenn der Ereignishandler nicht bereits vorhanden ist.

Rückgabewert

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

Hinweise

COM-Signatur

Von singlefileeditor.idl:

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

Wenn der Ereignishandler bereits vorhanden ist, gibt diese Methode S_OK zurück und pbstrEventBody und die pbstrUniqueMemberID-Parameter rückhol null-werte und der pSpanInsertionPoint-Parameter ist nicht definiert.

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

IVsContainedLanguageStaticEventBinding Schnittstelle

Microsoft.VisualStudio.TextManager.Interop-Namespace

Freigeben über