IVsContainedLanguageCodeSupport.EnsureEventHandler - метод

Статья
05/17/2015

Создает обработчик событий заданный контекст, имя экземпляра объекта, имя события и (уникальный) имя обработчика событий, если уже существует.

Пространство имен: Microsoft.VisualStudio.TextManager.Interop
Сборка: Microsoft.VisualStudio.TextManager.Interop.8.0 (в Microsoft.VisualStudio.TextManager.Interop.8.0.dll)

Синтаксис

'Декларация
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

Параметры

pszClassName
Тип: String

[in] имя класса.

pszObjectTypeName
Тип: String

[in] имя объекта.

pszNameOfEvent
Тип: String

[in] имя события.

pszEventHandlerName
Тип: String

[in] имя обработчика событий.

itemidInsertionPoint
Тип: UInt32

[in] файл или буфер, в котором конструктор хотел будет поместить новый метод. Это уникальный идентификатор или может принимать одно из следующих значений: VSITEMID_NIL" VSITEMID_ROOT OR VSITEMID_SELECTION.

pbstrUniqueMemberID
Тип: String%

[out] возвращает уникальный идентификатор элемента для обработчика событий.

pbstrEventBody
Тип: String%

[out] возвращает возвращаемый текст сообщения обработчика событий.

pSpanInsertionPoint
Тип: array<Microsoft.VisualStudio.TextManager.Interop.TextSpan[]

[out] возвращает a TextSpan объект, описывающий место в исходном коде, где обработчик событий был вставлен.

Возвращаемое значение

Тип: Int32
В случае успеха возвращает S_OK; в противном случае возвращает код ошибки.

Заметки

Модель COM подписи

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

Этот метод возвращает всего тела сообщения обработчика событий и строковое представление, которое однозначно идентифицирует член события в заданном контексте класса. В случае, когда обработчик событий уже существует, уникальным идентификатором этого члена класса возвращается с строку NULL как для тела события, так и для идентификатора элемента

itemidInsertionPoint параметр указывает файл или буфер, в котором конструктор был хотел бы поместить новый метод. Если затем метод не существует точкой вставки в возвращенной pSpanInsertionPoint параметр для запрашиваемого буфера itemid.

Обратите внимание, что этот метод не вставляет созданный обработчик событий в вторичный буфер или файл разделяемого класса, только в первичный буфер.

Безопасность платформы .NET Framework

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Для получения дополнительной информации см. Использование библиотек из не вполне надежного кода.

См. также

Ссылки

IVsContainedLanguageCodeSupport Интерфейс

Microsoft.VisualStudio.TextManager.Interop - пространство имен

Поделиться через