IVsContainedLanguageStaticEventBinding.EnsureStaticEventHandler - метод

Статья
05/17/2015

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

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

Синтаксис

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

Параметры

pszClassName
Тип: String

[in] полное имя класса.

pszObjectTypeName
Тип: String

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

pszObjectName
Тип: String

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

pszNameOfEvent
Тип: String

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

pszEventHandlerName
Тип: String

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

itemidInsertionPoint
Тип: UInt32

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

pbstrUniqueMemberID
Тип: String%

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

pbstrEventBody
Тип: String%

[out] возвращает строку, содержащую текст сообщения обработчика событий. Возвращает значение NULL, если обработчик событий уже существует.

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

[in, out] заполняет a TextSpan объект с позиции, где текст вставлен первичного обработчика событий в буфере. Эта точка вставки в файле указанном itemidInsertionPoint параметр. Это допустимо только в том случае, если обработчик событий уже не существует.

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

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

Заметки

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

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

Если обработчик событий уже существует, то этот метод возвращает S_OK и pbstrEventBody и pbstrUniqueMemberID параметры возвращают значение NULL и pSpanInsertionPoint параметр неопределен.

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

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

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

См. также

Ссылки

IVsContainedLanguageStaticEventBinding Интерфейс

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

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