IVsContainedLanguageStaticEventBinding.EnsureStaticEventHandler (Método)

Crea un controlador de eventos con el contexto de la clase, el nombre del tipo de objeto y de instancia, el nombre del evento y el nombre (único) del controlador de eventos.

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

Parámetros

• pszClassName
  Tipo: String

  [in] el nombre completo de la clase.

• pszObjectTypeName
  Tipo: String

  [in] El nombre completo del tipo de objeto.

• pszObjectName
  Tipo: String

  [in] El nombre del objeto.

• pszNameOfEvent
  Tipo: String

  [in] Nombre del evento.

• pszEventHandlerName
  Tipo: String

  [in] El nombre del controlador de eventos.

• itemidInsertionPoint
  Tipo: UInt32

  [in] el archivo a insertar en. Éste es un identificador de jerarquía o único de los valores siguientes: VSITEMID_NIL, VSITEMID_ROOT o VSITEMID_SELECTION.

• pbstrUniqueMemberID
  Tipo: String%

  [out] Devuelve una cadena que contiene el identificador del miembro de evento. Devuelve un valor NULL si existe el controlador de eventos ya.

• pbstrEventBody
  Tipo: String%

  [out] Devuelve una cadena que contiene el cuerpo del controlador de eventos. Devuelve un valor NULL si existe el controlador de eventos ya.

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

  [in, out] Rellena el objeto de TextSpan con la posición donde incrustados el cuerpo del controlador de eventos en el búfer primario. este punto de inserción está en el archivo especificado por el parámetro de itemidInsertionPoint . Esto sólo es válido si no existe el controlador de eventos ya.

Valor devuelto

Tipo: Int32
Si finaliza correctamente, devuelve S_OK; de lo contrario, devuelve un código de error.

Comentarios

Prototipo COM

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

Si ya existe el controlador de eventos, este método devuelve S_OK y pbstrEventBody y valores NULL devuelto de los parámetros de pbstrUniqueMemberID y el parámetro de pSpanInsertionPoint es indefinidos.

Observe que este método no incrusta el controlador de eventos generado en el búfer o el archivo de clase parcial secundario, sólo en el búfer primario.

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

IVsContainedLanguageStaticEventBinding Interfaz

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