IVsContainedLanguageStaticEventBinding.EnsureStaticEventHandler, méthode

Article
05/16/2015

Crée un gestionnaire d'événements donné le contexte de classe, le nom du type d'objet et de l'instance, le nom de l'événement et (l'unique) nom du gestionnaire d'événements.

Espace de noms : Microsoft.VisualStudio.TextManager.Interop
Assembly : Microsoft.VisualStudio.TextManager.Interop.8.0 (dans Microsoft.VisualStudio.TextManager.Interop.8.0.dll)

Syntaxe

'Déclaration
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

Paramètres

pszClassName
Type : String

[in] le nom qualifié complet de la classe.

pszObjectTypeName
Type : String

[in] le nom qualifié complet du type d'objet.

pszObjectName
Type : String

[in] le nom de l'objet.

pszNameOfEvent
Type : String

[in] Nom de l'événement.

pszEventHandlerName
Type : String

[in] le nom du gestionnaire d'événements.

itemidInsertionPoint
Type : UInt32

[in] le fichier à insérer dans. C'est un unique identificateur de hiérarchie ou des valeurs suivantes : VSITEMID_NIL, VSITEMID_ROOT ou VSITEMID_SELECTION.

pbstrUniqueMemberID
Type : String%

[] retourne une chaîne contenant l'IDENTIFICATEUR membre de l'événement. Retourne une valeur NULL si le gestionnaire d'événements existe déjà.

pbstrEventBody
Type : String%

[] retourne une chaîne contenant le corps du gestionnaire d'événements. Retourne une valeur NULL si le gestionnaire d'événements existe déjà.

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

[in, out] complète un objet d'TextSpan à la position où le corps de gestionnaire d'événements a été inséré dans la mémoire tampon primaire. Ce point d'insertion est dans le fichier spécifié par le paramètre d'itemidInsertionPoint. C'est valide uniquement si le gestionnaire d'événements n'existait pas déjà.

Valeur de retour

Type : Int32
Si réussi, retours S_OK ; sinon, retours code d'erreur.

Notes

Signature de 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 le gestionnaire d'événements existe déjà, les retours S_OK et pbstrEventBody de cette méthode et les valeurs NULL de retour de paramètres d'pbstrUniqueMemberID et le paramètre d'pSpanInsertionPoint est indéfini.

Notez que cette méthode n'injecte pas le gestionnaire d'événements généré dans la mémoire tampon secondaire ou le fichier de classe partielle, uniquement dans la mémoire tampon primaire.

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, voir Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.

Voir aussi

Référence

IVsContainedLanguageStaticEventBinding Interface

Microsoft.VisualStudio.TextManager.Interop, espace de noms

Partager via